DASH

ExoPlayer mendukung DASH dengan beberapa format penampung. Streaming media harus didemuxed, artinya video, audio, dan teks harus didefinisikan secara Elemen AdaptationSet dalam manifes DASH (CEA-608 merupakan pengecualian karena yang dijelaskan dalam tabel di bawah). Format sampel audio dan video yang ada harus juga didukung (lihat contoh format untuk mengetahui detailnya).

Fitur	Didukung	Komentar
Container
FMP4	YA	Khusus streaming yang didemux
WebM	YA	Khusus streaming yang didemux
Matroska	YA	Khusus streaming yang didemux
MPEG-TS	TIDAK	Tidak ada dukungan yang direncanakan
Teks tertutup
TTML	YA	Mentah, atau disematkan dalam FMP4 sesuai dengan ISO/IEC 14496-30
WebVTT	YA	Mentah, atau disematkan dalam FMP4 sesuai dengan ISO/IEC 14496-30
CEA 608	YA	Tersemat di FMP4 saat diberi sinyal menggunakan deskriptor Aksesibilitas SCTE
CEA 708	YA	Disematkan dalam FMP4 saat diberi sinyal menggunakan deskripsi Aksesibilitas SCTE
Metadata
Metadata EMSG	YA	Disematkan dalam FMP4
Perlindungan konten
Widevine	YA	Skema "cenc": API 19+; Skema "cbcs": API 25+
PlayReady SL2000	YA	Android TV, khusus skema "cenc"
{i>ClearKey<i}	YA	API 21+, "cenc" khusus skema
Pemutaran live
Pemutaran live reguler	YA
Pemutaran live CMAF berlatensi sangat rendah	YA
Data Klien Media Umum (CMCD)	YA	Panduan Integrasi

Menggunakan MediaItem

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

Kotlin

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

Groovy

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

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

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

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

ExoPlayer akan otomatis beradaptasi di antara representasi yang ditentukan dalam manifes, dengan mempertimbangkan {i>bandwidth<i} dan kemampuan perangkat yang tersedia.

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

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

Mengakses manifes

Anda dapat mengambil manifes saat ini dengan memanggil Player.getCurrentManifest. Untuk DASH, Anda harus mentransmisikan objek yang ditampilkan ke DashManifest. 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.

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is DashManifest) {
        // 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) {
          DashManifest dashManifest = (DashManifest) 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.