Back to Exoplayer

DashMediaSource (ExoPlayer library)

docs/doc/reference/com/google/android/exoplayer2/source/dash/DashMediaSource.html

latest12.1 KB
Original Source

Package com.google.android.exoplayer2.source.dash

Class DashMediaSource


[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public final classDashMediaSourceextends[BaseMediaSource](../BaseMediaSource.html "class in com.google.android.exoplayer2.source")

Deprecated. com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

A DASH MediaSource.

Nested Class Summary

Nested Classes | Modifier and Type | Class | Description | | --- | --- | --- | | static class | DashMediaSource.Factory | Deprecated.

Factory for DashMediaSources. |

- 

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

MediaSource.MediaPeriodId, MediaSource.MediaSourceCaller

Field Summary

Fields | Modifier and Type | Field | Description | | --- | --- | --- | | static long | DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS | Deprecated.

The default target offset for live streams that is used if no value is defined in the MediaItem or the manifest. | | static long | DEFAULT_LIVE_PRESENTATION_DELAY_MS | Deprecated. Use DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS instead.

| | static String | DEFAULT_MEDIA_ID | Deprecated.

The media id used by media items of dash media sources without a manifest URI. | | static long | MIN_LIVE_DEFAULT_START_POSITION_US | Deprecated.

The minimum default start position for live streams, in microseconds relative to the start of the live window. |

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods | Modifier and Type | Method | Description | | --- | --- | --- | | MediaPeriod | createPeriod​(MediaSource.MediaPeriodId id, Allocator allocator, long startPositionUs) | Deprecated.

Returns a new MediaPeriod identified by periodId. | | MediaItem | getMediaItem() | Deprecated.

Returns the MediaItem whose media is provided by the source. | | void | maybeThrowSourceInfoRefreshError() | Deprecated.

Throws any pending error encountered while loading or refreshing source information. | | protected void | prepareSourceInternal​(TransferListener mediaTransferListener) | Deprecated.

Starts source preparation and enables the source, see BaseMediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId). | | void | releasePeriod​(MediaPeriod mediaPeriod) | Deprecated.

Releases the period. | | protected void | releaseSourceInternal() | Deprecated.

Releases the source, see BaseMediaSource.releaseSource(MediaSourceCaller). | | void | replaceManifestUri​(Uri manifestUri) | Deprecated.

Manually replaces the manifest Uri. |

- 

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

addDrmEventListener, addEventListener, createDrmEventDispatcher, createDrmEventDispatcher, createEventDispatcher, createEventDispatcher, createEventDispatcher, createEventDispatcher, disable, disableInternal, enable, enableInternal, getPlayerId, isEnabled, prepareSource, prepareSource, refreshSourceInfo, releaseSource, removeDrmEventListener, 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

getInitialTimeline, isSingleWindow

Field Detail

- 

DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS

public static final long DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS

Deprecated.

The default target offset for live streams that is used if no value is defined in the MediaItem or the manifest. See Also:Constant Field Values

- 

DEFAULT_LIVE_PRESENTATION_DELAY_MS

[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public static final long DEFAULT_LIVE_PRESENTATION_DELAY_MS

Deprecated. Use DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS instead.

See Also:Constant Field Values

- 

DEFAULT_MEDIA_ID

public static final[String](https://developer.android.com/reference/java/lang/String.html "class or interface in java.lang")DEFAULT_MEDIA_ID

Deprecated.

The media id used by media items of dash media sources without a manifest URI. See Also:Constant Field Values

- 

MIN_LIVE_DEFAULT_START_POSITION_US

public static final long MIN_LIVE_DEFAULT_START_POSITION_US

Deprecated.

The minimum default start position for live streams, in microseconds relative to the start of the live window. See Also:Constant Field Values

Method Detail

- 

replaceManifestUri

public void replaceManifestUri​([Uri](https://developer.android.com/reference/android/net/Uri.html "class or interface in android.net")manifestUri)

Deprecated.

Manually replaces the manifest Uri. Parameters:manifestUri - The replacement manifest Uri.

- 

getMediaItem

public[MediaItem](../../MediaItem.html "class in com.google.android.exoplayer2")getMediaItem()

Deprecated.

Description copied from interface: MediaSource

Returns the MediaItem whose media is provided by the source.

Should not be called directly from application code.

This method must be called on the application thread.

- 

prepareSourceInternal

protected void prepareSourceInternal​(@Nullable[TransferListener](../../upstream/TransferListener.html "interface in com.google.android.exoplayer2.upstream")mediaTransferListener)

Deprecated.

Description copied from class: BaseMediaSource

Starts source preparation and enables the source, see BaseMediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId). This method is called at most once until the next call to BaseMediaSource.releaseSourceInternal(). Specified by:prepareSourceInternal in class BaseMediaSourceParameters: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](https://developer.android.com/reference/java/io/IOException.html "class or interface in java.io")

Deprecated.

Description copied from interface: MediaSource

Throws any pending error encountered while loading or refreshing source information.

Should not be called directly from application code.

This method must be called on the playback thread and only after MediaSource.prepareSource(MediaSourceCaller, TransferListener, PlayerId).

Throws:IOException

- 

createPeriod

public[MediaPeriod](../MediaPeriod.html "interface in com.google.android.exoplayer2.source")createPeriod​([MediaSource.MediaPeriodId](../MediaSource.MediaPeriodId.html "class in com.google.android.exoplayer2.source")id,[Allocator](../../upstream/Allocator.html "interface in com.google.android.exoplayer2.upstream")allocator,
                                long startPositionUs)

Deprecated.

Description copied from interface: MediaSource

Returns a new MediaPeriod identified by periodId.

Should not be called directly from application code.

This method must be called on the playback thread and only if the source is enabled.

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.html "interface in com.google.android.exoplayer2.source")mediaPeriod)

Deprecated.

Description copied from interface: MediaSource

Releases the period.

Should not be called directly from application code.

This method must be called on the playback thread.

Parameters:mediaPeriod - The period to release.

- 

releaseSourceInternal

protected void releaseSourceInternal()

Deprecated.

Description copied from class: BaseMediaSource

Releases the source, see BaseMediaSource.releaseSource(MediaSourceCaller). This method is called exactly once after each call to BaseMediaSource.prepareSourceInternal(TransferListener). Specified by:releaseSourceInternal in class BaseMediaSource