ExoPlayer 支援多種容器格式的 DASH。媒體串流必須
雙重混音,也就是說,影片、音訊和文字必須以
DASH 資訊清單中的 AdaptationSet
元素 (CEA-608 是例外狀況,
。內含的音訊和影片範例格式必須
可支援,詳情請參閱
範例格式一節)。
功能 | 支援 | 留言 |
---|---|---|
容器 | ||
FMP4 | 是 | 僅限 Demuxed 串流 |
WebM | 是 | 僅限 Demuxed 串流 |
馬特羅斯卡 | 是 | 僅限 Demuxed 串流 |
MPEG-TS | 否 | 未規劃任何支援 |
隱藏式輔助字幕/字幕 | ||
TTML | 是 | 根據 ISO/IEC 14496-30 標準,或是嵌入至 FMP4 中 |
WebVTT | 是 | 根據 ISO/IEC 14496-30 標準,或是嵌入至 FMP4 中 |
CEA-608 | 是 | 使用 SCTE 無障礙功能描述元發出信號時,會嵌入 FMP4 |
CEA-708 | 是 | 使用 SCTE 無障礙功能描述元發出信號時,會嵌入 FMP4 |
Metadata | ||
EMSG 中繼資料 | 是 | 內嵌於 FMP4 |
內容保護 | ||
Widevine | 是 | 「cenc」配置:API 級別 19 以上;「cbcs」配置:API 25 以上 |
PlayReady SL2000 | 是 | Android TV、「cenc」僅限配置 |
清除鍵 | 是 | API 21 以上版本、「cenc」僅限配置 |
即時播放 | ||
定期即時播放 | 是 | |
超低延遲 CMAF 即時播放功能 | 是 | |
常見媒體用戶端資料 (CMCD) | 是 | 整合指南 |
使用 MediaItem
如要播放 DASH 串流,您需要依附 DASH 模組。
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
接著,您可以建立 DASH MPD URI 的 MediaItem
,並將其傳送至播放器。
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();
如果 URI 結尾不是 .mpd
,您可以傳遞 MimeTypes.APPLICATION_MPD
MediaItem.Builder
的 setMimeType
以明確指出
內容。
ExoPlayer 會根據 資訊清單,將可用頻寬和裝置功能納入考量。
使用 DashMediaSource
如需更多自訂選項,可以建立並傳遞 DashMediaSource
而不是 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();
存取資訊清單
您可以呼叫 Player.getCurrentManifest
擷取目前的資訊清單。
針對 DASH 您應將傳回的物件轉換為 DashManifest
。
此外,每當系統呼叫 Player.Listener
的 onTimelineChanged
回呼時,系統也會呼叫
資訊清單已載入完成這在隨選內容上只會發生一次
直播內容可能會多次下列程式碼片段說明應用程式如何
任何資訊清單載入都能執行。
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. } } });
自訂播放方式
ExoPlayer 提供多種功能,您可以配合個人 對應用程式的需求而言如需示例,請參閱「自訂」頁面。