1*30877f79SAndroid Build Coastguard Worker# ExoPlayer DASH module
2*30877f79SAndroid Build Coastguard Worker
3*30877f79SAndroid Build Coastguard WorkerProvides support for Dynamic Adaptive Streaming over HTTP (DASH) content in
4*30877f79SAndroid Build Coastguard WorkerExoPlayer.
5*30877f79SAndroid Build Coastguard Worker
6*30877f79SAndroid Build Coastguard Worker## Getting the module
7*30877f79SAndroid Build Coastguard Worker
8*30877f79SAndroid Build Coastguard WorkerThe easiest way to get the module is to add it as a gradle dependency:
9*30877f79SAndroid Build Coastguard Worker
10*30877f79SAndroid Build Coastguard Worker```gradle
11*30877f79SAndroid Build Coastguard Workerimplementation 'com.google.android.exoplayer:exoplayer-dash:2.X.X'
12*30877f79SAndroid Build Coastguard Worker```
13*30877f79SAndroid Build Coastguard Worker
14*30877f79SAndroid Build Coastguard Workerwhere `2.X.X` is the version, which must match the version of the other media
15*30877f79SAndroid Build Coastguard Workermodules being used.
16*30877f79SAndroid Build Coastguard Worker
17*30877f79SAndroid Build Coastguard WorkerAlternatively, you can clone this GitHub project and depend on the module
18*30877f79SAndroid Build Coastguard Workerlocally. Instructions for doing this can be found in the [top level README][].
19*30877f79SAndroid Build Coastguard Worker
20*30877f79SAndroid Build Coastguard Worker[top level README]: https://github.com/google/ExoPlayer/blob/release-v2/README.md
21*30877f79SAndroid Build Coastguard Worker
22*30877f79SAndroid Build Coastguard Worker## Using the module
23*30877f79SAndroid Build Coastguard Worker
24*30877f79SAndroid Build Coastguard WorkerAdding a dependency to this module is all that's required to enable playback of
25*30877f79SAndroid Build Coastguard WorkerDASH media items added to `ExoPlayer` in its default configuration. Internally,
26*30877f79SAndroid Build Coastguard Worker`DefaultMediaSourceFactory` will automatically detect the presence of the module
27*30877f79SAndroid Build Coastguard Workerand convert a DASH `MediaItem` into a `DashMediaSource` for playback.
28*30877f79SAndroid Build Coastguard Worker
29*30877f79SAndroid Build Coastguard WorkerSimilarly, a `DownloadManager` in its default configuration will use
30*30877f79SAndroid Build Coastguard Worker`DefaultDownloaderFactory`, which will automatically detect the presence of
31*30877f79SAndroid Build Coastguard Workerthe module and build `DashDownloader` instances to download DASH content.
32*30877f79SAndroid Build Coastguard Worker
33*30877f79SAndroid Build Coastguard WorkerFor advanced playback use cases, applications can build `DashMediaSource`
34*30877f79SAndroid Build Coastguard Workerinstances and pass them directly to the player. For advanced download use cases,
35*30877f79SAndroid Build Coastguard Worker`DashDownloader` can be used directly.
36*30877f79SAndroid Build Coastguard Worker
37*30877f79SAndroid Build Coastguard Worker## Links
38*30877f79SAndroid Build Coastguard Worker
39*30877f79SAndroid Build Coastguard Worker* [Developer Guide][]
40*30877f79SAndroid Build Coastguard Worker* [Javadoc][]
41*30877f79SAndroid Build Coastguard Worker
42*30877f79SAndroid Build Coastguard Worker[Developer Guide]: https://exoplayer.dev/dash.html
43*30877f79SAndroid Build Coastguard Worker[Javadoc]: https://exoplayer.dev/doc/reference/index.html
44