com.google.android.exoplayer2.source.dash

Class DashMediaSource

java.lang.Object

com.google.android.exoplayer2.source.BaseMediaSource

com.google.android.exoplayer2.source.dash.DashMediaSource

All Implemented Interfaces:

com.google.android.exoplayer2.source.MediaSource

public final class DashMediaSource
extends com.google.android.exoplayer2.source.BaseMediaSource

A DASH MediaSource.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DashMediaSource.Factory Factory for DashMediaSources.

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

com.google.android.exoplayer2.source.MediaSource.MediaPeriodId, com.google.android.exoplayer2.source.MediaSource.SourceInfoRefreshListener

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS A fixed default presentation delay for live streams.
static long	DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS A constant indicating that the presentation delay for live streams should be set to DashManifest.suggestedPresentationDelayMs if specified by the manifest, or DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS otherwise.
static int	DEFAULT_MIN_LOADABLE_RETRY_COUNT The default minimum number of times to retry loading data prior to failing.

Constructor Summary

Constructors

Constructor and Description
DashMediaSource(DashManifest manifest, DashChunkSource.Factory chunkSourceFactory, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use DashMediaSource.Factory instead.
DashMediaSource(DashManifest manifest, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use DashMediaSource.Factory instead.
DashMediaSource(android.net.Uri manifestUri, com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory, DashChunkSource.Factory chunkSourceFactory, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use DashMediaSource.Factory instead.
DashMediaSource(android.net.Uri manifestUri, com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, long livePresentationDelayMs, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use DashMediaSource.Factory instead.
DashMediaSource(android.net.Uri manifestUri, com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory, com.google.android.exoplayer2.upstream.ParsingLoadable.Parser<? extends DashManifest> manifestParser, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, long livePresentationDelayMs, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use DashMediaSource.Factory instead.

Method Summary

Modifier and Type	Method and Description
com.google.android.exoplayer2.source.MediaPeriod	createPeriod(com.google.android.exoplayer2.source.MediaSource.MediaPeriodId periodId, com.google.android.exoplayer2.upstream.Allocator allocator)
void	maybeThrowSourceInfoRefreshError()
void	prepareSourceInternal(com.google.android.exoplayer2.ExoPlayer player, boolean isTopLevelSource)
void	releasePeriod(com.google.android.exoplayer2.source.MediaPeriod mediaPeriod)
void	releaseSourceInternal()
void	replaceManifestUri(android.net.Uri manifestUri) Manually replaces the manifest Uri.

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

Field Detail

DEFAULT_MIN_LOADABLE_RETRY_COUNT

public static final int DEFAULT_MIN_LOADABLE_RETRY_COUNT

The default minimum number of times to retry loading data prior to failing.

See Also:

Constant Field Values

DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS

public static final long DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS

A constant indicating that the presentation delay for live streams should be set to DashManifest.suggestedPresentationDelayMs if specified by the manifest, or DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS otherwise. The presentation delay is the duration by which the default start position precedes the end of the live window.

See Also:

Constant Field Values

DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS

public static final long DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS

A fixed default presentation delay for live streams. The presentation delay is the duration by which the default start position precedes the end of the live window.

See Also:

Constant Field Values

Constructor Detail

DashMediaSource

@Deprecated
public DashMediaSource(DashManifest manifest,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   android.os.Handler eventHandler,
                                   com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use DashMediaSource.Factory instead.

Constructs an instance to play a given DashManifest, which must be static.

Parameters:

manifest - The manifest. DashManifest.dynamic must be false.

chunkSourceFactory - A factory for DashChunkSource instances.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

DashMediaSource

@Deprecated
public DashMediaSource(DashManifest manifest,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   android.os.Handler eventHandler,
                                   com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use DashMediaSource.Factory instead.

Constructs an instance to play a given DashManifest, which must be static.

Parameters:

manifest - The manifest. DashManifest.dynamic must be false.

chunkSourceFactory - A factory for DashChunkSource instances.

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

DashMediaSource

@Deprecated
public DashMediaSource(android.net.Uri manifestUri,
                                   com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   android.os.Handler eventHandler,
                                   com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use DashMediaSource.Factory instead.

Constructs an instance to play the manifest at a given Uri, which may be dynamic or static.

Parameters:

manifestUri - The manifest Uri.

manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

chunkSourceFactory - A factory for DashChunkSource instances.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

DashMediaSource

@Deprecated
public DashMediaSource(android.net.Uri manifestUri,
                                   com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   android.os.Handler eventHandler,
                                   com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use DashMediaSource.Factory instead.

Constructs an instance to play the manifest at a given Uri, which may be dynamic or static.

Parameters:

manifestUri - The manifest Uri.

manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

chunkSourceFactory - A factory for DashChunkSource instances.

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

livePresentationDelayMs - For live playbacks, the duration in milliseconds by which the default start position should precede the end of the live window. Use DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS to use the value specified by the manifest, if present.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

DashMediaSource

@Deprecated
public DashMediaSource(android.net.Uri manifestUri,
                                   com.google.android.exoplayer2.upstream.DataSource.Factory manifestDataSourceFactory,
                                   com.google.android.exoplayer2.upstream.ParsingLoadable.Parser<? extends DashManifest> manifestParser,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   android.os.Handler eventHandler,
                                   com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use DashMediaSource.Factory instead.

Constructs an instance to play the manifest at a given Uri, which may be dynamic or static.

Parameters:

manifestUri - The manifest Uri.

manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest.

manifestParser - A parser for loaded manifest data.

chunkSourceFactory - A factory for DashChunkSource instances.

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

livePresentationDelayMs - For live playbacks, the duration in milliseconds by which the default start position should precede the end of the live window. Use DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS to use the value specified by the manifest, if present.

eventHandler - A handler for events. May be null if delivery of events is not required.

eventListener - A listener of events. May be null if delivery of events is not required.

Method Detail

replaceManifestUri

public void replaceManifestUri(android.net.Uri manifestUri)

Manually replaces the manifest Uri.

Parameters:

manifestUri - The replacement manifest Uri.

prepareSourceInternal

public void prepareSourceInternal(com.google.android.exoplayer2.ExoPlayer player,
                                  boolean isTopLevelSource)

Specified by:

prepareSourceInternal in class com.google.android.exoplayer2.source.BaseMediaSource

maybeThrowSourceInfoRefreshError

public void maybeThrowSourceInfoRefreshError()
                                      throws java.io.IOException

Throws:

java.io.IOException

createPeriod

public com.google.android.exoplayer2.source.MediaPeriod createPeriod(com.google.android.exoplayer2.source.MediaSource.MediaPeriodId periodId,
                                                                     com.google.android.exoplayer2.upstream.Allocator allocator)

releasePeriod

public void releasePeriod(com.google.android.exoplayer2.source.MediaPeriod mediaPeriod)

releaseSourceInternal

public void releaseSourceInternal()

Specified by:

releaseSourceInternal in class com.google.android.exoplayer2.source.BaseMediaSource