com.google.android.exoplayer2.source

Class CompositeMediaSource<T>

java.lang.Object

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, DynamicConcatenatingMediaSource, LoopingMediaSource, MergingMediaSource

public abstract class CompositeMediaSource<T>
extends java.lang.Object
implements MediaSource

Composite MediaSource consisting of multiple child sources.

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

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

Method Summary

Modifier and Type	Method and Description
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	prepareSource(ExoPlayer player, boolean isTopLevelSource, MediaSource.Listener listener) Starts preparation of the source.
protected void	releaseChildSource(T id) Releases a child source.
void	releaseSource() Releases the source.

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

prepareSource

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

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

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

Specified by:

maybeThrowSourceInfoRefreshError in interface MediaSource

Throws:

java.io.IOException

releaseSource

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

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

Parameters:

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

mediaSource - The child MediaSource.

releaseChildSource

protected void releaseChildSource(@Nullable
                                  T id)

Releases a child source.

Parameters:

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