ExoPlayer mendukung DASH dengan beberapa format penampung. Streaming 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 disertakan juga harus
didukung (lihat
bagian format sampel 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/subtitel | ||
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 | Disematkan dalam FMP4 saat diberi sinyal menggunakan deskripsi 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" |
ClearKey | YA | API 21+, khusus skema "cenc" |
Pemutaran live | ||
Pemutaran live reguler | YA | |
Pemutaran live CMAF dengan latensi ultra-rendah | YA | |
Common Media Client Data (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 tidak diakhiri dengan .mpd
, Anda dapat meneruskan MimeTypes.APPLICATION_MPD
ke setMimeType
dari MediaItem.Builder
untuk secara eksplisit menunjukkan jenis
konten.
ExoPlayer akan otomatis beradaptasi di 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()
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
. Callback
onTimelineChanged
dari Player.Listener
juga dipanggil setiap kali
manifes dimuat. Hal ini akan terjadi sekali untuk konten on demand, 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, @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. Lihat Halaman penyesuaian untuk mengetahui contohnya.