# AudioAttributes.Builder

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

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/media/AudioAttributes.Builder "View this page in Java")  

```
class Builder
```

|---|--------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                 ||
| ↳ | [android.media.AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#) |

Builder class for[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)objects.

Here is an example where`Builder`is used to define the[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)to be used by a new`AudioTrack`instance:  

```kotlin
AudioTrack myTrack = new AudioTrack(
          new AudioAttributes.Builder()
              .setUsage(AudioAttributes.USAGE_MEDIA)
              .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
              .build(),
          myFormat, myBuffSize, AudioTrack.MODE_STREAM, mySession);
  
```

By default all types of information (usage, content type, flags) conveyed by an`AudioAttributes`instance are set to "unknown". Unknown information will be interpreted as a default value that is dependent on the context of use, for instance a[MediaPlayer](https://developer.android.com/reference/kotlin/android/media/MediaPlayer)will use a default usage of[AudioAttributes.USAGE_MEDIA](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_MEDIA:kotlin.Int).

## Summary

|                                                                                                                                             Public constructors                                                                                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#Builder())`()` Constructs a new Builder with the defaults.                                                                                                                                                |
| [Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#Builder(android.media.AudioAttributes))`(`aa:` `[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)!`)` Constructs a new Builder from a given AudioAttributes |

|                                                                                                                                                                                                                            Public methods                                                                                                                                                                                                                            ||
|-----------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)!                  | [build](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#build())`()` Combines all of the attributes that have been set and return a new[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)object.                                                            |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)  | [setAllowedCapturePolicy](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setAllowedCapturePolicy(kotlin.Int))`(`capturePolicy:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Specifies whether the audio may or may not be captured by other apps or the system.      |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | [setContentType](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setContentType(kotlin.Int))`(`contentType:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the attribute describing the content type of the audio signal, such as speech, or music.                |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | [setFlags](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setFlags(kotlin.Int))`(`flags:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the combination of flags.                                                                                                 |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)  | [setHapticChannelsMuted](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setHapticChannelsMuted(kotlin.Boolean))`(`muted:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Specifying if haptic should be muted or not when playing audio-haptic coupled data.    |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)  | [setIsContentSpatialized](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setIsContentSpatialized(kotlin.Boolean))`(`isSpatialized:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Specifies whether the content has already been processed for spatialization. |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | [setLegacyStreamType](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setLegacyStreamType(kotlin.Int))`(`streamType:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets attributes as inferred from the legacy stream types.                                           |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)  | [setSpatializationBehavior](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setSpatializationBehavior(kotlin.Int))`(`sb:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the behavior affecting whether spatialization will be used.                                |
| open[AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | [setUsage](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setUsage(kotlin.Int))`(`usage:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the attribute describing what is the intended use of the audio signal, such as alarm or ringtone.                         |

## Public constructors

### Builder

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

```
Builder()
```

Constructs a new Builder with the defaults. By default, usage and content type are respectively[AudioAttributes.USAGE_UNKNOWN](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_UNKNOWN:kotlin.Int)and[AudioAttributes.CONTENT_TYPE_UNKNOWN](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_UNKNOWN:kotlin.Int), and flags are 0. It is recommended to configure the usage (with[setUsage(int)](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setUsage(kotlin.Int))) or deriving attributes from a legacy stream type (with[setLegacyStreamType(int)](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setLegacyStreamType(kotlin.Int))) before calling[build()](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#build())to override any default playback behavior in terms of routing and volume management.  

### Builder

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

```
Builder(aa: AudioAttributes!)
```

Constructs a new Builder from a given AudioAttributes

|                                                                                   Parameters                                                                                    ||
|------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `aa` | [AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)!:the AudioAttributes object whose data will be reused in the new Builder. |

## Public methods

### build

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

```
open fun build(): AudioAttributes!
```

Combines all of the attributes that have been set and return a new[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)object.

|                                                                                                    Return                                                                                                    ||
|--------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| [AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)! | a new[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)object |

### setAllowedCapturePolicy

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

```
open fun setAllowedCapturePolicy(capturePolicy: Int): AudioAttributes.Builder
```

Specifies whether the audio may or may not be captured by other apps or the system. The default is[AudioAttributes.ALLOW_CAPTURE_BY_ALL](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#ALLOW_CAPTURE_BY_ALL:kotlin.Int). There are multiple ways to set this policy:

- for each track independently, with this method
- application-wide at runtime, with[AudioManager.setAllowedCapturePolicy(int)](https://developer.android.com/reference/kotlin/android/media/AudioManager#setAllowedCapturePolicy(kotlin.Int))
- application-wide at build time, see`allowAudioPlaybackCapture`in the application manifest.

The most restrictive policy is always applied. See[AudioPlaybackCaptureConfiguration](https://developer.android.com/reference/kotlin/android/media/AudioPlaybackCaptureConfiguration)for more details on which audio signals can be captured.

<br />

|                                                                                                                                                                                                                                                                                                       Parameters                                                                                                                                                                                                                                                                                                        ||
|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `capturePolicy` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):Value is[android.media.AudioAttributes#ALLOW_CAPTURE_BY_ALL](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#ALLOW_CAPTURE_BY_ALL:kotlin.Int),[android.media.AudioAttributes#ALLOW_CAPTURE_BY_SYSTEM](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#ALLOW_CAPTURE_BY_SYSTEM:kotlin.Int), or[android.media.AudioAttributes#ALLOW_CAPTURE_BY_NONE](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#ALLOW_CAPTURE_BY_NONE:kotlin.Int) |

|                                                                                 Return                                                                                  ||
|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#) | the same Builder instance This value cannot be`null`. |

|                                 Exceptions                                  ||
|--------------------------------------|---------------------------------------|
| `java.lang.IllegalArgumentException` | if the argument is not a valid value. |

### setContentType

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

```
open fun setContentType(contentType: Int): AudioAttributes.Builder!
```

Sets the attribute describing the content type of the audio signal, such as speech, or music.

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          ||
|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `contentType` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the content type values, one of[AudioAttributes.CONTENT_TYPE_MOVIE](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_MOVIE:kotlin.Int),[AudioAttributes.CONTENT_TYPE_MUSIC](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_MUSIC:kotlin.Int),[AudioAttributes.CONTENT_TYPE_SONIFICATION](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_SONIFICATION:kotlin.Int),[AudioAttributes.CONTENT_TYPE_SPEECH](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_SPEECH:kotlin.Int),[AudioAttributes.CONTENT_TYPE_UNKNOWN](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_UNKNOWN:kotlin.Int). Value is[android.media.AudioAttributes#CONTENT_TYPE_UNKNOWN](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_UNKNOWN:kotlin.Int),[android.media.AudioAttributes#CONTENT_TYPE_SPEECH](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_SPEECH:kotlin.Int),[android.media.AudioAttributes#CONTENT_TYPE_MUSIC](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_MUSIC:kotlin.Int),[android.media.AudioAttributes#CONTENT_TYPE_MOVIE](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_MOVIE:kotlin.Int), or[android.media.AudioAttributes#CONTENT_TYPE_SONIFICATION](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#CONTENT_TYPE_SONIFICATION:kotlin.Int) |

|                                                                    Return                                                                     ||
|-------------------------------------------------------------------------------------------------------------------|----------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | the same Builder instance. |

### setFlags

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

```
open fun setFlags(flags: Int): AudioAttributes.Builder!
```

Sets the combination of flags. This is a bitwise OR with the existing flags.

|                                                                                                                                                                                                  Parameters                                                                                                                                                                                                  ||
|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `flags` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):a combination of[AudioAttributes.FLAG_AUDIBILITY_ENFORCED](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#FLAG_AUDIBILITY_ENFORCED:kotlin.Int),[AudioAttributes.FLAG_HW_AV_SYNC](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#FLAG_HW_AV_SYNC:kotlin.Int). |

|                                                                    Return                                                                     ||
|-------------------------------------------------------------------------------------------------------------------|----------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | the same Builder instance. |

### setHapticChannelsMuted

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

```
open fun setHapticChannelsMuted(muted: Boolean): AudioAttributes.Builder
```

Specifying if haptic should be muted or not when playing audio-haptic coupled data. By default, haptic channels are disabled.

This will be ignored if the caller doesn't have the[android.Manifest.permission#VIBRATE](https://developer.android.com/reference/kotlin/android/Manifest.permission.html#VIBRATE:kotlin.String)permission.

|                                                            Parameters                                                             ||
|---------|--------------------------------------------------------------------------------------------------------------------------|
| `muted` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):true to force muting haptic channels. |

|                                                                                  Return                                                                                  ||
|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#) | the same Builder instance. This value cannot be`null`. |

### setIsContentSpatialized

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

```
open fun setIsContentSpatialized(isSpatialized: Boolean): AudioAttributes.Builder
```

Specifies whether the content has already been processed for spatialization. If it has, setting this to true will prevent issues such as double-processing.

|                                              Parameters                                              ||
|-----------------|-------------------------------------------------------------------------------------|
| `isSpatialized` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html): |

|                                                                                 Return                                                                                  ||
|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#) | the same Builder instance This value cannot be`null`. |

### setLegacyStreamType

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

```
open fun setLegacyStreamType(streamType: Int): AudioAttributes.Builder!
```

Sets attributes as inferred from the legacy stream types. Warning: do not use this method in combination with setting any other attributes such as usage, content type, flags or haptic control, as this method will overwrite (the more accurate) information describing the use case previously set in the`Builder`. In general, avoid using it and prefer setting usage and content type directly with[setUsage(int)](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setUsage(kotlin.Int))and[setContentType(int)](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#setContentType(kotlin.Int)).

Use this method when building an[AudioAttributes](https://developer.android.com/reference/kotlin/android/media/AudioAttributes)instance to initialize some of the attributes by information derived from a legacy stream type.

|                                                                                                                                                                                                                                                                                                                                                                                                                                                      Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                      ||
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `streamType` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):one of[AudioManager.STREAM_VOICE_CALL](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_VOICE_CALL:kotlin.Int),[AudioManager.STREAM_SYSTEM](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_SYSTEM:kotlin.Int),[AudioManager.STREAM_RING](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_RING:kotlin.Int),[AudioManager.STREAM_MUSIC](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_MUSIC:kotlin.Int),[AudioManager.STREAM_ALARM](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_ALARM:kotlin.Int), or[AudioManager.STREAM_NOTIFICATION](https://developer.android.com/reference/kotlin/android/media/AudioManager#STREAM_NOTIFICATION:kotlin.Int). |

|                                                                    Return                                                                     ||
|-------------------------------------------------------------------------------------------------------------------|----------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | the same Builder instance. |

### setSpatializationBehavior

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

```
open fun setSpatializationBehavior(sb: Int): AudioAttributes.Builder
```

Sets the behavior affecting whether spatialization will be used.

|                                                                                                                                                                                                                                           Parameters                                                                                                                                                                                                                                            ||
|------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `sb` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the spatialization behavior Value is[android.media.AudioAttributes#SPATIALIZATION_BEHAVIOR_AUTO](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#SPATIALIZATION_BEHAVIOR_AUTO:kotlin.Int), or[android.media.AudioAttributes#SPATIALIZATION_BEHAVIOR_NEVER](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#SPATIALIZATION_BEHAVIOR_NEVER:kotlin.Int) |

|                                                                                 Return                                                                                  ||
|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#) | the same Builder instance This value cannot be`null`. |

### setUsage

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

```
open fun setUsage(usage: Int): AudioAttributes.Builder!
```

Sets the attribute describing what is the intended use of the audio signal, such as alarm or ringtone.

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ||
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `usage` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the usage to set. Value is[android.media.AudioAttributes#USAGE_UNKNOWN](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_UNKNOWN:kotlin.Int),[android.media.AudioAttributes#USAGE_MEDIA](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_MEDIA:kotlin.Int),[android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION:kotlin.Int),[android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING:kotlin.Int),[android.media.AudioAttributes#USAGE_ALARM](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_ALARM:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION_RINGTONE](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION_RINGTONE:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED:kotlin.Int),[android.media.AudioAttributes#USAGE_NOTIFICATION_EVENT](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_NOTIFICATION_EVENT:kotlin.Int),[android.media.AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY:kotlin.Int),[android.media.AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE:kotlin.Int),[android.media.AudioAttributes#USAGE_ASSISTANCE_SONIFICATION](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_ASSISTANCE_SONIFICATION:kotlin.Int),[android.media.AudioAttributes#USAGE_GAME](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_GAME:kotlin.Int), or[android.media.AudioAttributes#USAGE_ASSISTANT](https://developer.android.com/reference/kotlin/android/media/AudioAttributes#USAGE_ASSISTANT:kotlin.Int) |

|                                                                    Return                                                                     ||
|-------------------------------------------------------------------------------------------------------------------|----------------------------|
| [AudioAttributes.Builder](https://developer.android.com/reference/kotlin/android/media/AudioAttributes.Builder#)! | the same Builder instance. |