com.google.android.exoplayer2.source.chunk

Interface ChunkSource

public interface ChunkSource

A provider of Chunks for a ChunkSampleStream to load.

Method Summary

Modifier and Type	Method and Description
void	getNextChunk(MediaChunk previous, long playbackPositionUs, ChunkHolder out) Returns the next chunk to load.
int	getPreferredQueueSize(long playbackPositionUs, java.util.List<? extends MediaChunk> queue) Evaluates whether MediaChunks should be removed from the back of the queue.
void	maybeThrowError() If the source is currently having difficulty providing chunks, then this method throws the underlying error.
void	onChunkLoadCompleted(Chunk chunk) Called when the ChunkSampleStream has finished loading a chunk obtained from this source.
boolean	onChunkLoadError(Chunk chunk, boolean cancelable, java.lang.Exception e) Called when the ChunkSampleStream encounters an error loading a chunk obtained from this source.

Method Detail

maybeThrowError

void maybeThrowError()
              throws java.io.IOException

If the source is currently having difficulty providing chunks, then this method throws the underlying error. Otherwise does nothing.

This method should only be called after the source has been prepared.

Throws:

java.io.IOException - The underlying error.

getPreferredQueueSize

int getPreferredQueueSize(long playbackPositionUs,
                          java.util.List<? extends MediaChunk> queue)

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).

Parameters:

playbackPositionUs - The current playback position.

queue - The queue of buffered MediaChunks.

Returns:

The preferred queue size.

getNextChunk

void getNextChunk(MediaChunk previous,
                  long playbackPositionUs,
                  ChunkHolder out)

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.

Parameters:

previous - The most recently loaded media chunk.

playbackPositionUs - The current playback position. If previous is null then this parameter is the position from which playback is expected to start (or restart) and hence should be interpreted as a seek position.

out - A holder to populate.

onChunkLoadCompleted

void onChunkLoadCompleted(Chunk chunk)

Called when the ChunkSampleStream has finished loading a chunk obtained from this source.

This method should only be called when the source is enabled.

Parameters:

chunk - The chunk whose load has been completed.

onChunkLoadError

boolean onChunkLoadError(Chunk chunk,
                         boolean cancelable,
                         java.lang.Exception e)

Called when the ChunkSampleStream encounters an error loading a chunk obtained from this source.

This method should only be called when the source is enabled.

Parameters:

chunk - The chunk whose load encountered the error.

cancelable - Whether the load can be canceled.

e - The error.

Returns:

Whether the load should be canceled.