com.google.android.exoplayer.chunk

Class ContainerMediaChunk

java.lang.Object

com.google.android.exoplayer.chunk.Chunk

com.google.android.exoplayer.chunk.MediaChunk

com.google.android.exoplayer.chunk.BaseMediaChunk

com.google.android.exoplayer.chunk.ContainerMediaChunk

All Implemented Interfaces:

ChunkExtractorWrapper.SingleTrackOutput, TrackOutput, Loader.Loadable

public class ContainerMediaChunk
extends BaseMediaChunk
implements ChunkExtractorWrapper.SingleTrackOutput

A BaseMediaChunk that uses an Extractor to parse sample data.

Field Summary

Fields inherited from class com.google.android.exoplayer.chunk.BaseMediaChunk

isMediaFormatFinal

Fields inherited from class com.google.android.exoplayer.chunk.MediaChunk

chunkIndex, endTimeUs, startTimeUs

Fields inherited from class com.google.android.exoplayer.chunk.Chunk

dataSource, dataSpec, format, NO_PARENT_ID, parentId, trigger, TRIGGER_ADAPTIVE, TRIGGER_CUSTOM_BASE, TRIGGER_INITIAL, TRIGGER_MANUAL, TRIGGER_TRICK_PLAY, TRIGGER_UNSPECIFIED, type, TYPE_CUSTOM_BASE, TYPE_DRM, TYPE_MANIFEST, TYPE_MEDIA, TYPE_MEDIA_INITIALIZATION, TYPE_UNSPECIFIED

Constructor Summary

Constructors

Constructor and Description
ContainerMediaChunk(DataSource dataSource, DataSpec dataSpec, int trigger, Format format, long startTimeUs, long endTimeUs, int chunkIndex, long sampleOffsetUs, ChunkExtractorWrapper extractorWrapper, MediaFormat mediaFormat, int adaptiveMaxWidth, int adaptiveMaxHeight, DrmInitData drmInitData, boolean isMediaFormatFinal, int parentId)

Method Summary

Modifier and Type	Method and Description
long	bytesLoaded() Gets the number of bytes that have been loaded.
void	cancelLoad() Cancels the load.
void	drmInitData(DrmInitData drmInitData)
void	format(MediaFormat mediaFormat) Invoked when the MediaFormat of the track has been extracted from the stream.
DrmInitData	getDrmInitData() Gets the DrmInitData corresponding to the chunk.
MediaFormat	getMediaFormat() Gets the MediaFormat corresponding to the chunk.
boolean	isLoadCanceled() Whether the load has been canceled.
void	load() Performs the load, returning on completion or cancelation.
int	sampleData(ExtractorInput input, int length, boolean allowEndOfInput) Invoked to write sample data to the output.
void	sampleData(ParsableByteArray data, int length) Invoked to write sample data to the output.
void	sampleMetadata(long timeUs, int flags, int size, int offset, byte[] encryptionKey) Invoked when metadata associated with a sample has been extracted from the stream.
void	seekMap(SeekMap seekMap)

Methods inherited from class com.google.android.exoplayer.chunk.BaseMediaChunk

getFirstSampleIndex, getOutput, init

Methods inherited from class com.google.android.exoplayer.chunk.MediaChunk

getDurationUs, getNextChunkIndex

Methods inherited from class java.lang.Object

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

Constructor Detail

ContainerMediaChunk

public ContainerMediaChunk(DataSource dataSource,
                           DataSpec dataSpec,
                           int trigger,
                           Format format,
                           long startTimeUs,
                           long endTimeUs,
                           int chunkIndex,
                           long sampleOffsetUs,
                           ChunkExtractorWrapper extractorWrapper,
                           MediaFormat mediaFormat,
                           int adaptiveMaxWidth,
                           int adaptiveMaxHeight,
                           DrmInitData drmInitData,
                           boolean isMediaFormatFinal,
                           int parentId)

Parameters:

dataSource - A DataSource for loading the data.

dataSpec - Defines the data to be loaded.

trigger - The reason for this chunk being selected.

format - The format of the stream to which this chunk belongs.

startTimeUs - The start time of the media contained by the chunk, in microseconds.

endTimeUs - The end time of the media contained by the chunk, in microseconds.

chunkIndex - The index of the chunk.

sampleOffsetUs - An offset to add to the sample timestamps parsed by the extractor.

extractorWrapper - A wrapped extractor to use for parsing the data.

mediaFormat - The MediaFormat of the chunk, if known. May be null if the data is known to define its own format.

adaptiveMaxWidth - If this chunk contains video and is part of an adaptive playback, this is the maximum width of the video in pixels that will be encountered during the playback. MediaFormat.NO_VALUE otherwise.

adaptiveMaxHeight - If this chunk contains video and is part of an adaptive playback, this is the maximum height of the video in pixels that will be encountered during the playback. MediaFormat.NO_VALUE otherwise.

drmInitData - The DrmInitData for the chunk. Null if the media is not drm protected. May also be null if the data is known to define its own initialization data.

isMediaFormatFinal - True if mediaFormat and drmInitData are known to be correct and final. False if the data may define its own format or initialization data.

parentId - Identifier for a parent from which this chunk originates.

Method Detail

bytesLoaded

public final long bytesLoaded()

Description copied from class: Chunk

Gets the number of bytes that have been loaded.

Specified by:

bytesLoaded in class Chunk

Returns:

The number of bytes that have been loaded.

getMediaFormat

public final MediaFormat getMediaFormat()

Description copied from class: BaseMediaChunk

Gets the MediaFormat corresponding to the chunk.

See BaseMediaChunk.isMediaFormatFinal for information about when this method is guaranteed to return correct data.

Specified by:

getMediaFormat in class BaseMediaChunk

Returns:

The MediaFormat corresponding to this chunk.

getDrmInitData

public final DrmInitData getDrmInitData()

Description copied from class: BaseMediaChunk

Gets the DrmInitData corresponding to the chunk.

See BaseMediaChunk.isMediaFormatFinal for information about when this method is guaranteed to return correct data.

Specified by:

getDrmInitData in class BaseMediaChunk

Returns:

The DrmInitData corresponding to this chunk.

seekMap

public final void seekMap(SeekMap seekMap)

Specified by:

seekMap in interface ChunkExtractorWrapper.SingleTrackOutput

See Also:

ExtractorOutput.seekMap(SeekMap)

drmInitData

public final void drmInitData(DrmInitData drmInitData)

Specified by:

drmInitData in interface ChunkExtractorWrapper.SingleTrackOutput

See Also:

ExtractorOutput.drmInitData(DrmInitData)

format

public final void format(MediaFormat mediaFormat)

Description copied from interface: TrackOutput

Invoked when the MediaFormat of the track has been extracted from the stream.

Specified by:

format in interface TrackOutput

Parameters:

mediaFormat - The extracted MediaFormat.

sampleData

public final int sampleData(ExtractorInput input,
                            int length,
                            boolean allowEndOfInput)
                     throws IOException,
                            InterruptedException

Description copied from interface: TrackOutput

Invoked to write sample data to the output.

Specified by:

sampleData in interface TrackOutput

Parameters:

input - An ExtractorInput from which to read the sample data.

length - The maximum length to read from the input.

allowEndOfInput - True if encountering the end of the input having read no data is allowed, and should result in C.RESULT_END_OF_INPUT being returned. False if it should be considered an error, causing an EOFException to be thrown.

Returns:

The number of bytes appended.

Throws:

IOException - If an error occurred reading from the input.

InterruptedException - If the thread was interrupted.

sampleData

public final void sampleData(ParsableByteArray data,
                             int length)

Description copied from interface: TrackOutput

Invoked to write sample data to the output.

Specified by:

sampleData in interface TrackOutput

Parameters:

data - A ParsableByteArray from which to read the sample data.

length - The number of bytes to read.

sampleMetadata

public final void sampleMetadata(long timeUs,
                                 int flags,
                                 int size,
                                 int offset,
                                 byte[] encryptionKey)

Description copied from interface: TrackOutput

Invoked when metadata associated with a sample has been extracted from the stream.

The corresponding sample data will have already been passed to the output via calls to TrackOutput.sampleData(ExtractorInput, int, boolean) or TrackOutput.sampleData(ParsableByteArray, int).

Specified by:

sampleMetadata in interface TrackOutput

Parameters:

timeUs - The media timestamp associated with the sample, in microseconds.

flags - Flags associated with the sample. See SampleHolder.flags.

size - The size of the sample data, in bytes.

offset - The number of bytes that have been passed to TrackOutput.sampleData(ExtractorInput, int, boolean) or TrackOutput.sampleData(ParsableByteArray, int) since the last byte belonging to the sample whose metadata is being passed.

encryptionKey - The encryption key associated with the sample. May be null.

cancelLoad

public final void cancelLoad()

Description copied from interface: Loader.Loadable

Cancels the load.

Specified by:

cancelLoad in interface Loader.Loadable

isLoadCanceled

public final boolean isLoadCanceled()

Description copied from interface: Loader.Loadable

Whether the load has been canceled.

Specified by:

isLoadCanceled in interface Loader.Loadable

Returns:

True if the load has been canceled. False otherwise.

load

public final void load()
                throws IOException,
                       InterruptedException

Description copied from interface: Loader.Loadable

Performs the load, returning on completion or cancelation.

Specified by:

load in interface Loader.Loadable

Throws:

IOException

InterruptedException