com.google.android.exoplayer2.source

Class SingleSampleMediaSource

java.lang.Object

com.google.android.exoplayer2.source.SingleSampleMediaSource

All Implemented Interfaces:

MediaSource

public final class SingleSampleMediaSource
extends java.lang.Object
implements MediaSource

Loads data at a given Uri as a single sample belonging to a single MediaPeriod.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SingleSampleMediaSource.EventListener Listener of SingleSampleMediaSource events.

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

MediaSource.Listener, MediaSource.MediaPeriodId

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MIN_LOADABLE_RETRY_COUNT The default minimum number of times to retry loading data prior to failing.

Constructor Summary

Constructors

Constructor and Description
SingleSampleMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, Format format, long durationUs)
SingleSampleMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, Format format, long durationUs, int minLoadableRetryCount)
SingleSampleMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, Format format, long durationUs, int minLoadableRetryCount, android.os.Handler eventHandler, SingleSampleMediaSource.EventListener eventListener, int eventSourceId, boolean treatLoadErrorsAsEndOfStream)

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	prepareSource(ExoPlayer player, boolean isTopLevelSource, MediaSource.Listener listener) Starts preparation of the source.
void	releasePeriod(MediaPeriod mediaPeriod) Releases the period.
void	releaseSource() Releases the source.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MIN_LOADABLE_RETRY_COUNT

public static final int DEFAULT_MIN_LOADABLE_RETRY_COUNT

The default minimum number of times to retry loading data prior to failing.

See Also:

Constant Field Values

Constructor Detail

SingleSampleMediaSource

public SingleSampleMediaSource(android.net.Uri uri,
                               DataSource.Factory dataSourceFactory,
                               Format format,
                               long durationUs)

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - The factory from which the DataSource to read the media will be obtained.

format - The Format associated with the output track.

durationUs - The duration of the media stream in microseconds.

SingleSampleMediaSource

public SingleSampleMediaSource(android.net.Uri uri,
                               DataSource.Factory dataSourceFactory,
                               Format format,
                               long durationUs,
                               int minLoadableRetryCount)

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - The factory from which the DataSource to read the media will be obtained.

format - The Format associated with the output track.

durationUs - The duration of the media stream in microseconds.

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

SingleSampleMediaSource

public SingleSampleMediaSource(android.net.Uri uri,
                               DataSource.Factory dataSourceFactory,
                               Format format,
                               long durationUs,
                               int minLoadableRetryCount,
                               android.os.Handler eventHandler,
                               SingleSampleMediaSource.EventListener eventListener,
                               int eventSourceId,
                               boolean treatLoadErrorsAsEndOfStream)

Parameters:

uri - The Uri of the media stream.

dataSourceFactory - The factory from which the DataSource to read the media will be obtained.

format - The Format associated with the output track.

durationUs - The duration of the media stream in microseconds.

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

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.

eventSourceId - An identifier that gets passed to eventListener methods.

treatLoadErrorsAsEndOfStream - If true, load errors will not be propagated by sample streams, treating them as ended instead. If false, load errors will be propagated normally by SampleStream.maybeThrowError().

Method Detail

prepareSource

public void prepareSource(ExoPlayer player,
                          boolean isTopLevelSource,
                          MediaSource.Listener listener)

Description copied from interface: MediaSource

Starts preparation of the source.

Specified by:

prepareSource in interface MediaSource

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). If false, this source is being prepared by another source (e.g. ConcatenatingMediaSource) for composition.

listener - The listener for source events.

maybeThrowSourceInfoRefreshError

public void maybeThrowSourceInfoRefreshError()
                                      throws java.io.IOException

Description copied from interface: MediaSource

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

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 with the same period identifier without an intervening call to MediaSource.releasePeriod(MediaPeriod).

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.

Specified by:

releasePeriod in interface MediaSource

Parameters:

mediaPeriod - The period to release.

releaseSource

public void releaseSource()

Description copied from interface: MediaSource

Releases the source.

This method should be called when the source is no longer required. It may be called in any state.

Specified by:

releaseSource in interface MediaSource