# PlayerAudioFocusContractTest

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

*** ** * ** ***


```
@UnstableApi
abstract class PlayerAudioFocusContractTest
```

<br />

*** ** * ** ***

A collection of contract tests for `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` implementations that support `https://developer.android.com/reference/kotlin/androidx/media3/common/Player#COMMAND_SET_AUDIO_ATTRIBUTES()`.

Subclasses should only include the logic necessary to construct the `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` and return the player's internal `https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock` and internal processing `https://developer.android.com/reference/android/os/Looper.html` by overriding `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#createPlayerInfo()`.

Subclasses shouldn't include any new `https://junit.org/junit4/javadoc/latest/org/junit/Test.html` methods - implementation-specific tests should be in a separate class.

## Summary

| ### Nested types |
|---|
| `interface https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest.PlayerInfo` Interface that allows access to a `https://developer.android.com/reference/kotlin/androidx/media3/common/Player` instance and its internal `https://developer.android.com/reference/kotlin/androidx/media3/common/util/Clock` and processing `https://developer.android.com/reference/android/os/Looper.html`. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#PlayerAudioFocusContractTest()()` |

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#audioFocusLost_whilePlaying_pausesPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed()( )` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_duringTransientLossWhilePaused_continuesPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://robolectric.org/javadoc/4.11/org/robolectric/annotation/Config.html(minSdk = 26) @https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_duringTransientLossWhilePlayingWithDelayedGainAndLoss_continuesAndPausesPlayback()( )` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://robolectric.org/javadoc/4.11/org/robolectric/annotation/Config.html(minSdk = 26) @https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_duringTransientLossWhilePlayingWithDelayedGainAndRegularGain_continuesPlayback()( )` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_duringTransientLossWhilePlayingWithLoss_pausesPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_duringTransientLossWhilePlayingWithRegularGain_continuesPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_withAudioFocusRequestDenied_doesNotPlay()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_withAudioFocusRequestGranted_startsPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback()( )` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#player_hasRequiredCommandsAvailable()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/After.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#tearDown()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#transientLossAndGain_whilePaused_suppressesPlayback()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://junit.org/junit4/javadoc/latest/org/junit/Test.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost()()` |

| ### Protected functions |
|---|---|
| `abstract https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest.PlayerInfo!` | `@https://checkerframework.org/api/com/google/errorprone/annotations/ForOverride.html https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest#createPlayerInfo()()` Creates and returns the `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest.PlayerInfo` with which to run the tests. |

## Public constructors

### PlayerAudioFocusContractTest

```
PlayerAudioFocusContractTest()
```

## Public functions

### audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss

```
@Test
fun audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### audioFocusLost_whilePlaying_pausesPlayback

```
@Test
fun audioFocusLost_whilePlaying_pausesPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone

```
@Test
fun getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone(): Unit
```

### pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed

```
@Test
fun pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed(

): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_duringTransientLossWhilePaused_continuesPlayback

```
@Test
fun play_duringTransientLossWhilePaused_continuesPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_duringTransientLossWhilePlayingWithDelayedGainAndLoss_continuesAndPausesPlayback

```
@Config(minSdk = 26)
@Test
fun play_duringTransientLossWhilePlayingWithDelayedGainAndLoss_continuesAndPausesPlayback(

): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_duringTransientLossWhilePlayingWithDelayedGainAndRegularGain_continuesPlayback

```
@Config(minSdk = 26)
@Test
fun play_duringTransientLossWhilePlayingWithDelayedGainAndRegularGain_continuesPlayback(

): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_duringTransientLossWhilePlayingWithLoss_pausesPlayback

```
@Test
fun play_duringTransientLossWhilePlayingWithLoss_pausesPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_duringTransientLossWhilePlayingWithRegularGain_continuesPlayback

```
@Test
fun play_duringTransientLossWhilePlayingWithRegularGain_continuesPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_withAudioFocusRequestDenied_doesNotPlay

```
@Test
fun play_withAudioFocusRequestDenied_doesNotPlay(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_withAudioFocusRequestGranted_startsPlayback

```
@Test
fun play_withAudioFocusRequestGranted_startsPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback

```
@Test
fun play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback(

): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### player_hasRequiredCommandsAvailable

```
@Test
fun player_hasRequiredCommandsAvailable(): Unit
```

### tearDown

```
@After
fun tearDown(): Unit
```

### transientLossAndGain_whilePaused_suppressesPlayback

```
@Test
fun transientLossAndGain_whilePaused_suppressesPlayback(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

### transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost

```
@Test
fun transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost(): Unit
```

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/Exception.html` |   |

## Protected functions

### createPlayerInfo

```
@ForOverride
protected abstract fun createPlayerInfo(): PlayerAudioFocusContractTest.PlayerInfo!
```

Creates and returns the `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest.PlayerInfo` with which to run the tests.

The `https://developer.android.com/reference/kotlin/androidx/media3/test/utils/robolectric/PlayerAudioFocusContractTest.PlayerInfo#getPlayer()` must have `https://developer.android.com/reference/kotlin/androidx/media3/common/Player#setAudioAttributes(androidx.media3.common.AudioAttributes,boolean)` initially disabled.