PlayerAudioFocusContractTest

Artifact: androidx.media3:media3-test-utils-robolectric

View Source

---

Kotlin |Java

@UnstableApi
public abstract class PlayerAudioFocusContractTest

---

A collection of contract tests for Player implementations that support COMMAND_SET_AUDIO_ATTRIBUTES.

Subclasses should only include the logic necessary to construct the Player and return the player's internal Clock and internal processing Looper by overriding createPlayerInfo.

Subclasses shouldn't include any new @Test methods - implementation-specific tests should be in a separate class.

Summary

Nested types
public interface PlayerAudioFocusContractTest.PlayerInfo Interface that allows access to a Player instance and its internal Clock and processing Looper.

Public constructors
PlayerAudioFocusContractTest()

Public methods
void	@Test audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss()
void	@Test audioFocusLost_whilePlaying_pausesPlayback()
void	@Test getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone()
void	@Test pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed( )
void	@Test play_duringTransientLossWhilePaused_continuesPlayback()
void	@Test play_duringTransientLossWhilePlaying_continuesPlayback()
void	@Test play_withAudioFocusRequestDenied_doesNotPlay()
void	@Test play_withAudioFocusRequestGranted_startsPlayback()
void	@Test play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback( )
void	@Test player_hasRequiredCommandsAvailable()
final void	@After tearDown()
void	@Test transientLossAndGain_whilePaused_suppressesPlayback()
void	@Test transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost()

Protected methods
abstract PlayerAudioFocusContractTest.PlayerInfo	@ForOverride createPlayerInfo() Creates and returns the PlayerInfo with which to run the tests.

Public constructors

PlayerAudioFocusContractTest

public PlayerAudioFocusContractTest()

Public methods

audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss

@Test
public void audioFocusLoss_whilePaused_rereportsPausedWithFocusLoss()

Throws
java.lang.Exception

audioFocusLost_whilePlaying_pausesPlayback

@Test
public void audioFocusLost_whilePlaying_pausesPlayback()

Throws
java.lang.Exception

getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone

@Test
public void getPlaybackSuppressionReason_withUnpreparedPlayer_returnsNone()

pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed

@Test
public void pause_duringTransientLossWhilePlaying_keepsPlaybackPausedAndSuppressed(

)

Throws
java.lang.Exception

play_duringTransientLossWhilePaused_continuesPlayback

@Test
public void play_duringTransientLossWhilePaused_continuesPlayback()

Throws
java.lang.Exception

play_duringTransientLossWhilePlaying_continuesPlayback

@Test
public void play_duringTransientLossWhilePlaying_continuesPlayback()

Throws
java.lang.Exception

play_withAudioFocusRequestDenied_doesNotPlay

@Test
public void play_withAudioFocusRequestDenied_doesNotPlay()

Throws
java.lang.Exception

play_withAudioFocusRequestGranted_startsPlayback

@Test
public void play_withAudioFocusRequestGranted_startsPlayback()

Throws
java.lang.Exception

play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback

@Test
public void play_withHandleAudioFocusDisabled_ignoresDeniedRequestAndStartsPlayback(

)

Throws
java.lang.Exception

player_hasRequiredCommandsAvailable

@Test
public void player_hasRequiredCommandsAvailable()

tearDown

@After
public final void tearDown()

transientLossAndGain_whilePaused_suppressesPlayback

@Test
public void transientLossAndGain_whilePaused_suppressesPlayback()

Throws
java.lang.Exception

transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost

@Test
public void transientLossAndGain_whilePlaying_suppressesPlaybackWhileLost()

Throws
java.lang.Exception

Protected methods

createPlayerInfo

@ForOverride
protected abstract PlayerAudioFocusContractTest.PlayerInfo createPlayerInfo()

Creates and returns the PlayerInfo with which to run the tests.

The player must have audio focus handling initially disabled.