com.google.android.exoplayer2.source

Class ConcatenatingMediaSource

java.lang.Object

com.google.android.exoplayer2.source.CompositeMediaSource<java.lang.Integer>

com.google.android.exoplayer2.source.ConcatenatingMediaSource

All Implemented Interfaces:

MediaSource

public final class ConcatenatingMediaSource
extends CompositeMediaSource<java.lang.Integer>

Concatenates multiple MediaSources. It is valid for the same MediaSource instance to be present more than once in the concatenation.

Nested Class Summary

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

MediaSource.Listener, MediaSource.MediaPeriodId

Field Summary

Fields inherited from interface com.google.android.exoplayer2.source.MediaSource

MEDIA_SOURCE_REUSED_ERROR_MESSAGE

Constructor Summary

Constructors

Constructor and Description
ConcatenatingMediaSource(boolean isAtomic, MediaSource... mediaSources)
ConcatenatingMediaSource(boolean isAtomic, ShuffleOrder shuffleOrder, MediaSource... mediaSources)
ConcatenatingMediaSource(MediaSource... mediaSources)

Method Summary

Modifier and Type	Method and Description
MediaPeriod	createPeriod(MediaSource.MediaPeriodId id, Allocator allocator) Returns a new MediaPeriod identified by periodId.
protected void	onChildSourceInfoRefreshed(java.lang.Integer sourceFirstIndex, MediaSource mediaSource, Timeline sourceTimeline, java.lang.Object sourceManifest) Called when the source info of a child source has been refreshed.
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 com.google.android.exoplayer2.source.CompositeMediaSource

maybeThrowSourceInfoRefreshError, prepareChildSource, releaseChildSource

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcatenatingMediaSource

public ConcatenatingMediaSource(MediaSource... mediaSources)

Parameters:

mediaSources - The MediaSources to concatenate. It is valid for the same MediaSource instance to be present more than once in the array.

ConcatenatingMediaSource

public ConcatenatingMediaSource(boolean isAtomic,
                                MediaSource... mediaSources)

Parameters:

isAtomic - Whether the concatenated media source shall be treated as atomic, i.e., treated as a single item for repeating and shuffling.

mediaSources - The MediaSources to concatenate. It is valid for the same MediaSource instance to be present more than once in the array.

ConcatenatingMediaSource

public ConcatenatingMediaSource(boolean isAtomic,
                                ShuffleOrder shuffleOrder,
                                MediaSource... mediaSources)

Parameters:

isAtomic - Whether the concatenated media source shall be treated as atomic, i.e., treated as a single item for repeating and shuffling.

shuffleOrder - The ShuffleOrder to use when shuffling the child media sources. The number of elements in the shuffle order must match the number of concatenated MediaSources.

mediaSources - The MediaSources to concatenate. It is valid for the same MediaSource instance to be present more than once in the array.

Method Detail

prepareSource

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

Description copied from interface: MediaSource

Starts preparation of the source.

Should not be called directly from application code.

Specified by:

prepareSource in interface MediaSource

Overrides:

prepareSource in class CompositeMediaSource<java.lang.Integer>

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.

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

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.

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.

releaseSource

public void releaseSource()

Description copied from interface: MediaSource

Releases the source.

Should not be called directly from application code.

Specified by:

releaseSource in interface MediaSource

Overrides:

releaseSource in class CompositeMediaSource<java.lang.Integer>

onChildSourceInfoRefreshed

protected void onChildSourceInfoRefreshed(java.lang.Integer sourceFirstIndex,
                                          MediaSource mediaSource,
                                          Timeline sourceTimeline,
                                          @Nullable
                                          java.lang.Object sourceManifest)

Description copied from class: CompositeMediaSource

Called when the source info of a child source has been refreshed.

Specified by:

onChildSourceInfoRefreshed in class CompositeMediaSource<java.lang.Integer>

Parameters:

sourceFirstIndex - The unique id used to prepare the child source.

mediaSource - The child source whose source info has been refreshed.

sourceTimeline - The timeline of the child source.

sourceManifest - The manifest of the child source.