AudioPlaybackCaptureConfiguration Class

Definition

[Android.Runtime.Register("android/media/AudioPlaybackCaptureConfiguration", ApiSince=29, DoNotGenerateAcw=true)]
public sealed class AudioPlaybackCaptureConfiguration : Java.Lang.Object

[<Android.Runtime.Register("android/media/AudioPlaybackCaptureConfiguration", ApiSince=29, DoNotGenerateAcw=true)>]
type AudioPlaybackCaptureConfiguration = class
    inherit Object

Inheritance

Object

Object

AudioPlaybackCaptureConfiguration

Attributes

RegisterAttribute

Remarks

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: <ul> <li> the usage value MUST be AudioAttributes#USAGE_UNKNOWN or AudioAttributes#USAGE_GAME or AudioAttributes#USAGE_MEDIA. All other usages CAN NOT be captured. </li> <li> 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. </li> <li> AND their app attribute allowAudioPlaybackCapture in their manifest MUST either be: <ul> <li> set to "true" </li> <li> not set, and their targetSdkVersion MUST be equal to or greater than android.os.Build.VERSION_CODES#Q. Ie. Apps that do not target at least Android Q must explicitly opt-in to be captured by a MediaProjection. </li></ul> <li> AND their apps MUST be in the same user profile as your app (eg work profile cannot capture user profile apps and vice-versa). </li> </ul>

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

Java documentation for android.media.AudioPlaybackCaptureConfiguration.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Properties

Methods

Explicit Interface Implementations

Extension Methods

Applies to