MediaParser
class MediaParser
| kotlin.Any | |
| ↳ | android.media.MediaParser |
Parses media container formats and extracts contained media samples and metadata.
This class provides access to a battery of low-level media container parsers. Each instance of this class is associated to a specific media parser implementation which is suitable for extraction from a specific media container format. The media parser implementation assignment depends on the factory method (see create and createByName) used to create the instance.
Users must implement the following to use this class.
InputReader: Provides the media container's bytes to parse.OutputConsumer: Provides a sink for all extracted data and metadata.
The following code snippet includes a usage example:
MyOutputConsumer myOutputConsumer = new MyOutputConsumer();
MyInputReader myInputReader = new MyInputReader("www.example.com");
MediaParser mediaParser = MediaParser.create(myOutputConsumer);
while (mediaParser.advance(myInputReader)) {}
mediaParser.release();
mediaParser = null;
The following code snippet provides a rudimentary OutputConsumer sample implementation which extracts and publishes all video samples:
class VideoOutputConsumer implements MediaParser.OutputConsumer {
private byte[] sampleDataBuffer = new byte[4096];
private byte[] discardedDataBuffer = new byte[4096];
private int videoTrackIndex = -1;
private int bytesWrittenCount = 0;
@Override
public void onSeekMapFound(int i, @NonNull MediaFormat mediaFormat) {
// Do nothing.
}
@Override
public void onTrackDataFound(int i, @NonNull TrackData trackData) {
MediaFormat mediaFormat = trackData.mediaFormat;
if (videoTrackIndex == -1 &&
mediaFormat
.getString(MediaFormat.KEY_MIME, /* defaultValue= */ "")
.startsWith("video/")) {
videoTrackIndex = i;
}
}
@Override
public void onSampleDataFound(int trackIndex, @NonNull InputReader inputReader)
throws IOException {
int numberOfBytesToRead = (int) inputReader.getLength();
if (videoTrackIndex != trackIndex) {
// Discard contents.
inputReader.read(
discardedDataBuffer,
/* offset= */ 0,
Math.min(discardDataBuffer.length, numberOfBytesToRead));
} else {
ensureSpaceInBuffer(numberOfBytesToRead);
int bytesRead = inputReader.read(
sampleDataBuffer, bytesWrittenCount, numberOfBytesToRead);
bytesWrittenCount += bytesRead;
}
}
@Override
public void onSampleCompleted(
int trackIndex,
long timeMicros,
int flags,
int size,
int offset,
@Nullable CryptoInfo cryptoData) {
if (videoTrackIndex != trackIndex) {
return; // It's not the video track. Ignore.
}
byte[] sampleData = new byte[size];
int sampleStartOffset = bytesWrittenCount - size - offset;
System.arraycopy(
sampleDataBuffer,
sampleStartOffset,
sampleData,
/* destPos= */ 0,
size);
// Place trailing bytes at the start of the buffer.
System.arraycopy(
sampleDataBuffer,
bytesWrittenCount - offset,
sampleDataBuffer,
/* destPos= */ 0,
/* size= */ offset);
bytesWrittenCount = bytesWrittenCount - offset;
publishSample(sampleData, timeMicros, flags);
}
private void ensureSpaceInBuffer(int numberOfBytesToRead) {
int requiredLength = bytesWrittenCount + numberOfBytesToRead;
if (requiredLength > sampleDataBuffer.length) {
sampleDataBuffer = Arrays.copyOf(sampleDataBuffer, requiredLength);
}
}
}
Summary
| Nested classes | |
|---|---|
| abstract |
Provides input data to |
| abstract |
Receives extracted media sample data and metadata from |
|
Thrown when an error occurs while parsing a media stream. |
|
|
Maps seek positions to |
|
|
Defines a seek point in a media stream. |
|
| abstract |
|
|
Holds information associated with a track. |
|
|
Thrown if all parser implementations provided to |
|
| Constants | |
|---|---|
| static String |
Sets whether constant bitrate seeking should be enabled for ADTS parsing. |
| static String |
Sets whether constant bitrate seeking should be enabled for AMR. |
| static String |
Sets whether the ID3 track should be disabled for FLAC. |
| static String |
Sets whether Matroska parsing should avoid seeking to the cues element. |
| static String |
Sets whether the ID3 track should be disabled for MP3. |
| static String |
Sets whether constant bitrate seeking should be enabled for MP3. |
| static String |
Sets whether MP3 parsing should generate a time-to-byte mapping. |
| static String |
Sets whether MP4 parsing should ignore edit lists. |
| static String |
Sets whether MP4 parsing should ignore the tfdt box. |
| static String |
Sets whether MP4 parsing should treat all video frames as key frames. |
| static String |
Sets whether TS should treat samples consisting of non-IDR I slices as synchronization samples (key-frames). |
| static String |
Sets whether TS parsing should split AVC stream into access units based on slice headers. |
| static String |
Sets whether TS parsing should handle HDMV DTS audio streams. |
| static String |
Sets whether TS parsing should ignore AAC elementary streams. |
| static String |
Sets whether TS parsing should ignore AVC elementary streams. |
| static String |
Sets whether TS parsing should ignore splice information streams. |
| static String |
Sets the operation mode for TS parsing. |
| static String |
Parser for the AC-3 container format, as defined in Digital Audio Compression Standard (AC-3). |
| static String |
Parser for the AC-4 container format, as defined by Dolby AC-4: Audio delivery for Next-Generation Entertainment Services. |
| static String |
Parser for the ADTS container format, as defined in ISO/IEC 13818-7. |
| static String |
Parser for the AMR container format, as defined in RFC 4867. |
| static String |
Parser for the FLAC container format, as defined in the spec. |
| static String |
Parser for the FLV container format, as defined in Adobe Flash Video File Format Specification. |
| static String |
Parser for fragmented files using the MP4 container format, as defined in ISO/IEC 14496-12. |
| static String |
Parser for the Matroska container format, as defined in the spec. |
| static String |
Parser for the MP3 container format, as defined in ISO/IEC 11172-3. |
| static String |
Parser for non-fragmented files using the MP4 container format, as defined in ISO/IEC 14496-12. |
| static String |
Parser for the OGG container format, as defined in RFC 3533. |
| static String |
Parser for the PS container format, as defined in ISO/IEC 11172-1. |
| static String |
Parser for the TS container format, as defined in ISO/IEC 13818-1. |
| static String |
Parser name returned by |
| static String |
Parser for the WAV container format, as defined in Multimedia Programming Interface and Data Specifications. |
| static Int |
Indicates that the sample should be decoded but not rendered. |
| static Int |
Indicates that the sample is (at least partially) encrypted. |
| static Int |
Indicates that the sample has supplemental data. |
| static Int |
Indicates that the sample holds a synchronization sample. |
| static Int |
Indicates that the sample is known to contain the last media sample of the stream. |
| Public methods | |
|---|---|
| Boolean |
advance(seekableInputReader: MediaParser.SeekableInputReader)Makes progress in the extraction of the input media stream, unless the end of the input has been reached. |
| static MediaParser |
create(outputConsumer: MediaParser.OutputConsumer, vararg parserNames: String!)Creates an instance whose backing parser will be selected by sniffing the content during the first |
| static MediaParser |
createByName(name: String, outputConsumer: MediaParser.OutputConsumer)Creates an instance backed by the parser with the given |
| LogSessionId | |
| String |
Returns the name of the backing parser implementation. |
| static MutableList<String!> |
getParserNames(mediaFormat: MediaFormat)Returns an immutable list with the names of the parsers that are suitable for container formats with the given |
| Unit |
release()Releases any acquired resources. |
| Unit |
seek(seekPoint: MediaParser.SeekPoint)Seeks within the media container being extracted. |
| Unit |
setLogSessionId(logSessionId: LogSessionId) |
| MediaParser |
setParameter(parameterName: String, value: Any)Sets parser-specific parameters which allow customizing behavior. |
| Boolean |
supportsParameter(parameterName: String)Returns whether the given |
Constants
PARAMETER_ADTS_ENABLE_CBR_SEEKING
static val PARAMETER_ADTS_ENABLE_CBR_SEEKING: String
Sets whether constant bitrate seeking should be enabled for ADTS parsing. boolean expected. Default value is false.
Value: "android.media.mediaparser.adts.enableCbrSeeking"
PARAMETER_AMR_ENABLE_CBR_SEEKING
static val PARAMETER_AMR_ENABLE_CBR_SEEKING: String
Sets whether constant bitrate seeking should be enabled for AMR. boolean expected. Default value is false.
Value: "android.media.mediaparser.amr.enableCbrSeeking"
PARAMETER_FLAC_DISABLE_ID3
static val PARAMETER_FLAC_DISABLE_ID3: String
Sets whether the ID3 track should be disabled for FLAC. boolean expected. Default value is false.
Value: "android.media.mediaparser.flac.disableId3"
PARAMETER_MATROSKA_DISABLE_CUES_SEEKING
static val PARAMETER_MATROSKA_DISABLE_CUES_SEEKING: String
Sets whether Matroska parsing should avoid seeking to the cues element. boolean expected. Default value is false.
If this flag is enabled and the cues element occurs after the first cluster, then the media is treated as unseekable.
Value: "android.media.mediaparser.matroska.disableCuesSeeking"
PARAMETER_MP3_DISABLE_ID3
static val PARAMETER_MP3_DISABLE_ID3: String
Sets whether the ID3 track should be disabled for MP3. boolean expected. Default value is false.
Value: "android.media.mediaparser.mp3.disableId3"
PARAMETER_MP3_ENABLE_CBR_SEEKING
static val PARAMETER_MP3_ENABLE_CBR_SEEKING: String
Sets whether constant bitrate seeking should be enabled for MP3. boolean expected. Default value is false.
Value: "android.media.mediaparser.mp3.enableCbrSeeking"
PARAMETER_MP3_ENABLE_INDEX_SEEKING
static val PARAMETER_MP3_ENABLE_INDEX_SEEKING: String
Sets whether MP3 parsing should generate a time-to-byte mapping. boolean expected. Default value is false.
Enabling this flag may require to scan a significant portion of the file to compute a seek point. Therefore, it should only be used if:
- the file is small, or
- the bitrate is variable (or the type of bitrate is unknown) and the seeking metadata provided in the file is not precise enough (or is not present).
Value: "android.media.mediaparser.mp3.enableIndexSeeking"
PARAMETER_MP4_IGNORE_EDIT_LISTS
static val PARAMETER_MP4_IGNORE_EDIT_LISTS: String
Sets whether MP4 parsing should ignore edit lists. boolean expected. Default value is false.
Value: "android.media.mediaparser.mp4.ignoreEditLists"
PARAMETER_MP4_IGNORE_TFDT_BOX
static val PARAMETER_MP4_IGNORE_TFDT_BOX: String
Sets whether MP4 parsing should ignore the tfdt box. boolean expected. Default value is false.
Value: "android.media.mediaparser.mp4.ignoreTfdtBox"
PARAMETER_MP4_TREAT_VIDEO_FRAMES_AS_KEYFRAMES
static val PARAMETER_MP4_TREAT_VIDEO_FRAMES_AS_KEYFRAMES: String
Sets whether MP4 parsing should treat all video frames as key frames. boolean expected. Default value is false.
Value: "android.media.mediaparser.mp4.treatVideoFramesAsKeyframes"
PARAMETER_TS_ALLOW_NON_IDR_AVC_KEYFRAMES
static val PARAMETER_TS_ALLOW_NON_IDR_AVC_KEYFRAMES: String
Sets whether TS should treat samples consisting of non-IDR I slices as synchronization samples (key-frames). boolean expected. Default value is false.
Value: "android.media.mediaparser.ts.allowNonIdrAvcKeyframes"
PARAMETER_TS_DETECT_ACCESS_UNITS
static val PARAMETER_TS_DETECT_ACCESS_UNITS: String
Sets whether TS parsing should split AVC stream into access units based on slice headers. boolean expected. Default value is false.
This flag should be left disabled if the stream contains access units delimiters in order to avoid unnecessary computational costs.
Value: "android.media.mediaparser.ts.ignoreDetectAccessUnits"
PARAMETER_TS_ENABLE_HDMV_DTS_AUDIO_STREAMS
static val PARAMETER_TS_ENABLE_HDMV_DTS_AUDIO_STREAMS: String
Sets whether TS parsing should handle HDMV DTS audio streams. boolean expected. Default value is false.
Enabling this flag will disable the detection of SCTE subtitles.
Value: "android.media.mediaparser.ts.enableHdmvDtsAudioStreams"
PARAMETER_TS_IGNORE_AAC_STREAM
static val PARAMETER_TS_IGNORE_AAC_STREAM: String
Sets whether TS parsing should ignore AAC elementary streams. boolean expected. Default value is false.
Value: "android.media.mediaparser.ts.ignoreAacStream"
PARAMETER_TS_IGNORE_AVC_STREAM
static val PARAMETER_TS_IGNORE_AVC_STREAM: String
Sets whether TS parsing should ignore AVC elementary streams. boolean expected. Default value is false.
Value: "android.media.mediaparser.ts.ignoreAvcStream"
PARAMETER_TS_IGNORE_SPLICE_INFO_STREAM
static val PARAMETER_TS_IGNORE_SPLICE_INFO_STREAM: String
Sets whether TS parsing should ignore splice information streams. boolean expected. Default value is false.
Value: "android.media.mediaparser.ts.ignoreSpliceInfoStream"
PARAMETER_TS_MODE
static val PARAMETER_TS_MODE: String
Sets the operation mode for TS parsing. String expected. Valid values are "single_pmt", "multi_pmt", and "hls". Default value is "single_pmt".
The operation modes alter the way TS behaves so that it can handle certain kinds of commonly-occurring malformed media.
"single_pmt": Only the first found PMT is parsed. Others are ignored, even if more PMTs are declared in the PAT."multi_pmt": Behave as described in ISO/IEC 13818-1."hls": Enable"single_pmt"mode, and ignore continuity counters.
Value: "android.media.mediaparser.ts.mode"
PARSER_NAME_AC3
static val PARSER_NAME_AC3: String
Parser for the AC-3 container format, as defined in Digital Audio Compression Standard (AC-3).
Value: "android.media.mediaparser.Ac3Parser"
PARSER_NAME_AC4
static val PARSER_NAME_AC4: String
Parser for the AC-4 container format, as defined by Dolby AC-4: Audio delivery for Next-Generation Entertainment Services.
Value: "android.media.mediaparser.Ac4Parser"
PARSER_NAME_ADTS
static val PARSER_NAME_ADTS: String
Parser for the ADTS container format, as defined in ISO/IEC 13818-7.
Value: "android.media.mediaparser.AdtsParser"
PARSER_NAME_AMR
static val PARSER_NAME_AMR: String
Parser for the AMR container format, as defined in RFC 4867.
Value: "android.media.mediaparser.AmrParser"
PARSER_NAME_FLAC
static val PARSER_NAME_FLAC: String
Parser for the FLAC container format, as defined in the spec.
Value: "android.media.mediaparser.FlacParser"
PARSER_NAME_FLV
static val PARSER_NAME_FLV: String
Parser for the FLV container format, as defined in Adobe Flash Video File Format Specification.
Value: "android.media.mediaparser.FlvParser"
PARSER_NAME_FMP4
static val PARSER_NAME_FMP4: String
Parser for fragmented files using the MP4 container format, as defined in ISO/IEC 14496-12.
Value: "android.media.mediaparser.FragmentedMp4Parser"
PARSER_NAME_MATROSKA
static val PARSER_NAME_MATROSKA: String
Parser for the Matroska container format, as defined in the spec.
Value: "android.media.mediaparser.MatroskaParser"
PARSER_NAME_MP3
static val PARSER_NAME_MP3: String
Parser for the MP3 container format, as defined in ISO/IEC 11172-3.
Value: "android.media.mediaparser.Mp3Parser"
PARSER_NAME_MP4
static val PARSER_NAME_MP4: String
Parser for non-fragmented files using the MP4 container format, as defined in ISO/IEC 14496-12.
Value: "android.media.mediaparser.Mp4Parser"
PARSER_NAME_OGG
static val PARSER_NAME_OGG: String
Parser for the OGG container format, as defined in RFC 3533.
Value: "android.media.mediaparser.OggParser"
PARSER_NAME_PS
static val PARSER_NAME_PS: String
Parser for the PS container format, as defined in ISO/IEC 11172-1.
Value: "android.media.mediaparser.PsParser"
PARSER_NAME_TS
static val PARSER_NAME_TS: String
Parser for the TS container format, as defined in ISO/IEC 13818-1.
Value: "android.media.mediaparser.TsParser"
PARSER_NAME_UNKNOWN
static val PARSER_NAME_UNKNOWN: String
Parser name returned by getParserName() when no parser has been selected yet.
Value: "android.media.mediaparser.UNKNOWN"
PARSER_NAME_WAV
static val PARSER_NAME_WAV: String
Parser for the WAV container format, as defined in Multimedia Programming Interface and Data Specifications.
Value: "android.media.mediaparser.WavParser"
SAMPLE_FLAG_DECODE_ONLY
static val SAMPLE_FLAG_DECODE_ONLY: Int
Indicates that the sample should be decoded but not rendered.
Value: -2147483648
SAMPLE_FLAG_ENCRYPTED
static val SAMPLE_FLAG_ENCRYPTED: Int
Indicates that the sample is (at least partially) encrypted.
Value: 1073741824
SAMPLE_FLAG_HAS_SUPPLEMENTAL_DATA
static val SAMPLE_FLAG_HAS_SUPPLEMENTAL_DATA: Int
Indicates that the sample has supplemental data.
Samples will not have this flag set unless the "android.media.mediaparser.includeSupplementalData" parameter is set to true via setParameter.
Samples with supplemental data have the following sample data format:
- If the
"android.media.mediaparser.inBandCryptoInfo"parameter is set, all encryption information. - (4 bytes)
sample_data_size: The size of the actual sample data, not including supplemental data or encryption information. - (
sample_data_sizebytes): The media sample data. - (remaining bytes) The supplemental data.
Value: 268435456
SAMPLE_FLAG_KEY_FRAME
static val SAMPLE_FLAG_KEY_FRAME: Int
Indicates that the sample holds a synchronization sample.
Value: 1
SAMPLE_FLAG_LAST_SAMPLE
static val SAMPLE_FLAG_LAST_SAMPLE: Int
Indicates that the sample is known to contain the last media sample of the stream.
Value: 536870912
Public methods
advance
fun advance(seekableInputReader: MediaParser.SeekableInputReader): Boolean
Makes progress in the extraction of the input media stream, unless the end of the input has been reached.
This method will block until some progress has been made.
If this instance was created using create, the first call to this method will sniff the content using the selected parser implementations.
| Parameters | |
|---|---|
seekableInputReader |
MediaParser.SeekableInputReader: The SeekableInputReader from which to obtain the media container data. This value cannot be null. |
| Return | |
|---|---|
Boolean |
Whether there is any data left to extract. Returns false if the end of input has been reached. |
| Exceptions | |
|---|---|
java.io.IOException |
If an error occurs while reading from the SeekableInputReader. |
android.media.MediaParser.UnrecognizedInputFormatException |
If the format cannot be recognized by any of the underlying parser implementations. |
create
static fun create(
outputConsumer: MediaParser.OutputConsumer,
vararg parserNames: String!
): MediaParser
Creates an instance whose backing parser will be selected by sniffing the content during the first advance call. Parser implementations will sniff the content in order of appearance in parserNames.
| Parameters | |
|---|---|
outputConsumer |
MediaParser.OutputConsumer: The OutputConsumer to which extracted data is output. This value cannot be null. |
parserNames |
String!: The names of the parsers to sniff the content with. If empty, a default array of names is used. This value cannot be null. Value is android.media.MediaParser#PARSER_NAME_UNKNOWN, android.media.MediaParser#PARSER_NAME_MATROSKA, android.media.MediaParser#PARSER_NAME_FMP4, android.media.MediaParser#PARSER_NAME_MP4, android.media.MediaParser#PARSER_NAME_MP3, android.media.MediaParser#PARSER_NAME_ADTS, android.media.MediaParser#PARSER_NAME_AC3, android.media.MediaParser#PARSER_NAME_TS, android.media.MediaParser#PARSER_NAME_FLV, android.media.MediaParser#PARSER_NAME_OGG, android.media.MediaParser#PARSER_NAME_PS, android.media.MediaParser#PARSER_NAME_WAV, android.media.MediaParser#PARSER_NAME_AMR, android.media.MediaParser#PARSER_NAME_AC4, or android.media.MediaParser#PARSER_NAME_FLAC |
| Return | |
|---|---|
MediaParser |
A new instance. This value cannot be null. |
createByName
static fun createByName(
name: String,
outputConsumer: MediaParser.OutputConsumer
): MediaParser
Creates an instance backed by the parser with the given name. The returned instance will attempt parsing without sniffing the content.
| Parameters | |
|---|---|
name |
String: The name of the parser that will be associated with the created instance. This value cannot be null. Value is android.media.MediaParser#PARSER_NAME_UNKNOWN, android.media.MediaParser#PARSER_NAME_MATROSKA, android.media.MediaParser#PARSER_NAME_FMP4, android.media.MediaParser#PARSER_NAME_MP4, android.media.MediaParser#PARSER_NAME_MP3, android.media.MediaParser#PARSER_NAME_ADTS, android.media.MediaParser#PARSER_NAME_AC3, android.media.MediaParser#PARSER_NAME_TS, android.media.MediaParser#PARSER_NAME_FLV, android.media.MediaParser#PARSER_NAME_OGG, android.media.MediaParser#PARSER_NAME_PS, android.media.MediaParser#PARSER_NAME_WAV, android.media.MediaParser#PARSER_NAME_AMR, android.media.MediaParser#PARSER_NAME_AC4, or android.media.MediaParser#PARSER_NAME_FLAC |
outputConsumer |
MediaParser.OutputConsumer: The OutputConsumer to which track data and samples are pushed. This value cannot be null. |
| Return | |
|---|---|
MediaParser |
A new instance. This value cannot be null. |
| Exceptions | |
|---|---|
java.lang.IllegalArgumentException |
If an invalid name is provided. |
getLogSessionId
fun getLogSessionId(): LogSessionId
| Return | |
|---|---|
LogSessionId |
This value cannot be null. |
getParserName
fun getParserName(): String
Returns the name of the backing parser implementation.
If this instance was creating using createByName, the provided name is returned. If this instance was created using create, this method will return PARSER_NAME_UNKNOWN until the first call to advance, after which the name of the backing parser implementation is returned.
| Return | |
|---|---|
String |
The name of the backing parser implementation, or null if the backing parser implementation has not yet been selected. Value is android.media.MediaParser#PARSER_NAME_UNKNOWN, android.media.MediaParser#PARSER_NAME_MATROSKA, android.media.MediaParser#PARSER_NAME_FMP4, android.media.MediaParser#PARSER_NAME_MP4, android.media.MediaParser#PARSER_NAME_MP3, android.media.MediaParser#PARSER_NAME_ADTS, android.media.MediaParser#PARSER_NAME_AC3, android.media.MediaParser#PARSER_NAME_TS, android.media.MediaParser#PARSER_NAME_FLV, android.media.MediaParser#PARSER_NAME_OGG, android.media.MediaParser#PARSER_NAME_PS, android.media.MediaParser#PARSER_NAME_WAV, android.media.MediaParser#PARSER_NAME_AMR, android.media.MediaParser#PARSER_NAME_AC4, or android.media.MediaParser#PARSER_NAME_FLAC |
getParserNames
static fun getParserNames(mediaFormat: MediaFormat): MutableList<String!>
Returns an immutable list with the names of the parsers that are suitable for container formats with the given MediaFormat.
A parser supports a MediaFormat if the mime type associated with android.media.MediaFormat#KEY_MIME corresponds to the supported container format.
| Parameters | |
|---|---|
mediaFormat |
MediaFormat: The MediaFormat to check support for. This value cannot be null. |
| Return | |
|---|---|
MutableList<String!> |
The parser names that support the given mediaFormat, or the list of all parsers available if no container specific format information is provided. This value cannot be null. Value is android.media.MediaParser#PARSER_NAME_UNKNOWN, android.media.MediaParser#PARSER_NAME_MATROSKA, android.media.MediaParser#PARSER_NAME_FMP4, android.media.MediaParser#PARSER_NAME_MP4, android.media.MediaParser#PARSER_NAME_MP3, android.media.MediaParser#PARSER_NAME_ADTS, android.media.MediaParser#PARSER_NAME_AC3, android.media.MediaParser#PARSER_NAME_TS, android.media.MediaParser#PARSER_NAME_FLV, android.media.MediaParser#PARSER_NAME_OGG, android.media.MediaParser#PARSER_NAME_PS, android.media.MediaParser#PARSER_NAME_WAV, android.media.MediaParser#PARSER_NAME_AMR, android.media.MediaParser#PARSER_NAME_AC4, or android.media.MediaParser#PARSER_NAME_FLAC |
release
fun release(): Unit
Releases any acquired resources.
After calling this method, this instance becomes unusable and no other methods should be invoked.
seek
fun seek(seekPoint: MediaParser.SeekPoint): Unit
Seeks within the media container being extracted.
SeekPoints can be obtained from the SeekMap passed to android.media.MediaParser.OutputConsumer#onSeekMapFound(android.media.MediaParser.SeekMap).
Following a call to this method, the InputReader passed to the next invocation of advance must provide data starting from SeekPoint#position in the stream.
| Parameters | |
|---|---|
seekPoint |
MediaParser.SeekPoint: The SeekPoint to seek to. This value cannot be null. |
setLogSessionId
fun setLogSessionId(logSessionId: LogSessionId): Unit
| Parameters | |
|---|---|
logSessionId |
LogSessionId: This value cannot be null. |
setParameter
fun setParameter(
parameterName: String,
value: Any
): MediaParser
Sets parser-specific parameters which allow customizing behavior.
Must be called before the first call to advance.
| Return | |
|---|---|
MediaParser |
This instance, for convenience. This value cannot be null. |
| Exceptions | |
|---|---|
java.lang.IllegalStateException |
If called after calling advance on the same instance. |
supportsParameter
fun supportsParameter(parameterName: String): Boolean
Returns whether the given parameterName is supported by this parser.
| Return | |
|---|---|
Boolean |
Whether the given parameterName is supported. |