AudioPlaybackCaptureConfiguration

public final class AudioPlaybackCaptureConfiguration
extends Object

Configuration for capturing audio played by other apps. When capturing audio signals played by other apps (and yours), you will only capture a mix of the audio signals played by players (such as AudioTrack or MediaPlayer) which present the following characteristics:

• the usage value MUST be AudioAttributes.USAGE_UNKNOWN or AudioAttributes.USAGE_GAME or AudioAttributes.USAGE_MEDIA. All other usages CAN NOT be captured.
• AND the capture policy set by their app (with AudioManager.setAllowedCapturePolicy) or on each player (with AudioAttributes.Builder.setAllowedCapturePolicy) is AudioAttributes.ALLOW_CAPTURE_BY_ALL, whichever is the most strict.
• AND their app attribute allowAudioPlaybackCapture in their manifest MUST either be:
  • set to "true"
  • not set, and their targetSdkVersion MUST be equal to or greater than Build.VERSION_CODES.Q. Ie. Apps that do not target at least Android Q must explicitly opt-in to be captured by a MediaProjection.
• AND their apps MUST be in the same user profile as your app (eg work profile cannot capture user profile apps and vice-versa).

An example for creating a capture configuration for capturing all media playback:

 MediaProjection mediaProjection; // Retrieve a audio capable projection from the MediaProjectionManager AudioPlaybackCaptureConfiguration config = new AudioPlaybackCaptureConfiguration.Builder(mediaProjection) .addMatchingUsage(AudioAttributes.USAGE_MEDIA) .build(); AudioRecord record = new AudioRecord.Builder() .setAudioPlaybackCaptureConfig(config) .build(); 

Summary

Public methods

 public int[] getExcludeUids ()

 public int[] getExcludeUsages ()

 public int[] getMatchingUids ()

 public int[] getMatchingUsages ()

 public MediaProjection getMediaProjection ()