Class DefaultSsChunkSource

    • Constructor Detail

      • DefaultSsChunkSource

        public DefaultSsChunkSource​(LoaderErrorThrower manifestLoaderErrorThrower,
                                    SsManifest manifest,
                                    int streamElementIndex,
                                    ExoTrackSelection trackSelection,
                                    DataSource dataSource)
        Parameters:
        manifestLoaderErrorThrower - Throws errors affecting loading of manifests.
        manifest - The initial manifest.
        streamElementIndex - The index of the stream element in the manifest.
        trackSelection - The track selection.
        dataSource - A DataSource suitable for loading the media data.
    • Method Detail

      • getAdjustedSeekPositionUs

        public long getAdjustedSeekPositionUs​(long positionUs,
                                              SeekParameters seekParameters)
        Description copied from interface: ChunkSource
        Adjusts a seek position given the specified SeekParameters. Chunk boundaries are used as sync points.
        Specified by:
        getAdjustedSeekPositionUs in interface ChunkSource
        Parameters:
        positionUs - The seek position in microseconds.
        seekParameters - Parameters that control how the seek is performed.
        Returns:
        The adjusted seek position, in microseconds.
      • updateTrackSelection

        public void updateTrackSelection​(ExoTrackSelection trackSelection)
        Description copied from interface: SsChunkSource
        Updates the track selection.
        Specified by:
        updateTrackSelection in interface SsChunkSource
        Parameters:
        trackSelection - The new track selection instance. Must be equivalent to the previous one.
      • maybeThrowError

        public void maybeThrowError()
                             throws IOException
        Description copied from interface: ChunkSource
        If the source is currently having difficulty providing chunks, then this method throws the underlying error. Otherwise does nothing.
        Specified by:
        maybeThrowError in interface ChunkSource
        Throws:
        IOException - The underlying error.
      • getPreferredQueueSize

        public int getPreferredQueueSize​(long playbackPositionUs,
                                         List<? extends MediaChunk> queue)
        Description copied from interface: ChunkSource
        Evaluates whether MediaChunks should be removed from the back of the queue.

        Removing MediaChunks from the back of the queue can be useful if they could be replaced with chunks of a significantly higher quality (e.g. because the available bandwidth has substantially increased).

        Will only be called if no MediaChunk in the queue is currently loading.

        Specified by:
        getPreferredQueueSize in interface ChunkSource
        Parameters:
        playbackPositionUs - The current playback position, in microseconds.
        queue - The queue of buffered MediaChunks.
        Returns:
        The preferred queue size.
      • shouldCancelLoad

        public boolean shouldCancelLoad​(long playbackPositionUs,
                                        Chunk loadingChunk,
                                        List<? extends MediaChunk> queue)
        Description copied from interface: ChunkSource
        Returns whether an ongoing load of a chunk should be canceled.
        Specified by:
        shouldCancelLoad in interface ChunkSource
        Parameters:
        playbackPositionUs - The current playback position, in microseconds.
        loadingChunk - The currently loading Chunk.
        queue - The queue of buffered MediaChunks.
        Returns:
        Whether the ongoing load of loadingChunk should be canceled.
      • getNextChunk

        public final void getNextChunk​(long playbackPositionUs,
                                       long loadPositionUs,
                                       List<? extends MediaChunk> queue,
                                       ChunkHolder out)
        Description copied from interface: ChunkSource
        Returns the next chunk to load.

        If a chunk is available then ChunkHolder.chunk is set. If the end of the stream has been reached then ChunkHolder.endOfStream is set. If a chunk is not available but the end of the stream has not been reached, the ChunkHolder is not modified.

        Specified by:
        getNextChunk in interface ChunkSource
        Parameters:
        playbackPositionUs - The current playback position in microseconds. If playback of the period to which this chunk source belongs has not yet started, the value will be the starting position in the period minus the duration of any media in previous periods still to be played.
        loadPositionUs - The current load position in microseconds. If queue is empty, this is the starting position from which chunks should be provided. Else it's equal to Chunk.endTimeUs of the last chunk in the queue.
        queue - The queue of buffered MediaChunks.
        out - A holder to populate.
      • onChunkLoadCompleted

        public void onChunkLoadCompleted​(Chunk chunk)
        Description copied from interface: ChunkSource
        Called when the ChunkSampleStream has finished loading a chunk obtained from this source.
        Specified by:
        onChunkLoadCompleted in interface ChunkSource
        Parameters:
        chunk - The chunk whose load has been completed.
      • onChunkLoadError

        public boolean onChunkLoadError​(Chunk chunk,
                                        boolean cancelable,
                                        Exception e,
                                        long exclusionDurationMs)
        Description copied from interface: ChunkSource
        Called when the ChunkSampleStream encounters an error loading a chunk obtained from this source.
        Specified by:
        onChunkLoadError in interface ChunkSource
        Parameters:
        chunk - The chunk whose load encountered the error.
        cancelable - Whether the load can be canceled.
        e - The error.
        exclusionDurationMs - The duration for which the associated track may be excluded, or C.TIME_UNSET if the track may not be excluded.
        Returns:
        Whether the load should be canceled so that a replacement chunk can be loaded instead. Must be false if cancelable is false. If true, ChunkSource.getNextChunk(long, long, List, ChunkHolder) will be called to obtain the replacement chunk.
      • release

        public void release()
        Description copied from interface: ChunkSource
        Releases any held resources.
        Specified by:
        release in interface ChunkSource