com.google.android.exoplayer2.source

Class SingleSampleMediaSource

java.lang.Object

com.google.android.exoplayer2.source.BaseMediaSource

com.google.android.exoplayer2.source.SingleSampleMediaSource

All Implemented Interfaces:

MediaSource

public final class SingleSampleMediaSource
extends BaseMediaSource

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 Deprecated. Use MediaSourceEventListener.
static class	SingleSampleMediaSource.Factory Factory for SingleSampleMediaSource.

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

MediaSource.MediaPeriodId, MediaSource.SourceInfoRefreshListener

Constructor Summary

Constructors

Constructor and Description
SingleSampleMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, Format format, long durationUs) Deprecated. Use SingleSampleMediaSource.Factory instead.
SingleSampleMediaSource(android.net.Uri uri, DataSource.Factory dataSourceFactory, Format format, long durationUs, int minLoadableRetryCount) Deprecated. Use SingleSampleMediaSource.Factory instead.
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) Deprecated. Use SingleSampleMediaSource.Factory instead.

Method Summary

Modifier and Type	Method and Description
MediaPeriod	createPeriod(MediaSource.MediaPeriodId id, Allocator allocator, long startPositionUs) Returns a new MediaPeriod identified by periodId.
java.lang.Object	getTag() Returns the tag set on the media source, or null if none was set.
void	maybeThrowSourceInfoRefreshError() Throws any pending error encountered while loading or refreshing source information.
void	prepareSourceInternal(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, refreshSourceInfo, releaseSource, removeEventListener

Methods inherited from class java.lang.Object

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

Constructor Detail

SingleSampleMediaSource

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

Deprecated. Use SingleSampleMediaSource.Factory instead.

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

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

Deprecated. Use SingleSampleMediaSource.Factory instead.

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

@Deprecated
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)

Deprecated. Use SingleSampleMediaSource.Factory instead.

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

getTag

@Nullable
public java.lang.Object getTag()

Description copied from interface: MediaSource

Returns the tag set on the media source, or null if none was set.

prepareSourceInternal

public void prepareSourceInternal(@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:

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.

Throws:

java.io.IOException

createPeriod

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

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.

Parameters:

id - The identifier of the period.

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

startPositionUs - The expected start position, in microseconds.

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.

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(TransferListener).

Specified by:

releaseSourceInternal in class BaseMediaSource