# AudioFocusRequestCompat

# AudioFocusRequestCompat

Artifact:[androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/common/audio/AudioFocusRequestCompat.java+class:androidx.media3.common.audio.AudioFocusRequestCompat)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/common/audio/AudioFocusRequestCompat "View this page in Java")

<br />

```
@UnstableApi
class AudioFocusRequestCompat
```

<br />

*** ** * ** ***

Compatibility version of an[AudioFocusRequest](https://developer.android.com/reference/android/media/AudioFocusRequest.html)with fallbacks for older Android versions.

## Summary

|                                                                                                                                                ### Nested types                                                                                                                                                |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `class `[AudioFocusRequestCompat.Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat.Builder) Builder class for[AudioFocusRequestCompat](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat)objects. |

|                                                               ### Public functions                                                                |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [AudioFocusRequestCompat.Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat.Builder)`!` | [buildUpon](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#buildUpon())`()` Returns new[Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat.Builder)with all values of this instance pre-populated. |
| [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)                                                               | [equals](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#equals(java.lang.Object))`(o: `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`?)`                                                                                       |
| [Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)                                                                       | [hashCode](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#hashCode())`()`                                                                                                                                                                                    |
| [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)                                                               | [willPauseWhenDucked](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#willPauseWhenDucked())`()` Returns whether the application that would use this`AudioFocusRequestCompat`would pause when it is requested to duck.                                        |

|                                                              ### Public properties                                                               |
|--------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [AudioAttributes](https://developer.android.com/reference/kotlin/androidx/media3/common/AudioAttributes)`!`                                      | [audioAttributes](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#audioAttributes())                                                                                                                                           |
| [Handler](https://developer.android.com/reference/android/os/Handler.html)`!`                                                                    | [focusChangeHandler](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#focusChangeHandler())                                                                                                                                     |
| [Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)                                                                      | `@`[AudioManagerCompat.AudioFocusGain](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioManagerCompat.AudioFocusGain) [focusGain](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#focusGain()) |
| [AudioManager.OnAudioFocusChangeListener](https://developer.android.com/reference/android/media/AudioManager.OnAudioFocusChangeListener.html)`!` | [onAudioFocusChangeListener](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat#onAudioFocusChangeListener())                                                                                                                     |

## Public functions

### buildUpon

```
fun buildUpon(): AudioFocusRequestCompat.Builder!
```

Returns new[Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/audio/AudioFocusRequestCompat.Builder)with all values of this instance pre-populated.  

### equals

```
fun equals(o: Any?): Boolean
```  

### hashCode

```
fun hashCode(): Int
```  

### willPauseWhenDucked

```
fun willPauseWhenDucked(): Boolean
```

Returns whether the application that would use this`AudioFocusRequestCompat`would pause when it is requested to duck. This value is only applicable on[O](https://developer.android.com/reference/android/os/Build.VERSION_CODES.html#O())and later.  

## Public properties

### audioAttributes

```
val audioAttributes: AudioAttributes!
```  

### focusChangeHandler

```
val focusChangeHandler: Handler!
```  

### focusGain

```
@AudioManagerCompat.AudioFocusGain
val focusGain: Int
```  

### onAudioFocusChangeListener

```
val onAudioFocusChangeListener: AudioManager.OnAudioFocusChangeListener!
```