ed5b7004b4
Many usages are needed to support other deprecations and some can be replaced by the recommended direct alternative. Also replace links to deprecated/redirected dev site PiperOrigin-RevId: 601795998
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 'androidx.media3:media3-exoplayer-hls:1.X.X'
|
|
```
|
|
|
|
where `1.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]: ../../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://developer.android.com/media/media3/exoplayer/hls
|
|
[Javadoc]: https://developer.android.com/reference/androidx/media3/exoplayer/hls/package-summary
|