ExoPlayerTestRunner.Builder

Artifact: androidx.media3:media3-test-utils

Kotlin |Java

public final class ExoPlayerTestRunner.Builder

Builder to set-up an ExoPlayerTestRunner. Default fake implementations will be used for unset test properties.

Summary

Public constructors
`Builder(Context context)`

Public methods
`ExoPlayerTestRunner`	`build()` Builds an `ExoPlayerTestRunner` using the provided values or their defaults.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue initialSeek(int mediaItemIndex, long positionMs)` Seeks before setting the media sources and preparing the player.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setActionSchedule(ActionSchedule actionSchedule)` Sets an `ActionSchedule` to be run by the test runner.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setAnalyticsListener(AnalyticsListener analyticsListener)` Sets an `AnalyticsListener` to be registered.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setBandwidthMeter(BandwidthMeter bandwidthMeter)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setClock(Clock clock)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setExpectedPlayerEndedCount(int expectedPlayerEndedCount)` Sets the number of times the test runner is expected to reach the `STATE_ENDED` or `STATE_IDLE`.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setLoadControl(LoadControl loadControl)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setManifest(Object manifest)` Sets a manifest to be used by a `FakeMediaSource` in the test runner.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setMediaSources(MediaSource[] mediaSources)` Sets the `MediaSource`s to be used by the test runner.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setPauseAtEndOfMediaItems(boolean pauseAtEndOfMediaItems)` Sets whether to enable pausing at the end of media items.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setPlayerListener(Player.Listener playerListener)` Sets an `Player.Listener` to be registered to listen to player events.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setPreloadConfiguration( ExoPlayer.PreloadConfiguration preloadConfiguration )`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setRenderers(Renderer[] renderers)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setRenderersFactory(RenderersFactory renderersFactory)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setSupportedFormats(Format[] supportedFormats)` Sets a list of `Format`s to be used by a `FakeMediaSource` to create media periods.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setTimeline(Timeline timeline)` Sets a `Timeline` to be used by a `FakeMediaSource` in the test runner.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setTrackSelector(DefaultTrackSelector trackSelector)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setUseLazyPreparation(boolean useLazyPreparation)`
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue setVideoSurface(Surface surface)` Sets the video `Surface`.
`ExoPlayerTestRunner.Builder`	`@CanIgnoreReturnValue skipSettingMediaSources()` Skips calling `setMediaSources` before preparing.

Public constructors

Builder

public Builder(Context context)

Public methods

build

public ExoPlayerTestRunner build()

Builds an ExoPlayerTestRunner using the provided values or their defaults.

Returns
`ExoPlayerTestRunner`	The built `ExoPlayerTestRunner`.

initialSeek

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder initialSeek(int mediaItemIndex, long positionMs)

Seeks before setting the media sources and preparing the player.

Parameters
`int mediaItemIndex`	The media item index to seek to.
`long positionMs`	The position in milliseconds to seek to.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setActionSchedule

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setActionSchedule(ActionSchedule actionSchedule)

Sets an ActionSchedule to be run by the test runner. The first action will be executed immediately before prepare.

Parameters
`ActionSchedule actionSchedule`	An `ActionSchedule` to be used by the test runner.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setAnalyticsListener

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setAnalyticsListener(AnalyticsListener analyticsListener)

Sets an AnalyticsListener to be registered.

Parameters
`AnalyticsListener analyticsListener`	An `AnalyticsListener` to be registered.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setBandwidthMeter

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setBandwidthMeter(BandwidthMeter bandwidthMeter)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setBandwidthMeter`

setClock

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setClock(Clock clock)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setClock`

setExpectedPlayerEndedCount

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setExpectedPlayerEndedCount(int expectedPlayerEndedCount)

Sets the number of times the test runner is expected to reach the STATE_ENDED or STATE_IDLE. The default is 1. This affects how long blockUntilEnded waits.

Parameters
`int expectedPlayerEndedCount`	The number of times the player is expected to reach the ended or idle state.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setLoadControl

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setLoadControl(LoadControl loadControl)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setLoadControl`

setManifest

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setManifest(Object manifest)

Sets a manifest to be used by a FakeMediaSource in the test runner. The default value is null. Setting the manifest is not allowed after a call to setMediaSources or skipSettingMediaSources.

Parameters
`Object manifest`	A manifest to be used by a `FakeMediaSource` in the test runner.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setMediaSources

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setMediaSources(MediaSource[] mediaSources)

Sets the MediaSources to be used by the test runner. The default value is a FakeMediaSource with the timeline and manifest provided by setTimeline and setManifest. Setting media sources is not allowed after calls to skipSettingMediaSources, setTimeline and/or setManifest.

Parameters
`MediaSource[] mediaSources`	The `MediaSource`s to be used by the test runner.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setPauseAtEndOfMediaItems

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setPauseAtEndOfMediaItems(boolean pauseAtEndOfMediaItems)

Sets whether to enable pausing at the end of media items.

Parameters
`boolean pauseAtEndOfMediaItems`	Whether to pause at the end of media items.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setPlayerListener

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setPlayerListener(Player.Listener playerListener)

Sets an Player.Listener to be registered to listen to player events.

Parameters
`Player.Listener playerListener`	A `Player.Listener` to be registered by the test runner to listen to player events.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setPreloadConfiguration

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setPreloadConfiguration(
    ExoPlayer.PreloadConfiguration preloadConfiguration
)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setPreloadConfiguration`

setRenderers

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setRenderers(Renderer[] renderers)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setRenderers`

setRenderersFactory

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setRenderersFactory(RenderersFactory renderersFactory)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setRenderersFactory`

setSupportedFormats

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setSupportedFormats(Format[] supportedFormats)

Sets a list of Formats to be used by a FakeMediaSource to create media periods. The default value is a single VIDEO_FORMAT. Note that this parameter doesn't have any influence if a media source with setMediaSources is set.

Parameters
`Format[] supportedFormats`	A list of supported `Format`s.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setTimeline

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setTimeline(Timeline timeline)

Sets a Timeline to be used by a FakeMediaSource in the test runner. The default value is a seekable, non-dynamic FakeTimeline with a duration of DEFAULT_WINDOW_DURATION_US. Setting the timeline is not allowed after a call to setMediaSources or skipSettingMediaSources.

Parameters
`Timeline timeline`	A `Timeline` to be used by a `FakeMediaSource` in the test runner.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

setTrackSelector

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setTrackSelector(DefaultTrackSelector trackSelector)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setTrackSelector`

setUseLazyPreparation

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setUseLazyPreparation(boolean useLazyPreparation)

Returns
`ExoPlayerTestRunner.Builder`	This builder.

See also
`setUseLazyPreparation`

setVideoSurface

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder setVideoSurface(Surface surface)

Sets the video Surface. The default value is null.

Parameters
`Surface surface`	The `Surface` to be used by the player.

Returns
`ExoPlayerTestRunner.Builder`	This builder.

skipSettingMediaSources

@CanIgnoreReturnValue
public ExoPlayerTestRunner.Builder skipSettingMediaSources()

Skips calling setMediaSources before preparing. Calling this method is not allowed after calls to setMediaSources, setTimeline and/or setManifest.

Returns
`ExoPlayerTestRunner.Builder`	This builder.