HLS

ExoPlayer mendukung HLS dengan beberapa format container. Audio yang dimuat dan format sampel video juga harus didukung (lihat contoh format untuk mengetahui detailnya). Rab sangat menganjurkan produser konten HLS untuk menghasilkan streaming HLS berkualitas tinggi, seperti yang dijelaskan di sini.

Menggunakan MediaItem

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

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

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

Anda kemudian dapat membuat MediaItem untuk URI playlist HLS dan meneruskannya ke web.

// 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()

// 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 secara eksplisit menunjukkan jenis saat ini.

URI item media dapat mengarah ke playlist media atau multi-varian playlist. Jika URI mengarah ke playlist multi-varian yang mendeklarasikan beberapa #EXT-X-STREAM-INF, maka ExoPlayer akan otomatis beradaptasi antara varian, dengan mempertimbangkan bandwidth yang tersedia dan kemampuan perangkat.

Menggunakan HlsMediaSource

Untuk opsi penyesuaian lainnya, Anda dapat membuat HlsMediaSource dan meneruskannya langsung ke pemutar, bukan MediaItem.

// 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()

// 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 bisa mengambil manifes saat ini dengan memanggil Player.getCurrentManifest. Untuk HLS, Anda harus mentransmisikan objek yang ditampilkan ke HlsManifest. Tujuan Callback onTimelineChanged dari Player.Listener juga dipanggil setiap kali manifes dimuat. Ini akan terjadi satu kali untuk konten on-demand dan mungkin berkali-kali untuk konten live streaming. Cuplikan kode berikut menunjukkan cara aplikasi bisa melakukan sesuatu kapan saja manifes dimuat.

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.
      }
    }
  }
)

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 aplikasi Anda. Lihat halaman Penyesuaian untuk mengetahui contohnya.

Menonaktifkan persiapan tanpa potongan

Secara default, ExoPlayer akan menggunakan persiapan tanpa potongan. Ini berarti ExoPlayer hanya akan menggunakan informasi dalam playlist multi-varian untuk menyiapkan aliran data, yang berfungsi jika tag #EXT-X-STREAM-INF berisi tag CODECS .

Anda mungkin perlu menonaktifkan fitur ini jika segmen media Anda berisi multipleks trek teks tertutup yang tidak dideklarasikan dalam playlist multi-varian 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 yang ditunjukkan dalam cuplikan berikut. Perhatikan bahwa akan meningkatkan waktu mulai karena ExoPlayer perlu mendownload segmen media untuk menemukan trek tambahan ini dan sebaiknya dinyatakan trek teks tertutup dalam playlist multi-varian.

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

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 bisa Anda ikuti untuk meningkatkan kualitas konten HLS Anda. Baca postingan Medium tentang pemutaran HLS di ExoPlayer untuk penjelasan lengkap. Poin utamanya adalah:

• Gunakan durasi segmen yang tepat.
• Menggunakan streaming media yang berkelanjutan; menghindari perubahan struktur media di seluruh segmen.
• Gunakan tag #EXT-X-INDEPENDENT-SEGMENTS.
• Lebih memilih streaming hasil demux, bukan file yang menyertakan video dan audio.
• Sertakan semua informasi yang Anda bisa di Playlist Multi-varian.

Panduan berikut berlaku khusus untuk live stream:

• Gunakan tag #EXT-X-PROGRAM-DATE-TIME.
• Gunakan tag #EXT-X-DISCONTINUITY-SEQUENCE.
• Menyediakan jendela tahan lama. Satu menit atau lebih sudah bagus.