Field Detail

• DEFAULT_LIVE_PRESENTATION_DELAY_MS

  public static final long DEFAULT_LIVE_PRESENTATION_DELAY_MS

  The default presentation delay for live streams. The presentation delay is the duration by which the default start position precedes the end of the live window.

  See Also:

  Constant Field Values

Constructor Detail

• SsMediaSource

  @Deprecated
  public SsMediaSource(SsManifest manifest,
                                   SsChunkSource.Factory chunkSourceFactory,
                                   Handler eventHandler,
                                   MediaSourceEventListener eventListener)

  Deprecated. Use SsMediaSource.Factory instead.
  Constructs an instance to play a given SsManifest, which must not be live.

  Parameters:

  manifest - The manifest. SsManifest.isLive must be false.

  chunkSourceFactory - A factory for SsChunkSource instances.

  eventHandler - A handler for events. May be null if delivery of events is not required.

  eventListener - A listener of events. May be null if delivery of events is not required.

• SsMediaSource

  @Deprecated
  public SsMediaSource(SsManifest manifest,
                                   SsChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   Handler eventHandler,
                                   MediaSourceEventListener eventListener)

  Deprecated. Use SsMediaSource.Factory instead.
  Constructs an instance to play a given SsManifest, which must not be live.

  Parameters:

  manifest - The manifest. SsManifest.isLive must be false.

  chunkSourceFactory - A factory for SsChunkSource instances.

  minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

  eventHandler - A handler for events. May be null if delivery of events is not required.

  eventListener - A listener of events. May be null if delivery of events is not required.

• SsMediaSource

  @Deprecated
  public SsMediaSource(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   SsChunkSource.Factory chunkSourceFactory,
                                   Handler eventHandler,
                                   MediaSourceEventListener eventListener)

  Deprecated. Use SsMediaSource.Factory instead.
  Constructs an instance to play the manifest at a given Uri, which may be live or on-demand.

  Parameters:

  manifestUri - The manifest Uri.

  manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

  chunkSourceFactory - A factory for SsChunkSource instances.

  eventHandler - A handler for events. May be null if delivery of events is not required.

  eventListener - A listener of events. May be null if delivery of events is not required.

• SsMediaSource

  @Deprecated
  public SsMediaSource(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   SsChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   Handler eventHandler,
                                   MediaSourceEventListener eventListener)

  Deprecated. Use SsMediaSource.Factory instead.
  Constructs an instance to play the manifest at a given Uri, which may be live or on-demand.

  Parameters:

  manifestUri - The manifest Uri.

  manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

  chunkSourceFactory - A factory for SsChunkSource instances.

  minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

  livePresentationDelayMs - For live playbacks, the duration in milliseconds by which the default start position should precede the end of the live window.

  eventHandler - A handler for events. May be null if delivery of events is not required.

  eventListener - A listener of events. May be null if delivery of events is not required.

• SsMediaSource

  @Deprecated
  public SsMediaSource(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   ParsingLoadable.Parser<? extends SsManifest> manifestParser,
                                   SsChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   Handler eventHandler,
                                   MediaSourceEventListener eventListener)

  Deprecated. Use SsMediaSource.Factory instead.
  Constructs an instance to play the manifest at a given Uri, which may be live or on-demand.

  Parameters:

  manifestUri - The manifest Uri.

  manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

  manifestParser - A parser for loaded manifest data.

  chunkSourceFactory - A factory for SsChunkSource instances.

  minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

  livePresentationDelayMs - For live playbacks, the duration in milliseconds by which the default start position should precede the end of the live window.

  eventHandler - A handler for events. May be null if delivery of events is not required.

  eventListener - A listener of events. May be null if delivery of events is not required.

Method Detail

• getTag

  @Nullable
  public Object getTag()

  Description copied from interface: MediaSource
  Returns the tag set on the media source, or null if none was set.

  Specified by:

  getTag in interface MediaSource

• prepareSourceInternal

  public void prepareSourceInternal(@Nullable
                                    TransferListener mediaTransferListener)

  Description copied from class: BaseMediaSource
  Starts source preparation. This method is called at most once until the next call to BaseMediaSource.releaseSourceInternal().

  Specified by:

  prepareSourceInternal in class BaseMediaSource

  Parameters:

  mediaTransferListener - The transfer listener which should be informed of any media data transfers. May be null if no listener is available. Note that this listener should usually be only informed of transfers related to the media loads and not of auxiliary loads for manifests and other data.

• maybeThrowSourceInfoRefreshError

  public void maybeThrowSourceInfoRefreshError()
                                        throws IOException

  Description copied from interface: MediaSource
  Throws any pending error encountered while loading or refreshing source information.

  Should not be called directly from application code.

  Specified by:

  maybeThrowSourceInfoRefreshError in interface MediaSource

  Throws:

  IOException

• createPeriod

  public MediaPeriod createPeriod(MediaSource.MediaPeriodId id,
                                  Allocator allocator,
                                  long startPositionUs)

  Description copied from interface: MediaSource
  Returns a new MediaPeriod identified by periodId. This method may be called multiple times without an intervening call to MediaSource.releasePeriod(MediaPeriod).

  Should not be called directly from application code.

  Specified by:

  createPeriod in interface MediaSource

  Parameters:

  id - The identifier of the period.

  allocator - An Allocator from which to obtain media buffer allocations.

  startPositionUs - The expected start position, in microseconds.

  Returns:

  A new MediaPeriod.

• releasePeriod

  public void releasePeriod(MediaPeriod period)

  Description copied from interface: MediaSource
  Releases the period.

  Should not be called directly from application code.

  Specified by:

  releasePeriod in interface MediaSource

  Parameters:

  period - The period to release.

• releaseSourceInternal

  public void releaseSourceInternal()

  Description copied from class: BaseMediaSource
  Releases the source. This method is called exactly once after each call to BaseMediaSource.prepareSourceInternal(TransferListener).

  Specified by:

  releaseSourceInternal in class BaseMediaSource

• onLoadCompleted

  public void onLoadCompleted(ParsingLoadable<SsManifest> loadable,
                              long elapsedRealtimeMs,
                              long loadDurationMs)

  Description copied from interface: Loader.Callback
  Called when a load has completed.

  Note: There is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called.

  Specified by:

  onLoadCompleted in interface Loader.Callback<ParsingLoadable<SsManifest>>

  Parameters:

  loadable - The loadable whose load has completed.

  elapsedRealtimeMs - SystemClock.elapsedRealtime() when the load ended.

  loadDurationMs - The duration in milliseconds of the load since Loader.startLoading(T, com.google.android.exoplayer2.upstream.Loader.Callback<T>, int) was called.

• onLoadCanceled

  public void onLoadCanceled(ParsingLoadable<SsManifest> loadable,
                             long elapsedRealtimeMs,
                             long loadDurationMs,
                             boolean released)

  Description copied from interface: Loader.Callback
  Called when a load has been canceled.

  Note: If the Loader has not been released then there is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called. If the Loader has been released then this callback may be called before Loader.Loadable.load() exits.

  Specified by:

  onLoadCanceled in interface Loader.Callback<ParsingLoadable<SsManifest>>

  Parameters:

  loadable - The loadable whose load has been canceled.

  elapsedRealtimeMs - SystemClock.elapsedRealtime() when the load was canceled.

  loadDurationMs - The duration in milliseconds of the load since Loader.startLoading(T, com.google.android.exoplayer2.upstream.Loader.Callback<T>, int) was called up to the point at which it was canceled.

  released - True if the load was canceled because the Loader was released. False otherwise.

• onLoadError

  public Loader.LoadErrorAction onLoadError(ParsingLoadable<SsManifest> loadable,
                                            long elapsedRealtimeMs,
                                            long loadDurationMs,
                                            IOException error,
                                            int errorCount)

  Description copied from interface: Loader.Callback
  Called when a load encounters an error.

  Note: There is guaranteed to be a memory barrier between Loader.Loadable.load() exiting and this callback being called.

  Specified by:

  onLoadError in interface Loader.Callback<ParsingLoadable<SsManifest>>

  Parameters:

  loadable - The loadable whose load has encountered an error.

  elapsedRealtimeMs - SystemClock.elapsedRealtime() when the error occurred.

  loadDurationMs - The duration in milliseconds of the load since Loader.startLoading(T, com.google.android.exoplayer2.upstream.Loader.Callback<T>, int) was called up to the point at which the error occurred.

  error - The load error.

  errorCount - The number of errors this load has encountered, including this one.

  Returns:

  The desired error handling action. One of Loader.RETRY, Loader.RETRY_RESET_ERROR_COUNT, Loader.DONT_RETRY, Loader.DONT_RETRY_FATAL or a retry action created by Loader.createRetryAction(boolean, long).