43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# ExoPlayer HLS module
|
|
|
|
Provides support for HTTP Live Streaming (HLS) content in ExoPlayer.
|
|
|
|
## Getting the module
|
|
|
|
The easiest way to get the module is to add it as a gradle dependency:
|
|
|
|
```gradle
|
|
implementation 'com.google.android.exoplayer:exoplayer-hls:2.X.X'
|
|
```
|
|
|
|
where `2.X.X` is the version, which must match the version of the other media
|
|
modules being used.
|
|
|
|
Alternatively, you can clone this GitHub project and depend on the module
|
|
locally. Instructions for doing this can be found in the [top level README][].
|
|
|
|
[top level README]: https://github.com/google/ExoPlayer/blob/release-v2/README.md
|
|
|
|
## Using the module
|
|
|
|
Adding a dependency to this module is all that's required to enable playback of
|
|
HLS media items added to `ExoPlayer` in its default configuration. Internally,
|
|
`DefaultMediaSourceFactory` will automatically detect the presence of the module
|
|
and convert an HLS `MediaItem` into an `HlsMediaSource` for playback.
|
|
|
|
Similarly, a `DownloadManager` in its default configuration will use
|
|
`DefaultDownloaderFactory`, which will automatically detect the presence of
|
|
the module and build `HlsDownloader` instances to download HLS content.
|
|
|
|
For advanced playback use cases, applications can build `HlsMediaSource`
|
|
instances and pass them directly to the player. For advanced download use cases,
|
|
`HlsDownloader` can be used directly.
|
|
|
|
## Links
|
|
|
|
* [Developer Guide][]
|
|
* [Javadoc][]
|
|
|
|
[Developer Guide]: https://exoplayer.dev/hls.html
|
|
[Javadoc]: https://exoplayer.dev/doc/reference/index.html
|