com.google.android.exoplayer2.source

Interface MediaSource

All Known Implementing Classes:

ClippingMediaSource, ConcatenatingMediaSource, DashMediaSource, DynamicConcatenatingMediaSource, ExtractorMediaSource, HlsMediaSource, ImaAdsMediaSource, LoopingMediaSource, MergingMediaSource, SingleSampleMediaSource, SsMediaSource

public interface MediaSource

A source of media consisting of one or more MediaPeriods.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	MediaSource.Listener Listener for source events.
static class	MediaSource.MediaPeriodId Identifier for a MediaPeriod.

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.

Method Detail

prepareSource

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

Starts preparation of the source.

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

void maybeThrowSourceInfoRefreshError()
                               throws IOException

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

Throws:

IOException

createPeriod

MediaPeriod createPeriod(MediaSource.MediaPeriodId id,
                         Allocator allocator)

Returns a new MediaPeriod identified by periodId. This method may be called multiple times with the same period identifier without an intervening call to releasePeriod(MediaPeriod).

Parameters:

id - The identifier of the period.

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

Returns:

A new MediaPeriod.

releasePeriod

void releasePeriod(MediaPeriod mediaPeriod)

Releases the period.

Parameters:

mediaPeriod - The period to release.

releaseSource

void releaseSource()

Releases the source.

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