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