com.google.android.exoplayer2.source

Class CompositeMediaSource<T>

java.lang.Object

com.google.android.exoplayer2.source.BaseMediaSource

com.google.android.exoplayer2.source.CompositeMediaSource<T>

Type Parameters:

T - The type of the id used to identify prepared child sources.

All Implemented Interfaces:

MediaSource

Direct Known Subclasses:

AdsMediaSource, ClippingMediaSource, ConcatenatingMediaSource, LoopingMediaSource, MergingMediaSource

public abstract class CompositeMediaSource<T>
extends BaseMediaSource

Composite MediaSource consisting of multiple child sources.

Nested Class Summary

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

MediaSource.MediaPeriodId, MediaSource.SourceInfoRefreshListener

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CompositeMediaSource() Create composite media source without child sources.

Method Summary

Modifier and Type	Method and Description
protected MediaSource.MediaPeriodId	getMediaPeriodIdForChildMediaPeriodId(T id, MediaSource.MediaPeriodId mediaPeriodId) Returns the MediaPeriodId in the composite source corresponding to the specified MediaPeriodId in a child source.
protected long	getMediaTimeForChildMediaTime(T id, long mediaTimeMs) Returns the media time in the composite source corresponding to the specified media time in a child source.
protected int	getWindowIndexForChildWindowIndex(T id, int windowIndex) Returns the window index in the composite source corresponding to the specified window index in a child source.
void	maybeThrowSourceInfoRefreshError() Throws any pending error encountered while loading or refreshing source information.
protected abstract void	onChildSourceInfoRefreshed(T id, MediaSource mediaSource, Timeline timeline, java.lang.Object manifest) Called when the source info of a child source has been refreshed.
protected void	prepareChildSource(T id, MediaSource mediaSource) Prepares a child source.
void	prepareSourceInternal(ExoPlayer player, boolean isTopLevelSource) Starts source preparation.
protected void	releaseChildSource(T id) Releases a child source.
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

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

createPeriod, releasePeriod

Constructor Detail

CompositeMediaSource

protected CompositeMediaSource()

Create composite media source without child sources.

Method Detail

prepareSourceInternal

@CallSuper
public void prepareSourceInternal(ExoPlayer player,
                                             boolean isTopLevelSource)

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:

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

maybeThrowSourceInfoRefreshError

@CallSuper
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

releaseSourceInternal

@CallSuper
public void releaseSourceInternal()

Description copied from class: BaseMediaSource

Releases the source. This method is called exactly once after each call to BaseMediaSource.prepareSourceInternal(ExoPlayer, boolean).

Specified by:

releaseSourceInternal in class BaseMediaSource

onChildSourceInfoRefreshed

protected abstract void onChildSourceInfoRefreshed(@Nullable
                                                   T id,
                                                   MediaSource mediaSource,
                                                   Timeline timeline,
                                                   @Nullable
                                                   java.lang.Object manifest)

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

Parameters:

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

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

timeline - The timeline of the child source.

manifest - The manifest of the child source.

prepareChildSource

protected final void prepareChildSource(@Nullable
                                        T id,
                                        MediaSource mediaSource)

Prepares a child source.

onChildSourceInfoRefreshed(Object, MediaSource, Timeline, Object) will be called when the child source updates its timeline and/or manifest with the same id passed to this method.

Any child sources that aren't explicitly released with releaseChildSource(Object) will be released in releaseSourceInternal().

Parameters:

id - A unique id to identify the child source preparation. Null is allowed as an id.

mediaSource - The child MediaSource.

releaseChildSource

protected final void releaseChildSource(@Nullable
                                        T id)

Releases a child source.

Parameters:

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

getWindowIndexForChildWindowIndex

protected int getWindowIndexForChildWindowIndex(@Nullable
                                                T id,
                                                int windowIndex)

Returns the window index in the composite source corresponding to the specified window index in a child source. The default implementation does not change the window index.

Parameters:

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

windowIndex - A window index of the child source.

Returns:

The corresponding window index in the composite source.

getMediaPeriodIdForChildMediaPeriodId

@Nullable
protected MediaSource.MediaPeriodId getMediaPeriodIdForChildMediaPeriodId(@Nullable
                                                                                    T id,
                                                                                    MediaSource.MediaPeriodId mediaPeriodId)

Returns the MediaPeriodId in the composite source corresponding to the specified MediaPeriodId in a child source. The default implementation does not change the media period id.

Parameters:

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

mediaPeriodId - A MediaPeriodId of the child source.

Returns:

The corresponding MediaPeriodId in the composite source. Null if no corresponding media period id can be determined.

getMediaTimeForChildMediaTime

protected long getMediaTimeForChildMediaTime(@Nullable
                                             T id,
                                             long mediaTimeMs)

Returns the media time in the composite source corresponding to the specified media time in a child source. The default implementation does not change the media time.

Parameters:

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

mediaTimeMs - A media time of the child source, in milliseconds.

Returns:

The corresponding media time in the composite source, in milliseconds.