@UnstableApi
public final class DashDownloader extends SegmentDownloader

java.lang.Object
   ↳ androidx.media3.exoplayer.offline.SegmentDownloader
     ↳ androidx.media3.exoplayer.dash.offline.DashDownloader

A downloader for DASH streams.

Example usage: 

SimpleCache cache = new SimpleCache(downloadFolder, new NoOpCacheEvictor(), databaseProvider);
CacheDataSource.Factory cacheDataSourceFactory =
    new CacheDataSource.Factory()
        .setCache(cache)
        .setUpstreamDataSourceFactory(new DefaultHttpDataSource.Factory());
// Create a downloader for the first representation of the first adaptation set of the first
// period.
DashDownloader dashDownloader =
    new DashDownloader.Factory(cacheDataSourceFactory)
            .create(new MediaItem.Builder()
              .setUri(manifestUrl)
              .setStreamKeys(ImmutableList.of(new StreamKey(0, 0, 0)))
              .build());
// Perform the download.
dashDownloader.download(progressListener);
// Use the downloaded data for playback.
DashMediaSource mediaSource =
    new DashMediaSource.Factory(cacheDataSourceFactory).createMediaSource(mediaItem);

Summary

Nested types

A factory for DASH downloaders.

Public constructors
DashDownloader(
    MediaItem mediaItem,
    CacheDataSource.Factory cacheDataSourceFactory
)

This method is deprecated.

Use create instead.
DashDownloader(
    MediaItem mediaItem,
    CacheDataSource.Factory cacheDataSourceFactory,
    Executor executor
)

This method is deprecated.

Use create instead.

Protected methods
List<SegmentDownloader.Segment>
getSegments(
    DataSource dataSource,
    DashManifest manifest,
    boolean removing
)

Returns a list of all downloadable Segments for a given manifest.

Inherited Constants
From androidx.media3.exoplayer.offline.SegmentDownloader
static final long

Inherited fields
From androidx.media3.exoplayer.offline.SegmentDownloader
final long
final long

Inherited methods
From androidx.media3.exoplayer.offline.SegmentDownloader
void

Permanently cancels the downloading by this downloader.
final void

Downloads the content.
final T
<T> execute(RunnableFutureTask<T, Object> runnable, boolean removing)

Executes the provided RunnableFutureTask.
static DataSpec
final M
getManifest(DataSource dataSource, DataSpec dataSpec, boolean removing)

Loads and parses a manifest.
final void

Removes the content.

Public constructors

DashDownloader

public DashDownloader(
    MediaItem mediaItem,
    CacheDataSource.Factory cacheDataSourceFactory
)

DashDownloader

public DashDownloader(
    MediaItem mediaItem,
    CacheDataSource.Factory cacheDataSourceFactory,
    Executor executor
)

Protected methods

getSegments

protected List<SegmentDownloader.Segment> getSegments(
    DataSource dataSource,
    DashManifest manifest,
    boolean removing
)

Returns a list of all downloadable Segments for a given manifest. Any required data should be loaded using getManifest or execute.

Parameters
DataSource dataSource

The DataSource through which to load any required data.
DashManifest manifest

The manifest containing the segments.
boolean removing

Whether the segments are being obtained as part of a removal. If true then a partial segment list is returned in the case that a load error prevents all segments from being listed. If false then an IOException will be thrown in this case.
Returns
List<SegmentDownloader.Segment>

The list of downloadable Segments.
Throws
java.io.IOException

Thrown if allowPartialIndex is false and an execution error occurs, or if the media is not in a form that allows for its segments to be listed.
java.lang.InterruptedException