com.google.android.exoplayer2.source

Class LoopingMediaSource

java.lang.Object

com.google.android.exoplayer2.source.BaseMediaSource

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

com.google.android.exoplayer2.source.LoopingMediaSource

All Implemented Interfaces:

MediaSource

public final class LoopingMediaSource
extends CompositeMediaSource<java.lang.Void>

Loops a MediaSource a specified number of times.

Note: To loop a MediaSource indefinitely, it is usually better to use Player.setRepeatMode(int) instead of this class.

Nested Class Summary

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

MediaSource.MediaPeriodId, MediaSource.SourceInfoRefreshListener

Constructor Summary

Constructors

Constructor and Description
LoopingMediaSource(MediaSource childSource) Loops the provided source indefinitely.
LoopingMediaSource(MediaSource childSource, int loopCount) Loops the provided source a specified number of times.

Method Summary

Modifier and Type	Method and Description
MediaPeriod	createPeriod(MediaSource.MediaPeriodId id, Allocator allocator, long startPositionUs) Returns a new MediaPeriod identified by periodId.
protected MediaSource.MediaPeriodId	getMediaPeriodIdForChildMediaPeriodId(java.lang.Void id, MediaSource.MediaPeriodId mediaPeriodId) Returns the MediaPeriodId in the composite source corresponding to the specified MediaPeriodId in a child source.
java.lang.Object	getTag() Returns the tag set on the media source, or null if none was set.
protected void	onChildSourceInfoRefreshed(java.lang.Void id, MediaSource mediaSource, Timeline timeline, java.lang.Object manifest) Called when the source info of a child source has been refreshed.
void	prepareSourceInternal(TransferListener mediaTransferListener) Starts source preparation.
void	releasePeriod(MediaPeriod mediaPeriod) Releases the period.

Methods inherited from class com.google.android.exoplayer2.source.CompositeMediaSource

getMediaTimeForChildMediaTime, getWindowIndexForChildWindowIndex, maybeThrowSourceInfoRefreshError, prepareChildSource, releaseChildSource, releaseSourceInternal

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

Constructor Detail

LoopingMediaSource

public LoopingMediaSource(MediaSource childSource)

Loops the provided source indefinitely. Note that it is usually better to use Player.setRepeatMode(int).

Parameters:

childSource - The MediaSource to loop.

LoopingMediaSource

public LoopingMediaSource(MediaSource childSource,
                          int loopCount)

Loops the provided source a specified number of times.

Parameters:

childSource - The MediaSource to loop.

loopCount - The desired number of loops. Must be strictly positive.

Method Detail

getTag

@Nullable
public java.lang.Object getTag()

Description copied from interface: MediaSource

Returns the tag set on the media source, or null if none was set.

prepareSourceInternal

public void prepareSourceInternal(@Nullable
                                  TransferListener mediaTransferListener)

Description copied from class: BaseMediaSource

Starts source preparation. This method is called at most once until the next call to BaseMediaSource.releaseSourceInternal().

Overrides:

prepareSourceInternal in class CompositeMediaSource<java.lang.Void>

Parameters:

mediaTransferListener - The transfer listener which should be informed of any media data transfers. May be null if no listener is available. Note that this listener should usually be only informed of transfers related to the media loads and not of auxiliary loads for manifests and other data.

createPeriod

public MediaPeriod createPeriod(MediaSource.MediaPeriodId id,
                                Allocator allocator,
                                long startPositionUs)

Description copied from interface: MediaSource

Returns a new MediaPeriod identified by periodId. This method may be called multiple times 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.

startPositionUs - The expected start position, in microseconds.

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.

onChildSourceInfoRefreshed

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

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

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.

getMediaPeriodIdForChildMediaPeriodId

@Nullable
protected MediaSource.MediaPeriodId getMediaPeriodIdForChildMediaPeriodId(java.lang.Void id,
                                                                                    MediaSource.MediaPeriodId mediaPeriodId)

Description copied from class: CompositeMediaSource

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.

Overrides:

getMediaPeriodIdForChildMediaPeriodId in class CompositeMediaSource<java.lang.Void>

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.