com.otaliastudios.transcoder.source

Class DefaultDataSource

java.lang.Object

com.otaliastudios.transcoder.source.DefaultDataSource

All Implemented Interfaces:

DataSource

Direct Known Subclasses:

FileDescriptorDataSource, FilePathDataSource, UriDataSource

public abstract class DefaultDataSource
extends java.lang.Object
implements DataSource

A DataSource implementation that uses Android's Media APIs.

Nested Class Summary

Nested classes/interfaces inherited from interface com.otaliastudios.transcoder.source.DataSource

DataSource.Chunk

Constructor Summary

Constructors

Constructor and Description
DefaultDataSource()

Method Summary

Modifier and Type	Method and Description
protected abstract void	applyExtractor(android.media.MediaExtractor extractor)
protected abstract void	applyRetriever(android.media.MediaMetadataRetriever retriever)
boolean	canReadTrack(TrackType type) Returns true if we can read the given track at this point.
long	getDurationUs() Returns the video total duration in microseconds.
double[]	getLocation() Metadata information.
int	getOrientation() Metadata information.
long	getReadUs() Returns the total number of microseconds that have been read until now.
android.media.MediaFormat	getTrackFormat(TrackType type) Called before starting to inspect the input format for this track.
boolean	isDrained() When this source has been totally read, it can return true here to notify an end of input stream.
void	readTrack(DataSource.Chunk chunk) Called to read contents for the current track type.
protected void	release()
void	releaseTrack(TrackType type) Called to release resources for a given track.
void	rewind() Rewinds this source, moving it to its default state.
long	seekTo(long desiredTimestampUs) Moves all selected tracks to the specified presentation time.
void	selectTrack(TrackType type) Called before starting, but after DataSource.getTrackFormat(TrackType), to select the given track.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultDataSource

public DefaultDataSource()

Method Detail

applyExtractor

protected abstract void applyExtractor(@NonNull
                                       android.media.MediaExtractor extractor)
                                throws java.io.IOException

Throws:

java.io.IOException

applyRetriever

protected abstract void applyRetriever(@NonNull
                                       android.media.MediaMetadataRetriever retriever)

selectTrack

public void selectTrack(@NonNull
                        TrackType type)

Description copied from interface: DataSource

Called before starting, but after DataSource.getTrackFormat(TrackType), to select the given track.

Specified by:

selectTrack in interface DataSource

Parameters:

type - track type

seekTo

public long seekTo(long desiredTimestampUs)

Description copied from interface: DataSource

Moves all selected tracks to the specified presentation time. The timestamp should be between 0 and DataSource.getDurationUs(). The actual timestamp might differ from the desired one because of seeking constraints (e.g. seek to sync frames).

Specified by:

seekTo in interface DataSource

Parameters:

desiredTimestampUs - requested timestamp

Returns:

actual timestamp

isDrained

public boolean isDrained()

Description copied from interface: DataSource

When this source has been totally read, it can return true here to notify an end of input stream.

Specified by:

isDrained in interface DataSource

Returns:

true if drained

canReadTrack

public boolean canReadTrack(@NonNull
                            TrackType type)

Description copied from interface: DataSource

Returns true if we can read the given track at this point. If true if returned, source should expect a DataSource.readTrack(Chunk) call.

Specified by:

canReadTrack in interface DataSource

Parameters:

type - track type

Returns:

true if we can read this track now

readTrack

public void readTrack(@NonNull
                      DataSource.Chunk chunk)

Description copied from interface: DataSource

Called to read contents for the current track type. Contents should be put inside DataSource.Chunk.buffer, and the other chunk flags should be filled.

Specified by:

readTrack in interface DataSource

Parameters:

chunk - output chunk

getReadUs

public long getReadUs()

Description copied from interface: DataSource

Returns the total number of microseconds that have been read until now.

Specified by:

getReadUs in interface DataSource

Returns:

total read us

getLocation

@Nullable
public double[] getLocation()

Description copied from interface: DataSource

Metadata information. Returns the video location, or null.

Specified by:

getLocation in interface DataSource

Returns:

video location or null

getOrientation

public int getOrientation()

Description copied from interface: DataSource

Metadata information. Returns the video orientation, or 0.

Specified by:

getOrientation in interface DataSource

Returns:

video metadata orientation

getDurationUs

public long getDurationUs()

Description copied from interface: DataSource

Returns the video total duration in microseconds.

Specified by:

getDurationUs in interface DataSource

Returns:

duration in us

getTrackFormat

@Nullable
public android.media.MediaFormat getTrackFormat(@NonNull
                                                          TrackType type)

Description copied from interface: DataSource

Called before starting to inspect the input format for this track. Can return null if this media does not include this track type.

Specified by:

getTrackFormat in interface DataSource

Parameters:

type - track type

Returns:

format or null

releaseTrack

public void releaseTrack(@NonNull
                         TrackType type)

Description copied from interface: DataSource

Called to release resources for a given track.

Specified by:

releaseTrack in interface DataSource

Parameters:

type - track type

release

protected void release()

rewind

public void rewind()

Description copied from interface: DataSource

Rewinds this source, moving it to its default state. To be used again, tracks will be selected again. After this call, for instance, - DataSource.getReadUs() should be 0 - DataSource.isDrained() should be false - DataSource.readTrack(Chunk) should return the very first bytes

Specified by:

rewind in interface DataSource