ExoPlayerTestRunner

public static final Format AUDIO_FORMAT

A generic audio Format which can be used to set up a FakeMediaSource.

public static final Format VIDEO_FORMAT

A generic video Format which can be used to set up a FakeMediaSource.

public void assertNoPositionDiscontinuities()

Asserts that onPositionDiscontinuity was not called.

public void assertPlaybackStatesEqual(Integer[] states)

Asserts that the playback states reported by onPlaybackStateChanged are equal to the provided playback states.

public void assertPlayedPeriodIndices(Integer[] periodIndices)

Asserts that the indices of played periods is equal to the provided list of periods. A period is considered to be played if it was the current period after a position discontinuity or a media source preparation. When the same period is repeated automatically due to enabled repeat modes, it is reported twice. Seeks within the current period are not reported.

public void assertPositionDiscontinuityReasonsEqual(
    Integer[] discontinuityReasons
)

Asserts that the discontinuity reasons reported by onPositionDiscontinuity are equal to the provided values.

public void assertTimelineChangeReasonsEqual(Integer[] reasons)

Asserts that the timeline change reasons reported by onTimelineChanged are equal to the provided timeline change reasons.

public void assertTimelinesSame(Timeline[] timelines)

Asserts that the timelines reported by onTimelineChanged are the same to the provided timelines. This assert differs from testing equality by not comparing period ids which may be different due to id mapping of child source period ids.

@CanIgnoreReturnValue
public ExoPlayerTestRunner blockUntilActionScheduleFinished(long timeoutMs)

Blocks the current thread until the action schedule finished. This does not release the test runner and the test must still call blockUntilEnded.

@CanIgnoreReturnValue
public ExoPlayerTestRunner blockUntilEnded(long timeoutMs)

Blocks the current thread until the test runner finishes. A test is deemed to be finished when the playback state transitioned to STATE_ENDED or STATE_IDLE for the specified number of times. The test also finishes when an ExoPlaybackException is thrown.

public void onActionScheduleFinished()

Called when action schedule finished executing all its actions.

public void onMediaItemTransition(
    @Nullable MediaItem mediaItem,
    @Player.MediaItemTransitionReason int reason
)

Called when playback transitions to a media item or starts repeating a media item according to the current repeat mode.

Note that this callback is also called when the value of getCurrentTimeline becomes non-empty or empty.

onEvents will also be called to report this event along with other events that happen in the same Looper message queue iteration.

public void onPlaybackStateChanged(@Player.State int playbackState)

Called when the value returned from getPlaybackState changes.

onEvents will also be called to report this event along with other events that happen in the same Looper message queue iteration.

public void onPlayerError(PlaybackException error)

Called when an error occurs. The playback state will transition to STATE_IDLE immediately after this method is called. The player instance can still be used, and release must still be called on the player should it no longer be required.

onEvents will also be called to report this event along with other events that happen in the same Looper message queue iteration.

Implementations of Player may pass an instance of a subclass of PlaybackException to this method in order to include more information about the error.

public void onPositionDiscontinuity(
    Player.PositionInfo oldPosition,
    Player.PositionInfo newPosition,
    @Player.DiscontinuityReason int reason
)

Called when a position discontinuity occurs.

A position discontinuity occurs when the playing period changes, the playback position jumps within the period currently being played, or when the playing period has been skipped or removed.

onEvents will also be called to report this event along with other events that happen in the same Looper message queue iteration.

public void onTimelineChanged(
    Timeline timeline,
    @Player.TimelineChangeReason int reason
)

Called when the value of getCurrentTimeline changes.

Note that the current MediaItem or playback position may change as a result of a timeline change. If playback can't continue smoothly because of this timeline change, a separate onPositionDiscontinuity callback will be triggered.

onEvents will also be called to report this event along with other events that happen in the same Looper message queue iteration.

@CanIgnoreReturnValue
public ExoPlayerTestRunner start()

Starts the test runner on its own thread. This will trigger the creation of the player, the listener registration, the start of the action schedule, the initial set of media items and the preparation of the player.

@CanIgnoreReturnValue
public ExoPlayerTestRunner start(boolean doPrepare)

Starts the test runner on its own thread. This will trigger the creation of the player, the listener registration, the start of the action schedule and the initial set of media items.