HLS

ExoPlayer mendukung HLS dengan beberapa format penampung. Format sampel audio dan video yang disertakan juga harus didukung (lihat bagian format sampel untuk mengetahui detailnya). Sebaiknya produser konten HLS membuat streaming HLS berkualitas tinggi, seperti yang dijelaskan di sini.

Fitur Didukung Komentar
Container
MPEG-TS YA
FMP4/CMAF YA
ADTS (AAC) YA
MP3 YA
Teks tertutup/subtitel
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
Update 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 (Apple) YA
HLS (Komunitas) berlatensi rendah TIDAK
Common Media Client Data (CMCD) YA Panduan Integrasi

Menggunakan MediaItem

Untuk memutar streaming HLS, Anda harus bergantung pada modul HLS.

Kotlin

implementation("androidx.media3:media3-exoplayer-hls:1.4.1")

Groovy

implementation "androidx.media3:media3-exoplayer-hls:1.4.1"

Anda kemudian 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 Anda 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 dan kemampuan perangkat yang tersedia.

Menggunakan HlsMediaSource

Untuk opsi penyesuaian lainnya, Anda dapat membuat HlsMediaSource dan meneruskannya langsung ke pemutar, 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 dapat 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. Lihat Halaman penyesuaian untuk mengetahui contohnya.

Menonaktifkan persiapan tanpa potongan

Secara default, ExoPlayer akan menggunakan persiapan tanpa potongan. Artinya, ExoPlayer hanya akan menggunakan informasi dalam playlist multivarian untuk menyiapkan streaming, 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 yang di-mux yang tidak dideklarasikan dalam playlist multivarian dengan tag #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS. Jika tidak, trek teks tertutup ini tidak akan terdeteksi dan diputar. Anda dapat menonaktifkan persiapan tanpa potongan di HlsMediaSource.Factory seperti ditunjukkan dalam cuplikan berikut. Perhatikan bahwa hal ini akan meningkatkan waktu mulai karena ExoPlayer perlu mendownload segmen media untuk menemukan trek tambahan ini dan sebaiknya deklarasikan trek teks tertutup di playlist multivarian.

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 Anda. Baca postingan Medium tentang pemutaran HLS di ExoPlayer untuk mengetahui penjelasan selengkapnya. Poin utamanya adalah:

  • Gunakan durasi segmen yang tepat.
  • Gunakan streaming media berkelanjutan; hindari perubahan pada struktur media di seluruh segmen.
  • Gunakan tag #EXT-X-INDEPENDENT-SEGMENTS.
  • Pilih streaming yang telah didemux, bukan file yang menyertakan video dan audio.
  • Sertakan semua informasi yang dapat Anda sertakan dalam Playlist Multivarian.

Panduan berikut berlaku khusus untuk live stream:

  • Gunakan tag #EXT-X-PROGRAM-DATE-TIME.
  • Gunakan tag #EXT-X-DISCONTINUITY-SEQUENCE.
  • Berikan periode aktif yang lama. Satu menit atau lebih akan sangat bagus.