DASH

ExoPlayer mendukung DASH dengan beberapa format penampung. Aliran media harus di-demux, yang berarti video, audio, dan teks harus ditentukan dalam elemen AdaptationSet yang berbeda dalam manifes DASH (CEA-608 adalah pengecualian seperti yang dijelaskan dalam tabel di bawah). Format sampel audio dan video yang ada juga harus didukung (lihat bagian format sampel untuk mengetahui detailnya).

Fitur Didukung Komentar
Penampung
FMP4 YA Khusus aliran yang di-demux
WebM YA Khusus aliran yang di-demux
Matroska YA Khusus aliran yang di-demux
MPEG-TS TIDAK Tidak ada dukungan yang direncanakan
Teks tertutup / subtitle
TTML YA Mentah, atau disematkan di FMP4 sesuai dengan ISO/IEC 14496-30
WebVTT YA Mentah, atau disematkan di FMP4 sesuai dengan ISO/IEC 14496-30
CEA-608 YA Disematkan di FMP4 saat diberi sinyal menggunakan deskriptor Aksesibilitas SCTE
CEA-708 YA Disematkan di FMP4 saat diberi sinyal menggunakan deskriptor Aksesibilitas SCTE
Metadata
Metadata EMSG YA Disematkan di FMP4
Perlindungan konten
Widevine YA Skema "cenc": API 19+; skema "cbcs": API 25+
PlayReady SL2000 YA Android TV, hanya skema "cenc"
ClearKey YA API 21+, hanya skema "cenc"
Penyisipan iklan
Pemutaran multi-periode YA
Penyisipan iklan yang dipandu server (xlink) TIDAK
Iklan sisi server dan sisi klien IMA YA Panduan penyisipan iklan
Pemutaran live
Pemutaran live reguler YA
Pemutaran live CMAF latensi ultra-rendah YA
Common Media Client Data (CMCD) YA Panduan integrasi CMCD

Menggunakan MediaItem

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

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.10.0")

Groovy

implementation "androidx.media3:media3-exoplayer-dash:1.10.0"

Kemudian, Anda dapat membuat MediaItem untuk URI MPD DASH 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(dashUri))
// Prepare the player.
player.prepare()
Dash.kt

Java

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(dashUri));
// Prepare the player.
player.prepare();
Dash.java

Jika URI Anda tidak berakhiran dengan .mpd, Anda dapat meneruskan MimeTypes.APPLICATION_MPD ke setMimeType dari MediaItem.Builder untuk menunjukkan jenis konten secara eksplisit.

ExoPlayer akan otomatis beradaptasi antara representasi yang ditentukan dalam manifes, dengan mempertimbangkan bandwidth yang tersedia dan kemampuan perangkat.

Menggunakan DashMediaSource

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

Kotlin

val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a dash media source pointing to a dash manifest uri.
val mediaSource: MediaSource =
  DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri))
// Create a player instance which gets an adaptive track selector by default.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()
Dash.kt

Java

DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a dash media source pointing to a dash manifest uri.
MediaSource mediaSource =
    new DashMediaSource.Factory(dataSourceFactory)
        .createMediaSource(MediaItem.fromUri(dashUri));
// Create a player instance which gets an adaptive track selector by default.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();
Dash.java

Mengakses manifes

Anda dapat mengambil manifes saat ini dengan memanggil Player.getCurrentManifest. Untuk DASH, Anda harus mentransmisikan objek yang ditampilkan ke DashManifest. Callback onTimelineChanged dari Player.Listener juga dipanggil setiap kali manifes dimuat. Hal ini akan terjadi satu kali untuk konten sesuai permintaan, dan mungkin berkali-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,
      @Player.TimelineChangeReason reason: Int,
    ) {
      val manifest = player.currentManifest
      if (manifest is DashManifest) {
        // Do something with the manifest.
      }
    }
  }
)
Dash.kt

Java

player.addListener(
    new Player.Listener() {
      @Override
      public void onTimelineChanged(
          Timeline timeline, @Player.TimelineChangeReason int reason) {
        Object manifest = player.getCurrentManifest();
        if (manifest != null) {
          DashManifest dashManifest = (DashManifest) manifest;
          // Do something with the manifest.
        }
      }
    });
Dash.java

Menyesuaikan pemutaran

ExoPlayer menyediakan beberapa cara untuk menyesuaikan pengalaman pemutaran dengan kebutuhan aplikasi Anda. Lihat halaman Penyesuaian untuk mengetahui contohnya.