DashMediaSource (ExoPlayer library)

java.lang.Object
- com.google.android.exoplayer2.source.BaseMediaSource
- - com.google.android.exoplayer2.source.dash.DashMediaSource

All Implemented Interfaces:: MediaSource

public final class DashMediaSource
extends 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
  MediaSource.MediaPeriodId, MediaSource.SourceInfoRefreshListener

Nested Classes
Modifier and Type	Class and Description
`static class`	`DashMediaSource.Factory` Factory for `DashMediaSource`s.

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS` Deprecated. Use `DEFAULT_LIVE_PRESENTATION_DELAY_MS`.
`static long`	`DEFAULT_LIVE_PRESENTATION_DELAY_MS` The default presentation delay for live streams.
`static long`	`DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS` Deprecated. Use of this parameter is no longer necessary.

Constructor Summary

Constructors
Constructor and Description
`DashMediaSource(DashManifest manifest, DashChunkSource.Factory chunkSourceFactory, Handler eventHandler, MediaSourceEventListener eventListener)` Deprecated. Use `DashMediaSource.Factory` instead.
`DashMediaSource(DashManifest manifest, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, Handler eventHandler, MediaSourceEventListener eventListener)` Deprecated. Use `DashMediaSource.Factory` instead.
`DashMediaSource(Uri manifestUri, DataSource.Factory manifestDataSourceFactory, DashChunkSource.Factory chunkSourceFactory, Handler eventHandler, MediaSourceEventListener eventListener)` Deprecated. Use `DashMediaSource.Factory` instead.
`DashMediaSource(Uri manifestUri, DataSource.Factory manifestDataSourceFactory, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, long livePresentationDelayMs, Handler eventHandler, MediaSourceEventListener eventListener)` Deprecated. Use `DashMediaSource.Factory` instead.
`DashMediaSource(Uri manifestUri, DataSource.Factory manifestDataSourceFactory, ParsingLoadable.Parser<? extends DashManifest> manifestParser, DashChunkSource.Factory chunkSourceFactory, int minLoadableRetryCount, long livePresentationDelayMs, Handler eventHandler, MediaSourceEventListener eventListener)` Deprecated. Use `DashMediaSource.Factory` instead.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`MediaPeriod`	`createPeriod(MediaSource.MediaPeriodId periodId, Allocator allocator, long startPositionUs)` Returns a new `MediaPeriod` identified by `periodId`.
`Object`	`getTag()` Returns the tag set on the media source, or null if none was set.
`void`	`maybeThrowSourceInfoRefreshError()` Throws any pending error encountered while loading or refreshing source information.
`void`	`prepareSourceInternal(ExoPlayer player, boolean isTopLevelSource, TransferListener mediaTransferListener)` Starts source preparation.
`void`	`releasePeriod(MediaPeriod mediaPeriod)` Releases the period.
`void`	`releaseSourceInternal()` Releases the source.
`void`	`replaceManifestUri(Uri manifestUri)` Manually replaces the manifest `Uri`.

Methods inherited from class com.google.android.exoplayer2.source.BaseMediaSource
addEventListener, createEventDispatcher, createEventDispatcher, createEventDispatcher, prepareSource, 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_LIVE_PRESENTATION_DELAY_MS
```
public static final long DEFAULT_LIVE_PRESENTATION_DELAY_MS
```
    The 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
  - DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS
```
@Deprecated
public static final long DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS
```
    Deprecated. Use DEFAULT_LIVE_PRESENTATION_DELAY_MS.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS
```
@Deprecated
public static final long DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS
```
    Deprecated. Use of this parameter is no longer necessary.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DashMediaSource
```
@Deprecated
public DashMediaSource(DashManifest manifest,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   Handler eventHandler,
                                   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,
                                   Handler eventHandler,
                                   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(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   Handler eventHandler,
                                   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(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   Handler eventHandler,
                                   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(Uri manifestUri,
                                   DataSource.Factory manifestDataSourceFactory,
                                   ParsingLoadable.Parser<? extends DashManifest> manifestParser,
                                   DashChunkSource.Factory chunkSourceFactory,
                                   int minLoadableRetryCount,
                                   long livePresentationDelayMs,
                                   Handler eventHandler,
                                   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(Uri manifestUri)
```
    Manually replaces the manifest Uri.
    
    Parameters:
    
    manifestUri - The replacement manifest Uri.
  - getTag
```
@Nullable
public 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(ExoPlayer player,
                                  boolean isTopLevelSource,
                                  @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().
    
    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).
    
    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.
  - maybeThrowSourceInfoRefreshError
```
public void maybeThrowSourceInfoRefreshError()
                                      throws 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:
    
    IOException
  - createPeriod
```
public MediaPeriod createPeriod(MediaSource.MediaPeriodId periodId,
                                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:
    
    periodId - 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.
  - releaseSourceInternal
```
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, TransferListener).
    
    Specified by:
    
    releaseSourceInternal in class BaseMediaSource

Class DashMediaSource

Nested Class Summary

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

Field Summary

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_LIVE_PRESENTATION_DELAY_MS

DEFAULT_LIVE_PRESENTATION_DELAY_FIXED_MS

DEFAULT_LIVE_PRESENTATION_DELAY_PREFER_MANIFEST_MS

Constructor Detail

DashMediaSource

DashMediaSource

DashMediaSource

DashMediaSource

DashMediaSource

Method Detail

replaceManifestUri

getTag

prepareSourceInternal

maybeThrowSourceInfoRefreshError

createPeriod

releasePeriod

releaseSourceInternal