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 ()