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 Description

static class DashMediaSource.Factory
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`	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`	The media id used by media items of dash media sources without a manifest URI.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`MediaPeriod`	`createPeriod(MediaSource.MediaPeriodId id, Allocator allocator, long startPositionUs)`	Returns a new `MediaPeriod` identified by `periodId`.
`MediaItem`	`getMediaItem()`	Returns the `MediaItem` whose media is provided by the source.
`void`	`maybeThrowSourceInfoRefreshError()`	Throws any pending error encountered while loading or refreshing source information.
`protected void`	`prepareSourceInternal(TransferListener mediaTransferListener)`	Starts source preparation and enables the source, see `BaseMediaSource.prepareSource(MediaSourceCaller, TransferListener)`.
`void`	`releasePeriod(MediaPeriod mediaPeriod)`	Releases the period.
`protected void`	`releaseSourceInternal()`	Releases the source, see `BaseMediaSource.releaseSource(MediaSourceCaller)`.
`void`	`replaceManifestUri(Uri manifestUri)`	Manually replaces the manifest `Uri`.

Methods inherited from class com.google.android.exoplayer2.source.BaseMediaSource
addDrmEventListener, addEventListener, createDrmEventDispatcher, createDrmEventDispatcher, createEventDispatcher, createEventDispatcher, createEventDispatcher, disable, disableInternal, enable, enableInternal, isEnabled, 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
```
    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
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 DEFAULT_MEDIA_ID
```
    The media id used by media items of dash media sources without a manifest URI.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - replaceManifestUri
```
public void replaceManifestUri(Uri manifestUri)
```
    Manually replaces the manifest Uri.
    
    Parameters:
    
    manifestUri - The replacement manifest Uri.
  - getMediaItem
```
public MediaItem getMediaItem()
```
    Description copied from interface: MediaSource
    
    Returns the MediaItem whose media is provided by the source.
  - prepareSourceInternal
```
protected void prepareSourceInternal(@Nullable
                                     TransferListener mediaTransferListener)
```
    Description copied from class: BaseMediaSource
    
    Starts source preparation and enables the source, see BaseMediaSource.prepareSource(MediaSourceCaller, TransferListener). This method is called at most once until the next call to BaseMediaSource.releaseSourceInternal().
    
    Specified by:
    
    prepareSourceInternal in class BaseMediaSource
    
    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.
  - 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.
    Must only be called after MediaSource.prepareSource(MediaSourceCaller, TransferListener).
    
    Throws:
    
    IOException
  - createPeriod
```
public MediaPeriod createPeriod(MediaSource.MediaPeriodId id,
                                Allocator allocator,
                                long startPositionUs)
```
    Description copied from interface: MediaSource
    
    Returns a new MediaPeriod identified by periodId.
    Should not be called directly from application code.
    Must only be called 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)
```
    Description copied from interface: MediaSource
    
    Releases the period.
    Should not be called directly from application code.
    
    Parameters:
    
    mediaPeriod - The period to release.
  - releaseSourceInternal
```
protected void releaseSourceInternal()
```
    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

Class DashMediaSource

Nested Class Summary

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

Field Summary

Method Summary

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

Methods inherited from class java.lang.Object

Methods inherited from interface com.google.android.exoplayer2.source.MediaSource

Field Detail

DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS

DEFAULT_LIVE_PRESENTATION_DELAY_MS

DEFAULT_MEDIA_ID

Method Detail

replaceManifestUri

getMediaItem

prepareSourceInternal

maybeThrowSourceInfoRefreshError

createPeriod

releasePeriod

releaseSourceInternal