Constructor Detail

• HlsMediaPeriod

  public HlsMediaPeriod​(HlsExtractorFactory extractorFactory,
                        HlsPlaylistTracker playlistTracker,
                        HlsDataSourceFactory dataSourceFactory,
                        @Nullable
                        TransferListener mediaTransferListener,
                        @Nullable
                        CmcdConfiguration cmcdConfiguration,
                        DrmSessionManager drmSessionManager,
                        DrmSessionEventListener.EventDispatcher drmEventDispatcher,
                        LoadErrorHandlingPolicy loadErrorHandlingPolicy,
                        MediaSourceEventListener.EventDispatcher eventDispatcher,
                        Allocator allocator,
                        CompositeSequenceableLoaderFactory compositeSequenceableLoaderFactory,
                        boolean allowChunklessPreparation,
                        @com.google.android.exoplayer2.source.hls.HlsMediaSource.MetadataType int metadataType,
                        boolean useSessionKeys,
                        PlayerId playerId,
                        long timestampAdjusterInitializationTimeoutMs)

  Deprecated.
  Creates an HLS media period.

  Parameters:

  extractorFactory - An HlsExtractorFactory for Extractors for the segments.

  playlistTracker - A tracker for HLS playlists.

  dataSourceFactory - An HlsDataSourceFactory for DataSources for segments and keys.

  mediaTransferListener - The transfer listener to inform of any media data transfers. May be null if no listener is available.

  cmcdConfiguration - The CmcdConfiguration for the period.

  drmSessionManager - The DrmSessionManager to acquire DrmSessions with.

  drmEventDispatcher - A DrmSessionEventListener.EventDispatcher used to distribute DRM-related events.

  loadErrorHandlingPolicy - A LoadErrorHandlingPolicy.

  eventDispatcher - A dispatcher to notify of events.

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

  compositeSequenceableLoaderFactory - A factory to create composite SequenceableLoaders for when this media source loads data from multiple streams.

  allowChunklessPreparation - Whether chunkless preparation is allowed.

  metadataType - The type of metadata to extract from the period.

  useSessionKeys - Whether to use #EXT-X-SESSION-KEY tags.

  playerId - The ID of the current player.

  timestampAdjusterInitializationTimeoutMs - The timeout for the loading thread to wait for the timestamp adjuster to initialize, in milliseconds. A timeout of zero is interpreted as an infinite timeout.

Method Detail

• release

  public void release()

  Deprecated.

• prepare

  public void prepare​(MediaPeriod.Callback callback,
                      long positionUs)

  Deprecated.
  Description copied from interface: MediaPeriod
  Prepares this media period asynchronously.

  callback.onPrepared is called when preparation completes. If preparation fails, MediaPeriod.maybeThrowPrepareError() will throw an IOException.

  If preparation succeeds and results in a source timeline change (e.g. the period duration becoming known), MediaSource.MediaSourceCaller.onSourceInfoRefreshed(MediaSource, Timeline) will be called before callback.onPrepared.

  Specified by:

  prepare in interface MediaPeriod

  Parameters:

  callback - Callback to receive updates from this period, including being notified when preparation completes.

  positionUs - The expected starting position, in microseconds.

• maybeThrowPrepareError

  public void maybeThrowPrepareError()
                              throws IOException

  Deprecated.
  Description copied from interface: MediaPeriod
  Throws an error that's preventing the period from becoming prepared. Does nothing if no such error exists.

  This method is only called before the period has completed preparation.

  Specified by:

  maybeThrowPrepareError in interface MediaPeriod

  Throws:

  IOException - The underlying error.

• getTrackGroups

  public TrackGroupArray getTrackGroups()

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns the TrackGroups exposed by the period.

  This method is only called after the period has been prepared.

  Specified by:

  getTrackGroups in interface MediaPeriod

  Returns:

  The TrackGroups.

• getStreamKeys

  public List<StreamKey> getStreamKeys​(List<ExoTrackSelection> trackSelections)

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns a list of StreamKeys which allow to filter the media in this period to load only the parts needed to play the provided TrackSelections.

  This method is only called after the period has been prepared.

  Specified by:

  getStreamKeys in interface MediaPeriod

  Parameters:

  trackSelections - The TrackSelections describing the tracks for which stream keys are requested.

  Returns:

  The corresponding StreamKeys for the selected tracks, or an empty list if filtering is not possible and the entire media needs to be loaded to play the selected tracks.

• selectTracks

  public long selectTracks​(@NullableType ExoTrackSelection[] selections,
                           boolean[] mayRetainStreamFlags,
                           @NullableType SampleStream[] streams,
                           boolean[] streamResetFlags,
                           long positionUs)

  Deprecated.
  Description copied from interface: MediaPeriod
  Performs a track selection.

  The call receives track selections for each renderer, mayRetainStreamFlags indicating whether the existing SampleStream can be retained for each selection, and the existing streams themselves. The call will update streams to reflect the provided selections, clearing, setting and replacing entries as required. If an existing sample stream is retained but with the requirement that the consuming renderer be reset, then the corresponding flag in streamResetFlags will be set to true. This flag will also be set if a new sample stream is created.

  Note that previously passed TrackSelections are no longer valid, and any references to them must be updated to point to the new selections.

  This method is only called after the period has been prepared.

  Specified by:

  selectTracks in interface MediaPeriod

  Parameters:

  selections - The renderer track selections.

  mayRetainStreamFlags - Flags indicating whether the existing sample stream can be retained for each track selection. A true value indicates that the selection is equivalent to the one that was previously passed, and that the caller does not require that the sample stream be recreated. If a retained sample stream holds any references to the track selection then they must be updated to point to the new selection.

  streams - The existing sample streams, which will be updated to reflect the provided selections.

  streamResetFlags - Will be updated to indicate new sample streams, and sample streams that have been retained but with the requirement that the consuming renderer be reset.

  positionUs - The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position.

  Returns:

  The actual position at which the tracks were enabled, in microseconds.

• discardBuffer

  public void discardBuffer​(long positionUs,
                            boolean toKeyframe)

  Deprecated.
  Description copied from interface: MediaPeriod
  Discards buffered media up to the specified position.

  This method is only called after the period has been prepared.

  Specified by:

  discardBuffer in interface MediaPeriod

  Parameters:

  positionUs - The position in microseconds.

  toKeyframe - If true then for each track discards samples up to the keyframe before or at the specified position, rather than any sample before or at that position.

• reevaluateBuffer

  public void reevaluateBuffer​(long positionUs)

  Deprecated.
  Description copied from interface: MediaPeriod
  Re-evaluates the buffer given the playback position.

  This method is only called after the period has been prepared.

  A period may choose to discard buffered media or cancel ongoing loads so that media can be re-buffered in a different quality.

  Specified by:

  reevaluateBuffer in interface MediaPeriod

  Specified by:

  reevaluateBuffer in interface SequenceableLoader

  Parameters:

  positionUs - The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position in this period minus the duration of any media in previous periods still to be played.

• continueLoading

  public boolean continueLoading​(long positionUs)

  Deprecated.
  Description copied from interface: MediaPeriod
  Attempts to continue loading.

  This method may be called both during and after the period has been prepared.

  A period may call SequenceableLoader.Callback.onContinueLoadingRequested(SequenceableLoader) on the MediaPeriod.Callback passed to MediaPeriod.prepare(Callback, long) to request that this method be called when the period is permitted to continue loading data. A period may do this both during and after preparation.

  Specified by:

  continueLoading in interface MediaPeriod

  Specified by:

  continueLoading in interface SequenceableLoader

  Parameters:

  positionUs - The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position in this period minus the duration of any media in previous periods still to be played.

  Returns:

  True if progress was made, meaning that MediaPeriod.getNextLoadPositionUs() will return a different value than prior to the call. False otherwise.

• isLoading

  public boolean isLoading()

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns whether the media period is currently loading.

  Specified by:

  isLoading in interface MediaPeriod

  Specified by:

  isLoading in interface SequenceableLoader

• getNextLoadPositionUs

  public long getNextLoadPositionUs()

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns the next load time, or C.TIME_END_OF_SOURCE if loading has finished.

  This method is only called after the period has been prepared. It may be called when no tracks are selected.

  Specified by:

  getNextLoadPositionUs in interface MediaPeriod

  Specified by:

  getNextLoadPositionUs in interface SequenceableLoader

• readDiscontinuity

  public long readDiscontinuity()

  Deprecated.
  Description copied from interface: MediaPeriod
  Attempts to read a discontinuity.

  A discontinuity implies that the provided SampleStreams will start from a new playback position and any output pipelines need to be reset. This happens for example if the streams provide decode-only samples before the intended playback start position that need to be dropped.

  After this method has returned a value other than C.TIME_UNSET, all SampleStreams provided by the period are guaranteed to start from a key frame.

  This method is only called after the period has been prepared.

  Specified by:

  readDiscontinuity in interface MediaPeriod

  Returns:

  The playback position after the discontinuity, in microseconds, or C.TIME_UNSET if there is no discontinuity.

• getBufferedPositionUs

  public long getBufferedPositionUs()

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns an estimate of the position up to which data is buffered for the enabled tracks.

  This method is only called when at least one track is selected.

  Specified by:

  getBufferedPositionUs in interface MediaPeriod

  Specified by:

  getBufferedPositionUs in interface SequenceableLoader

  Returns:

  An estimate of the absolute position in microseconds up to which data is buffered, or C.TIME_END_OF_SOURCE if the track is fully buffered.

• seekToUs

  public long seekToUs​(long positionUs)

  Deprecated.
  Description copied from interface: MediaPeriod
  Attempts to seek to the specified position in microseconds.

  After this method has been called, all SampleStreams provided by the period are guaranteed to start from a key frame.

  This method is only called when at least one track is selected.

  Specified by:

  seekToUs in interface MediaPeriod

  Parameters:

  positionUs - The seek position in microseconds.

  Returns:

  The actual position to which the period was seeked, in microseconds.

• getAdjustedSeekPositionUs

  public long getAdjustedSeekPositionUs​(long positionUs,
                                        SeekParameters seekParameters)

  Deprecated.
  Description copied from interface: MediaPeriod
  Returns the position to which a seek will be performed, given the specified seek position and SeekParameters.

  This method is only called after the period has been prepared.

  Specified by:

  getAdjustedSeekPositionUs in interface MediaPeriod

  Parameters:

  positionUs - The seek position in microseconds.

  seekParameters - Parameters that control how the seek is performed. Implementations may apply seek parameters on a best effort basis.

  Returns:

  The actual position to which a seek will be performed, in microseconds.

• onPlaylistChanged

  public void onPlaylistChanged()

  Deprecated.
  Description copied from interface: HlsPlaylistTracker.PlaylistEventListener
  Called a playlist changes.

  Specified by:

  onPlaylistChanged in interface HlsPlaylistTracker.PlaylistEventListener

• onPlaylistError

  public boolean onPlaylistError​(Uri url,
                                 LoadErrorHandlingPolicy.LoadErrorInfo loadErrorInfo,
                                 boolean forceRetry)

  Deprecated.
  Description copied from interface: HlsPlaylistTracker.PlaylistEventListener
  Called if an error is encountered while loading a playlist.

  Specified by:

  onPlaylistError in interface HlsPlaylistTracker.PlaylistEventListener

  Parameters:

  url - The loaded url that caused the error.

  loadErrorInfo - The load error info.

  forceRetry - Whether retry should be forced without considering exclusion.

  Returns:

  True if excluding did not encounter errors. False otherwise.