com.google.android.exoplayer2.source.smoothstreaming

Class DefaultSsChunkSource

java.lang.Object

com.google.android.exoplayer2.source.smoothstreaming.DefaultSsChunkSource

All Implemented Interfaces:

ChunkSource, SsChunkSource

public class DefaultSsChunkSource
extends Object
implements SsChunkSource

A default SsChunkSource implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultSsChunkSource.Factory

Constructor Summary

Constructors

Constructor and Description
DefaultSsChunkSource(LoaderErrorThrower manifestLoaderErrorThrower, SsManifest manifest, int elementIndex, TrackSelection trackSelection, DataSource dataSource, TrackEncryptionBox[] trackEncryptionBoxes)

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, 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, Exception e) Called when the ChunkSampleStream encounters an error loading a chunk obtained from this source.
void	updateManifest(SsManifest newManifest)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultSsChunkSource

public DefaultSsChunkSource(LoaderErrorThrower manifestLoaderErrorThrower,
                            SsManifest manifest,
                            int elementIndex,
                            TrackSelection trackSelection,
                            DataSource dataSource,
                            TrackEncryptionBox[] trackEncryptionBoxes)

Parameters:

manifestLoaderErrorThrower - Throws errors affecting loading of manifests.

manifest - The initial manifest.

elementIndex - The index of the stream element in the manifest.

trackSelection - The track selection.

dataSource - A DataSource suitable for loading the media data.

trackEncryptionBoxes - Track encryption boxes for the stream.

Method Detail

updateManifest

public void updateManifest(SsManifest newManifest)

Specified by:

updateManifest in interface SsChunkSource

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.

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

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

Specified by:

getPreferredQueueSize in interface ChunkSource

Parameters:

playbackPositionUs - The current playback position.

queue - The queue of buffered MediaChunks.

Returns:

The preferred queue size.

getNextChunk

public final void getNextChunk(MediaChunk previous,
                               long playbackPositionUs,
                               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:

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

public void onChunkLoadCompleted(Chunk chunk)

Description copied from interface: ChunkSource

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

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

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)

Description copied from interface: ChunkSource

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.

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.

Returns:

Whether the load should be canceled.