Constructor Detail

• Builder

  public Builder​(Context context,
                 Renderer... renderers)

  Creates a builder with a list of Renderers.

  The builder uses the following default values:

  • TrackSelector: DefaultTrackSelector
  • MediaSourceFactory: DefaultMediaSourceFactory
  • LoadControl: DefaultLoadControl
  • BandwidthMeter: DefaultBandwidthMeter.getSingletonInstance(Context)
  • LivePlaybackSpeedControl: DefaultLivePlaybackSpeedControl
  • Looper: The Looper associated with the current thread, or the Looper of the application's main thread if the current thread doesn't have a Looper
  • AnalyticsCollector: AnalyticsCollector with Clock.DEFAULT
  • useLazyPreparation: true
  • SeekParameters: SeekParameters.DEFAULT
  • releaseTimeoutMs: ExoPlayer.DEFAULT_RELEASE_TIMEOUT_MS
  • pauseAtEndOfMediaItems: false
  • Clock: Clock.DEFAULT

  Parameters:

  context - A Context.

  renderers - The Renderers to be used by the player.

• Builder

  public Builder​(Renderer[] renderers,
                 TrackSelector trackSelector,
                 MediaSourceFactory mediaSourceFactory,
                 LoadControl loadControl,
                 BandwidthMeter bandwidthMeter)

  Creates a builder with the specified custom components.

  Note that this constructor is only useful to try and ensure that ExoPlayer's default components can be removed by ProGuard or R8.

  Parameters:

  renderers - The Renderers to be used by the player.

  trackSelector - A TrackSelector.

  mediaSourceFactory - A MediaSourceFactory.

  loadControl - A LoadControl.

  bandwidthMeter - A BandwidthMeter.

Method Detail

• experimentalSetForegroundModeTimeoutMs

  public ExoPlayer.Builder experimentalSetForegroundModeTimeoutMs​(long timeoutMs)

  Set a limit on the time a call to ExoPlayer.setForegroundMode(boolean) can spend. If a call to ExoPlayer.setForegroundMode(boolean) takes more than timeoutMs milliseconds to complete, the player will raise an error via Player.EventListener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException).

  This method is experimental, and will be renamed or removed in a future release.

  Parameters:

  timeoutMs - The time limit in milliseconds.

• setTrackSelector

  public ExoPlayer.Builder setTrackSelector​(TrackSelector trackSelector)

  Sets the TrackSelector that will be used by the player.

  Parameters:

  trackSelector - A TrackSelector.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setMediaSourceFactory

  public ExoPlayer.Builder setMediaSourceFactory​(MediaSourceFactory mediaSourceFactory)

  Sets the MediaSourceFactory that will be used by the player.

  Parameters:

  mediaSourceFactory - A MediaSourceFactory.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setLoadControl

  public ExoPlayer.Builder setLoadControl​(LoadControl loadControl)

  Sets the LoadControl that will be used by the player.

  Parameters:

  loadControl - A LoadControl.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setBandwidthMeter

  public ExoPlayer.Builder setBandwidthMeter​(BandwidthMeter bandwidthMeter)

  Sets the BandwidthMeter that will be used by the player.

  Parameters:

  bandwidthMeter - A BandwidthMeter.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setLooper

  public ExoPlayer.Builder setLooper​(Looper looper)

  Sets the Looper that must be used for all calls to the player and that is used to call listeners on.

  Parameters:

  looper - A Looper.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setAnalyticsCollector

  public ExoPlayer.Builder setAnalyticsCollector​(AnalyticsCollector analyticsCollector)

  Sets the AnalyticsCollector that will collect and forward all player events.

  Parameters:

  analyticsCollector - An AnalyticsCollector.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setUseLazyPreparation

  public ExoPlayer.Builder setUseLazyPreparation​(boolean useLazyPreparation)

  Sets whether media sources should be initialized lazily.

  If false, all initial preparation steps (e.g., manifest loads) happen immediately. If true, these initial preparations are triggered only when the player starts buffering the media.

  Parameters:

  useLazyPreparation - Whether to use lazy preparation.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setSeekParameters

  public ExoPlayer.Builder setSeekParameters​(SeekParameters seekParameters)

  Sets the parameters that control how seek operations are performed.

  Parameters:

  seekParameters - The SeekParameters.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setReleaseTimeoutMs

  public ExoPlayer.Builder setReleaseTimeoutMs​(long releaseTimeoutMs)

  Sets a timeout for calls to Player.release() and ExoPlayer.setForegroundMode(boolean).

  If a call to Player.release() or ExoPlayer.setForegroundMode(boolean) takes more than timeoutMs to complete, the player will report an error via Player.EventListener.onPlayerError(com.google.android.exoplayer2.ExoPlaybackException).

  Parameters:

  releaseTimeoutMs - The release timeout, in milliseconds.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setPauseAtEndOfMediaItems

  public ExoPlayer.Builder setPauseAtEndOfMediaItems​(boolean pauseAtEndOfMediaItems)

  Sets whether to pause playback at the end of each media item.

  This means the player will pause at the end of each window in the current timeline. Listeners will be informed by a call to Player.EventListener.onPlayWhenReadyChanged(boolean, int) with the reason Player.PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM when this happens.

  Parameters:

  pauseAtEndOfMediaItems - Whether to pause playback at the end of each media item.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setLivePlaybackSpeedControl

  public ExoPlayer.Builder setLivePlaybackSpeedControl​(LivePlaybackSpeedControl livePlaybackSpeedControl)

  Sets the LivePlaybackSpeedControl that will control the playback speed when playing live streams, in order to maintain a steady target offset from the live stream edge.

  Parameters:

  livePlaybackSpeedControl - The LivePlaybackSpeedControl.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• setClock

  public ExoPlayer.Builder setClock​(Clock clock)

  Sets the Clock that will be used by the player. Should only be set for testing purposes.

  Parameters:

  clock - A Clock.

  Returns:

  This builder.

  Throws:

  IllegalStateException - If build() has already been called.

• build

  public ExoPlayer build()

  Builds an ExoPlayer instance.

  Throws:

  IllegalStateException - If build has already been called.