ExoPlayer mendukung HLS dengan beberapa format container. Format sampel audio dan video yang dimuat juga harus didukung (lihat bagian format contoh untuk detailnya). Kami sangat mendorong produser konten HLS untuk menghasilkan streaming HLS berkualitas tinggi, seperti yang dijelaskan di sini.
Fitur | Didukung | Komentar |
---|---|---|
Container | ||
MPEG-TS | YA | |
FMP4/CMAF | YA | |
ADT (AAC) | YA | |
MP3 | YA | |
Teks/subtitel tertutup | ||
CEA-608 | YA | |
CEA-708 | YA | |
WebVTT | YA | |
Metadata | ||
ID3 | YA | |
SCTE-35 | TIDAK | |
Perlindungan konten | ||
AES-128 | YA | |
Contoh AES-128 | TIDAK | |
Widevine | YA | API 19+ (skema "cenc") dan 25+ (skema "cbcs") |
PlayReady SL2000 | YA | Khusus Android TV |
Kontrol server | ||
Info terbaru Delta | YA | |
Memblokir pemuatan ulang playlist | YA | |
Memblokir pemuatan petunjuk pramuat | YA | Kecuali untuk byterange dengan panjang yang tidak ditentukan |
Pemutaran live | ||
Pemutaran live reguler | YA | |
HLS latensi rendah (Apel) | YA | |
HLS latensi rendah (Komunitas) | TIDAK | |
Data Klien Media Umum (CMCD) | YA | Panduan Integrasi |
Menggunakan Varian
Untuk memutar streaming HLS, Anda harus bergantung pada modul HLS.
Kotlin
implementation("androidx.media3:media3-exoplayer-hls:1.3.1")
Groovy
implementation "androidx.media3:media3-exoplayer-hls:1.3.1"
Kemudian, Anda dapat membuat MediaItem
untuk URI playlist HLS dan meneruskannya ke
pemutar.
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(hlsUri)) // Prepare the player. player.prepare()
Java
// Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(hlsUri)); // Prepare the player. player.prepare();
Jika URI tidak diakhiri dengan .m3u8
, Anda dapat meneruskan MimeTypes.APPLICATION_M3U8
ke setMimeType
dari MediaItem.Builder
untuk menunjukkan jenis
konten secara eksplisit.
URI item media dapat mengarah ke playlist media atau playlist
multivarian. Jika URI mengarah ke playlist multi-varian yang mendeklarasikan beberapa
tag #EXT-X-STREAM-INF
, ExoPlayer akan otomatis beradaptasi antar-varian, dengan mempertimbangkan bandwidth yang tersedia dan kemampuan perangkat.
Menggunakan HlsMediaSource
Untuk opsi penyesuaian lainnya, Anda dapat membuat HlsMediaSource
dan meneruskannya
langsung ke pemain, bukan MediaItem
.
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a HLS media source pointing to a playlist uri. val hlsMediaSource = HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the HLS media source as the playlist with a single media item. player.setMediaSource(hlsMediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a HLS media source pointing to a playlist uri. HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri)); // Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the HLS media source as the playlist with a single media item. player.setMediaSource(hlsMediaSource); // Prepare the player. player.prepare();
Mengakses manifes
Anda dapat mengambil manifes saat ini dengan memanggil Player.getCurrentManifest
.
Untuk HLS, Anda harus mentransmisikan objek yang ditampilkan ke HlsManifest
. Callback
onTimelineChanged
dari Player.Listener
juga dipanggil setiap kali
manifes dimuat. Hal ini akan terjadi sekali untuk konten on demand dan
mungkin beberapa kali untuk konten live. Cuplikan kode berikut menunjukkan cara aplikasi
melakukan sesuatu setiap kali manifes dimuat.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is HlsManifest) { // Do something with the manifest. } } } )
Java
player.addListener( new Player.Listener() { @Override public void onTimelineChanged( Timeline timeline, @Player.TimelineChangeReason int reason) { Object manifest = player.getCurrentManifest(); if (manifest != null) { HlsManifest hlsManifest = (HlsManifest) manifest; // Do something with the manifest. } } });
Menyesuaikan pemutaran
ExoPlayer menyediakan beberapa cara bagi Anda untuk menyesuaikan pengalaman pemutaran dengan kebutuhan aplikasi Anda. Lihat halaman Penyesuaian untuk mengetahui contohnya.
Menonaktifkan persiapan tanpa potongan
Secara default, ExoPlayer akan menggunakan persiapan tanpa potongan. Ini berarti bahwa ExoPlayer
hanya akan menggunakan informasi dalam playlist multi-varian untuk menyiapkan
aliran, yang berfungsi jika tag #EXT-X-STREAM-INF
berisi atribut
CODECS
.
Anda mungkin perlu menonaktifkan fitur ini jika segmen media Anda berisi trek
teks tertutup mux yang tidak dideklarasikan dalam playlist multi-varian dengan
tag #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS
. Jika tidak, trek teks tertutup
tidak akan terdeteksi dan diputar. Anda dapat menonaktifkan persiapan tanpa potongan di
HlsMediaSource.Factory
seperti ditunjukkan dalam cuplikan berikut. Perlu diperhatikan bahwa hal ini
akan meningkatkan waktu mulai karena ExoPlayer perlu mendownload segmen media untuk
menemukan trek tambahan ini, dan lebih baik untuk mendeklarasikan
trek teks tertutup dalam playlist multi-varian.
Kotlin
val hlsMediaSource = HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri))
Java
HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory) .setAllowChunklessPreparation(false) .createMediaSource(MediaItem.fromUri(hlsUri));
Membuat konten HLS berkualitas tinggi
Untuk mendapatkan hasil maksimal dari ExoPlayer, ada panduan tertentu yang dapat Anda ikuti untuk meningkatkan konten HLS. Baca postingan Medium tentang pemutaran HLS di ExoPlayer untuk penjelasan lengkap. Poin utamanya adalah:
- Gunakan durasi segmen yang akurat.
- Gunakan streaming media yang berkelanjutan; hindari perubahan pada struktur media di seluruh segmen.
- Menggunakan tag
#EXT-X-INDEPENDENT-SEGMENTS
. - Memilih streaming demux, bukan file yang menyertakan video dan audio.
- Sertakan semua informasi yang bisa Anda tampilkan di Playlist Multi-varian.
Pedoman berikut berlaku khusus untuk live stream:
- Menggunakan tag
#EXT-X-PROGRAM-DATE-TIME
. - Menggunakan tag
#EXT-X-DISCONTINUITY-SEQUENCE
. - Menyediakan periode aktif yang panjang. Satu menit atau lebih sudah bagus.