Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#inhmethods)

# AudioPlaybackCaptureConfiguration.Builder

*** ** * ** ***

` public static final class AudioPlaybackCaptureConfiguration.Builder `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.media.AudioPlaybackCaptureConfiguration.Builder |

<br />

*** ** * ** ***

Builder for creating `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration` instances.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#Builder(android.media.projection.MediaProjection)(https://developer.android.com/reference/android/media/projection/MediaProjection projection) ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#addMatchingUid(int)(int uid) ` Only capture audio output by app with the matching `uid`. |
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#addMatchingUsage(int)(int usage) ` Only capture audio output with the given `https://developer.android.com/reference/android/media/AudioAttributes`. |
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration` | ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#build()() ` Builds the configuration instance. |
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#excludeUid(int)(int uid) ` Only capture audio output by apps that do not have the matching `uid`. |
| ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | ` https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#excludeUsage(int)(int usage) ` Only capture audio output that does not match the given `https://developer.android.com/reference/android/media/AudioAttributes`. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Public constructors

### Builder

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Builder (MediaProjection projection)
```

<br />

<br />

| Parameters ||
|---|---|
| `projection` | `MediaProjection`: A MediaProjection that supports audio projection. This value cannot be `null`. <br /> |

## Public methods

### addMatchingUid

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AudioPlaybackCaptureConfiguration.Builder addMatchingUid (int uid)
```

Only capture audio output by app with the matching `uid`.

If called multiple times, will capture audio output by apps whose uid is any of the given uids.

<br />

| Parameters ||
|---|---|
| `uid` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if called in conjunction with `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#excludeUid(int)`. |

### addMatchingUsage

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AudioPlaybackCaptureConfiguration.Builder addMatchingUsage (int usage)
```

Only capture audio output with the given `https://developer.android.com/reference/android/media/AudioAttributes`.

If called multiple times, will capture audio output that matches any of the given attributes.

<br />

| Parameters ||
|---|---|
| `usage` | `int`: Value is one of the following: - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_UNKNOWN` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_MEDIA` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ALARM` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_RINGTONE` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_EVENT` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_SONIFICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_GAME` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANT` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if called in conjunction with `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#excludeUsage(int)`. |

### build

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AudioPlaybackCaptureConfiguration build ()
```

Builds the configuration instance.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException` | if the parameters set are incompatible. |

### excludeUid

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AudioPlaybackCaptureConfiguration.Builder excludeUid (int uid)
```

Only capture audio output by apps that do not have the matching `uid`.

If called multiple times, will capture audio output by apps whose uid is not any of the given uids.

<br />

| Parameters ||
|---|---|
| `uid` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if called in conjunction with `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#addMatchingUid(int)`. |

### excludeUsage

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public AudioPlaybackCaptureConfiguration.Builder excludeUsage (int usage)
```

Only capture audio output that does not match the given `https://developer.android.com/reference/android/media/AudioAttributes`.

If called multiple times, will capture audio output that does not match any of the given attributes.

<br />

| Parameters ||
|---|---|
| `usage` | `int`: Value is one of the following: - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_UNKNOWN` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_MEDIA` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ALARM` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_RINGTONE` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION_EVENT` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANCE_SONIFICATION` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_GAME` - `https://developer.android.com/reference/android/media/AudioAttributes#USAGE_ASSISTANT` |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if called in conjunction with `https://developer.android.com/reference/android/media/AudioPlaybackCaptureConfiguration.Builder#addMatchingUsage(int)`. |