com.google.android.exoplayer.chunk

Class ChunkExtractorWrapper

java.lang.Object

com.google.android.exoplayer.chunk.ChunkExtractorWrapper

All Implemented Interfaces:

ExtractorOutput, TrackOutput

public class ChunkExtractorWrapper
extends Object
implements ExtractorOutput, TrackOutput

An Extractor wrapper for loading chunks containing a single track.

The wrapper allows switching of the ChunkExtractorWrapper.SingleTrackOutput that receives parsed data.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ChunkExtractorWrapper.SingleTrackOutput Receives stream level data extracted by the wrapped Extractor.

Constructor Summary

Constructors

Constructor and Description
ChunkExtractorWrapper(Extractor extractor)

Method Summary

Modifier and Type	Method and Description
void	drmInitData(DrmInitData drmInitData) Invoked when DrmInitData has been extracted from the stream.
void	endTracks() Invoked when all tracks have been identified, meaning that ExtractorOutput.track(int) will not be invoked again.
void	format(MediaFormat format) Invoked when the MediaFormat of the track has been extracted from the stream.
void	init(ChunkExtractorWrapper.SingleTrackOutput output) Initializes the extractor to output to the provided ChunkExtractorWrapper.SingleTrackOutput, and configures it to receive data from a new chunk.
int	read(ExtractorInput input) Reads from the provided ExtractorInput.
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) Invoked when a SeekMap has been extracted from the stream.
TrackOutput	track(int id) Called by the Extractor to get the TrackOutput for a specific track.

Methods inherited from class java.lang.Object

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

Constructor Detail

ChunkExtractorWrapper

public ChunkExtractorWrapper(Extractor extractor)

Parameters:

extractor - The extractor to wrap.

Method Detail

init

public void init(ChunkExtractorWrapper.SingleTrackOutput output)

Initializes the extractor to output to the provided ChunkExtractorWrapper.SingleTrackOutput, and configures it to receive data from a new chunk.

Parameters:

output - The ChunkExtractorWrapper.SingleTrackOutput that will receive the parsed data.

read

public int read(ExtractorInput input)
         throws IOException,
                InterruptedException

Reads from the provided ExtractorInput.

Parameters:

input - The ExtractorInput from which to read.

Returns:

One of Extractor.RESULT_CONTINUE and Extractor.RESULT_END_OF_INPUT.

Throws:

IOException - If an error occurred reading from the source.

InterruptedException - If the thread was interrupted.

track

public TrackOutput track(int id)

Description copied from interface: ExtractorOutput

Called by the Extractor to get the TrackOutput for a specific track.

The same TrackOutput is returned if multiple calls are made with the same trackId.

Specified by:

track in interface ExtractorOutput

Parameters:

id - A track identifier.

Returns:

The TrackOutput for the given track identifier.

endTracks

public void endTracks()

Description copied from interface: ExtractorOutput

Invoked when all tracks have been identified, meaning that ExtractorOutput.track(int) will not be invoked again.

Specified by:

endTracks in interface ExtractorOutput

seekMap

public void seekMap(SeekMap seekMap)

Description copied from interface: ExtractorOutput

Invoked when a SeekMap has been extracted from the stream.

Specified by:

seekMap in interface ExtractorOutput

Parameters:

seekMap - The extracted SeekMap.

drmInitData

public void drmInitData(DrmInitData drmInitData)

Description copied from interface: ExtractorOutput

Invoked when DrmInitData has been extracted from the stream.

Specified by:

drmInitData in interface ExtractorOutput

Parameters:

drmInitData - The extracted DrmInitData.

format

public void format(MediaFormat format)

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:

format - The extracted MediaFormat.

sampleData

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