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.3.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.3.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 提供多種方式,您可以根據應用程式需求自訂播放體驗。如需示例,請參閱「自訂」頁面。