com.google.android.exoplayer2.source

Class ExtractorMediaSource

java.lang.Object

com.google.android.exoplayer2.source.BaseMediaSource

com.google.android.exoplayer2.source.ExtractorMediaSource

All Implemented Interfaces:

MediaSource

public final class ExtractorMediaSource
extends BaseMediaSource

Provides one period that loads data from a Uri and extracted using an Extractor.

If the possible input stream container formats are known, pass a factory that instantiates extractors for them to the constructor. Otherwise, pass a DefaultExtractorsFactory to use the default extractors. When reading a new stream, the first Extractor in the array of extractors created by the factory that returns true from Extractor.sniff(com.google.android.exoplayer2.extractor.ExtractorInput) will be used to extract samples from the input stream.

Note that the built-in extractors for AAC, MPEG PS/TS and FLV streams do not support seeking.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ExtractorMediaSource.EventListener Deprecated. Use MediaSourceEventListener.
static class	ExtractorMediaSource.Factory Factory for ExtractorMediaSources.

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.source.MediaSource

MediaSource.MediaPeriodId, MediaSource.SourceInfoRefreshListener

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_LOADING_CHECK_INTERVAL_BYTES The default number of bytes that should be loaded between each each invocation of SequenceableLoader.Callback.onContinueLoadingRequested(SequenceableLoader).

Constructor Summary

Constructors

Constructor and Description
ExtractorMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, ExtractorsFactory extractorsFactory, android.os.Handler eventHandler, ExtractorMediaSource.EventListener eventListener) Deprecated. Use ExtractorMediaSource.Factory instead.
ExtractorMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, ExtractorsFactory extractorsFactory, android.os.Handler eventHandler, ExtractorMediaSource.EventListener eventListener, java.lang.String customCacheKey) Deprecated. Use ExtractorMediaSource.Factory instead.
ExtractorMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, ExtractorsFactory extractorsFactory, android.os.Handler eventHandler, ExtractorMediaSource.EventListener eventListener, java.lang.String customCacheKey, int continueLoadingCheckIntervalBytes) Deprecated. Use ExtractorMediaSource.Factory instead.

Method Summary

Modifier and Type	Method and Description
MediaPeriod	createPeriod(MediaSource.MediaPeriodId id, Allocator allocator) Returns a new MediaPeriod identified by periodId.
void	maybeThrowSourceInfoRefreshError() Throws any pending error encountered while loading or refreshing source information.
void	onSourceInfoRefreshed(long durationUs, boolean isSeekable) Called when the duration or ability to seek within the period changes.
void	prepareSourceInternal(ExoPlayer player, boolean isTopLevelSource, TransferListener mediaTransferListener) Starts source preparation.
void	releasePeriod(MediaPeriod mediaPeriod) Releases the period.
void	releaseSourceInternal() Releases the source.

Methods inherited from class com.google.android.exoplayer2.source.BaseMediaSource

addEventListener, createEventDispatcher, createEventDispatcher, createEventDispatcher, prepareSource, prepareSource, refreshSourceInfo, releaseSource, removeEventListener

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LOADING_CHECK_INTERVAL_BYTES

public static final int DEFAULT_LOADING_CHECK_INTERVAL_BYTES

The default number of bytes that should be loaded between each each invocation of SequenceableLoader.Callback.onContinueLoadingRequested(SequenceableLoader).

See Also:

Constant Field Values

Constructor Detail

ExtractorMediaSource

@Deprecated
public ExtractorMediaSource(android.net.Uri uri,
                                        DataSource.Factory dataSourceFactory,
                                        ExtractorsFactory extractorsFactory,
                                        android.os.Handler eventHandler,
                                        ExtractorMediaSource.EventListener eventListener)

Deprecated. Use ExtractorMediaSource.Factory instead.

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - A factory for DataSources to read the media.

extractorsFactory - A factory for Extractors to process the media stream. If the possible formats are known, pass a factory that instantiates extractors for those formats. Otherwise, pass a DefaultExtractorsFactory to use default extractors.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

ExtractorMediaSource

@Deprecated
public ExtractorMediaSource(android.net.Uri uri,
                                        DataSource.Factory dataSourceFactory,
                                        ExtractorsFactory extractorsFactory,
                                        android.os.Handler eventHandler,
                                        ExtractorMediaSource.EventListener eventListener,
                                        java.lang.String customCacheKey)

Deprecated. Use ExtractorMediaSource.Factory instead.

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - A factory for DataSources to read the media.

extractorsFactory - A factory for Extractors to process the media stream. If the possible formats are known, pass a factory that instantiates extractors for those formats. Otherwise, pass a DefaultExtractorsFactory to use default extractors.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

customCacheKey - A custom key that uniquely identifies the original stream. Used for cache indexing. May be null.

ExtractorMediaSource

@Deprecated
public ExtractorMediaSource(android.net.Uri uri,
                                        DataSource.Factory dataSourceFactory,
                                        ExtractorsFactory extractorsFactory,
                                        android.os.Handler eventHandler,
                                        ExtractorMediaSource.EventListener eventListener,
                                        java.lang.String customCacheKey,
                                        int continueLoadingCheckIntervalBytes)

Deprecated. Use ExtractorMediaSource.Factory instead.

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - A factory for DataSources to read the media.

extractorsFactory - A factory for Extractors to process the media stream. If the possible formats are known, pass a factory that instantiates extractors for those formats. Otherwise, pass a DefaultExtractorsFactory to use default extractors.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

customCacheKey - A custom key that uniquely identifies the original stream. Used for cache indexing. May be null.

continueLoadingCheckIntervalBytes - The number of bytes that should be loaded between each invocation of SequenceableLoader.Callback.onContinueLoadingRequested(SequenceableLoader).

Method Detail

prepareSourceInternal

public void prepareSourceInternal(ExoPlayer player,
                                  boolean isTopLevelSource,
                                  @Nullable
                                  TransferListener mediaTransferListener)

Description copied from class: BaseMediaSource

Starts source preparation. This method is called at most once until the next call to BaseMediaSource.releaseSourceInternal().

Specified by:

prepareSourceInternal in class BaseMediaSource

Parameters:

player - The player for which this source is being prepared.

isTopLevelSource - Whether this source has been passed directly to ExoPlayer.prepare(MediaSource) or ExoPlayer.prepare(MediaSource, boolean, boolean).

mediaTransferListener - The transfer listener which should be informed of any media data transfers. May be null if no listener is available. Note that this listener should usually be only informed of transfers related to the media loads and not of auxiliary loads for manifests and other data.

maybeThrowSourceInfoRefreshError

public void maybeThrowSourceInfoRefreshError()
                                      throws java.io.IOException

Description copied from interface: MediaSource

Throws any pending error encountered while loading or refreshing source information.

Should not be called directly from application code.

Specified by:

maybeThrowSourceInfoRefreshError in interface MediaSource

Throws:

java.io.IOException

createPeriod

public MediaPeriod createPeriod(MediaSource.MediaPeriodId id,
                                Allocator allocator)

Description copied from interface: MediaSource

Returns a new MediaPeriod identified by periodId. This method may be called multiple times without an intervening call to MediaSource.releasePeriod(MediaPeriod).

Should not be called directly from application code.

Specified by:

createPeriod in interface MediaSource

Parameters:

id - The identifier of the period.

allocator - An Allocator from which to obtain media buffer allocations.

Returns:

A new MediaPeriod.

releasePeriod

public void releasePeriod(MediaPeriod mediaPeriod)

Description copied from interface: MediaSource

Releases the period.

Should not be called directly from application code.

Specified by:

releasePeriod in interface MediaSource

Parameters:

mediaPeriod - The period to release.

releaseSourceInternal

public void releaseSourceInternal()

Description copied from class: BaseMediaSource

Releases the source. This method is called exactly once after each call to BaseMediaSource.prepareSourceInternal(ExoPlayer, boolean, TransferListener).

Specified by:

releaseSourceInternal in class BaseMediaSource

onSourceInfoRefreshed

public void onSourceInfoRefreshed(long durationUs,
                                  boolean isSeekable)

Called when the duration or ability to seek within the period changes.

Parameters:

durationUs - The duration of the period, or C.TIME_UNSET.

isSeekable - Whether the period is seekable.