ExoPlayer 支援採用 FMP4 容器格式的 SmoothStreaming,媒體串流 都必須經過模擬,也就是說影片、音訊和文字都必須具有獨特性 SmoothStreaming 資訊清單中的 StreamIndex 元素。包含音訊和 您也必須支援影片樣本格式 (請參閱 範例格式一節)。
功能 | 支援 | 留言 |
---|---|---|
容器 | ||
FMP4 | 是 | 僅限 Demuxed 串流 |
隱藏式輔助字幕/字幕 | ||
TTML | 是 | 內嵌於 FMP4 |
內容保護 | ||
PlayReady SL2000 | 是 | 僅 Android TV |
即時播放 | ||
定期即時播放 | 是 | |
常見媒體用戶端資料 (CMCD) | 是 | 整合指南 |
使用 MediaItem
如要播放 SmoothStreaming 串流,你必須使用 SmoothStreaming 後續課程我們將逐一介紹 預先訓練的 API、AutoML 和自訂訓練
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.4.1"
接著,您可以針對 SmoothStreaming 資訊清單 URI 建立 MediaItem
,並傳遞給
傳遞到播放器中
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(ssUri)) // 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(ssUri)); // Prepare the player. player.prepare();
如果 URI 結尾不是 .ism/Manifest
,則可以傳遞
將 MimeTypes.APPLICATION_SS
到 setMimeType
個 (共 MediaItem.Builder
個) 以明確表示
指出內容類型
ExoPlayer 會根據 資訊清單,將可用頻寬和裝置功能納入考量。
使用 SsMediaSource
如需更多自訂選項,可以建立並傳遞 SsMediaSource
而不是 MediaItem
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a SmoothStreaming media source pointing to a manifest uri. val mediaSource: MediaSource = SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a SmoothStreaming media source pointing to a manifest uri. MediaSource mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)); // Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
存取資訊清單
您可以呼叫 Player.getCurrentManifest
擷取目前的資訊清單。
針對 SmoothStreaming,您應將傳回的物件轉換為 SsManifest
。
此外,每當系統呼叫 Player.Listener
的 onTimelineChanged
回呼時,系統也會呼叫
資訊清單已載入完成這在隨選內容上只會發生一次
直播內容可能會多次下列程式碼片段說明應用程式如何
任何資訊清單載入都能執行。
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is SsManifest) { // 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) { SsManifest ssManifest = (SsManifest) manifest; // Do something with the manifest. } } });
自訂播放方式
ExoPlayer 提供多種功能,您可以配合個人 對應用程式的需求而言如需示例,請參閱「自訂」頁面。