Class Mp4Extractor
- java.lang.Object
-
- com.google.android.exoplayer2.extractor.mp4.Mp4Extractor
-
@Deprecated public final class Mp4Extractor extends Object implements Extractor, SeekMap
Deprecated.com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.Extracts data from the MP4 container format.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
Mp4Extractor.Flags
Deprecated.Flags controlling the behavior of the extractor.-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.extractor.Extractor
Extractor.ReadResult
-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.extractor.SeekMap
SeekMap.SeekPoints, SeekMap.Unseekable
-
-
Field Summary
Fields Modifier and Type Field Description static ExtractorsFactory
FACTORY
Deprecated.Factory forMp4Extractor
instances.static int
FLAG_READ_MOTION_PHOTO_METADATA
Deprecated.Flag to extractMotionPhotoMetadata
from HEIC motion photos following the Google Photos Motion Photo File Format V1.1.static int
FLAG_READ_SEF_DATA
Deprecated.Flag to extractSlowMotionData
metadata from Samsung Extension Format (SEF) slow motion videos.static int
FLAG_WORKAROUND_IGNORE_EDIT_LISTS
Deprecated.Flag to ignore any edit lists in the stream.-
Fields inherited from interface com.google.android.exoplayer2.extractor.Extractor
RESULT_CONTINUE, RESULT_END_OF_INPUT, RESULT_SEEK
-
-
Constructor Summary
Constructors Constructor Description Mp4Extractor()
Deprecated.Creates a new extractor for unfragmented MP4 streams.Mp4Extractor(@com.google.android.exoplayer2.extractor.mp4.Mp4Extractor.Flags int flags)
Deprecated.Creates a new extractor for unfragmented MP4 streams, using the specified flags to control the extractor's behavior.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description long
getDurationUs()
Deprecated.Returns the duration of the stream in microseconds.SeekMap.SeekPoints
getSeekPoints(long timeUs)
Deprecated.Obtains seek points for the specified seek time in microseconds.SeekMap.SeekPoints
getSeekPoints(long timeUs, int trackId)
Deprecated.Equivalent toSeekMap.getSeekPoints(long)
, except it adds thetrackId
parameter.void
init(ExtractorOutput output)
Deprecated.Initializes the extractor with anExtractorOutput
.boolean
isSeekable()
Deprecated.Returns whether seeking is supported.int
read(ExtractorInput input, PositionHolder seekPosition)
Deprecated.Extracts data read from a providedExtractorInput
.void
release()
Deprecated.Releases all kept resources.void
seek(long position, long timeUs)
Deprecated.Notifies the extractor that a seek has occurred.boolean
sniff(ExtractorInput input)
Deprecated.Returns whether this extractor can extract samples from theExtractorInput
, which must provide data from the start of the stream.
-
-
-
Field Detail
-
FACTORY
public static final ExtractorsFactory FACTORY
Deprecated.Factory forMp4Extractor
instances.
-
FLAG_WORKAROUND_IGNORE_EDIT_LISTS
public static final int FLAG_WORKAROUND_IGNORE_EDIT_LISTS
Deprecated.Flag to ignore any edit lists in the stream.- See Also:
- Constant Field Values
-
FLAG_READ_MOTION_PHOTO_METADATA
public static final int FLAG_READ_MOTION_PHOTO_METADATA
Deprecated.Flag to extractMotionPhotoMetadata
from HEIC motion photos following the Google Photos Motion Photo File Format V1.1.As playback is not supported for motion photos, this flag should only be used for metadata retrieval use cases.
- See Also:
- Constant Field Values
-
FLAG_READ_SEF_DATA
public static final int FLAG_READ_SEF_DATA
Deprecated.Flag to extractSlowMotionData
metadata from Samsung Extension Format (SEF) slow motion videos.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Mp4Extractor
public Mp4Extractor()
Deprecated.Creates a new extractor for unfragmented MP4 streams.
-
Mp4Extractor
public Mp4Extractor(@com.google.android.exoplayer2.extractor.mp4.Mp4Extractor.Flags int flags)
Deprecated.Creates a new extractor for unfragmented MP4 streams, using the specified flags to control the extractor's behavior.- Parameters:
flags
- Flags that control the extractor's behavior.
-
-
Method Detail
-
sniff
public boolean sniff(ExtractorInput input) throws IOException
Deprecated.Description copied from interface:Extractor
Returns whether this extractor can extract samples from theExtractorInput
, which must provide data from the start of the stream.If
true
is returned, theinput
's reading position may have been modified. Otherwise, only its peek position may have been modified.- Specified by:
sniff
in interfaceExtractor
- Parameters:
input
- TheExtractorInput
from which data should be peeked/read.- Returns:
- Whether this extractor can read the provided input.
- Throws:
IOException
- If an error occurred reading from the input.
-
init
public void init(ExtractorOutput output)
Deprecated.Description copied from interface:Extractor
Initializes the extractor with anExtractorOutput
. Called at most once.- Specified by:
init
in interfaceExtractor
- Parameters:
output
- AnExtractorOutput
to receive extracted data.
-
seek
public void seek(long position, long timeUs)
Deprecated.Description copied from interface:Extractor
Notifies the extractor that a seek has occurred.Following a call to this method, the
ExtractorInput
passed to the next invocation ofExtractor.read(ExtractorInput, PositionHolder)
is required to provide data starting fromposition
in the stream. Valid random access positions are the start of the stream and positions that can be obtained from anySeekMap
passed to theExtractorOutput
.
-
release
public void release()
Deprecated.Description copied from interface:Extractor
Releases all kept resources.
-
read
public int read(ExtractorInput input, PositionHolder seekPosition) throws IOException
Deprecated.Description copied from interface:Extractor
Extracts data read from a providedExtractorInput
. Must not be called beforeExtractor.init(ExtractorOutput)
.A single call to this method will block until some progress has been made, but will not block for longer than this. Hence each call will consume only a small amount of input data.
In the common case,
Extractor.RESULT_CONTINUE
is returned to indicate that theExtractorInput
passed to the next read is required to provide data continuing from the position in the stream reached by the returning call. If the extractor requires data to be provided from a different position, then that position is set inseekPosition
andExtractor.RESULT_SEEK
is returned. If the extractor reached the end of the data provided by theExtractorInput
, thenExtractor.RESULT_END_OF_INPUT
is returned.When this method throws an
IOException
, extraction may continue by providing anExtractorInput
with an unchangedread position
to a subsequent call to this method.- Specified by:
read
in interfaceExtractor
- Parameters:
input
- TheExtractorInput
from which data should be read.seekPosition
- IfExtractor.RESULT_SEEK
is returned, this holder is updated to hold the position of the required data.- Returns:
- One of the
RESULT_
values defined in this interface. - Throws:
IOException
- If an error occurred reading from or parsing the input.
-
isSeekable
public boolean isSeekable()
Deprecated.Description copied from interface:SeekMap
Returns whether seeking is supported.- Specified by:
isSeekable
in interfaceSeekMap
- Returns:
- Whether seeking is supported.
-
getDurationUs
public long getDurationUs()
Deprecated.Description copied from interface:SeekMap
Returns the duration of the stream in microseconds.- Specified by:
getDurationUs
in interfaceSeekMap
- Returns:
- The duration of the stream in microseconds, or
C.TIME_UNSET
if the duration is unknown.
-
getSeekPoints
public SeekMap.SeekPoints getSeekPoints(long timeUs)
Deprecated.Description copied from interface:SeekMap
Obtains seek points for the specified seek time in microseconds. The returnedSeekMap.SeekPoints
will contain one or two distinct seek points.Two seek points [A, B] are returned in the case that seeking can only be performed to discrete points in time, there does not exist a seek point at exactly the requested time, and there exist seek points on both sides of it. In this case A and B are the closest seek points before and after the requested time. A single seek point is returned in all other cases.
- Specified by:
getSeekPoints
in interfaceSeekMap
- Parameters:
timeUs
- A seek time in microseconds.- Returns:
- The corresponding seek points.
-
getSeekPoints
public SeekMap.SeekPoints getSeekPoints(long timeUs, int trackId)
Deprecated.Equivalent toSeekMap.getSeekPoints(long)
, except it adds thetrackId
parameter.- Parameters:
timeUs
- A seek time in microseconds.trackId
- The id of the track on which to seek forSeekMap.SeekPoints
. May beC.INDEX_UNSET
if the extractor is expected to define the strategy for generatingSeekMap.SeekPoints
.- Returns:
- The corresponding seek points.
-
-