com.google.android.exoplayer2.source

Interface MediaSource

All Known Implementing Classes:

ClippingMediaSource, ConcatenatingMediaSource, ExtractorMediaSource, LoopingMediaSource, MergingMediaSource, SingleSampleMediaSource

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.

Method Summary

Modifier and Type	Method and Description
MediaPeriod	createPeriod(int index, Allocator allocator, long positionUs) Returns a new MediaPeriod corresponding to the period at the specified index.
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 java.io.IOException

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

Throws:

java.io.IOException

createPeriod

MediaPeriod createPeriod(int index,
                         Allocator allocator,
                         long positionUs)

Returns a new MediaPeriod corresponding to the period at the specified index. This method may be called multiple times with the same index without an intervening call to releasePeriod(MediaPeriod).

Parameters:

index - The index of the period.

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

positionUs - The player's current playback position.

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.