Media3

媒體用途的支援程式庫。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 2 月 22 日 1.3.0 - - -

宣告依附元件

如果要為 Media3 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

dependencies {
    def media3_version = "1.3.0"

    // For media playback using ExoPlayer
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // For DASH playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // For HLS playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // For SmoothStreaming playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version"
    // For RTSP playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version"
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation "androidx.media3:media3-exoplayer-midi:$media3_version"
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    // For loading data using the Cronet network stack
    implementation "androidx.media3:media3-datasource-cronet:$media3_version"
    // For loading data using the OkHttp network stack
    implementation "androidx.media3:media3-datasource-okhttp:$media3_version"
    // For loading data using librtmp
    implementation "androidx.media3:media3-datasource-rtmp:$media3_version"

    // For building media playback UIs
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

    // For exposing and controlling media sessions
    implementation "androidx.media3:media3-session:$media3_version"

    // For extracting data from media containers
    implementation "androidx.media3:media3-extractor:$media3_version"

    // For integrating with Cast
    implementation "androidx.media3:media3-cast:$media3_version"

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version"

    // For transforming media files
    implementation "androidx.media3:media3-transformer:$media3_version"

    // For applying effects on video frames
    implementation "androidx.media3:media3-effect:$media3_version"

    // For muxing media files
    implementation "androidx.media3:media3-muxer:$media3_version"

    // Utilities for testing media components (including ExoPlayer components)
    implementation "androidx.media3:media3-test-utils:$media3_version"
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation "androidx.media3:media3-test-utils-robolectric:$media3_version"

    // Common functionality for reading and writing media containers
    implementation "androidx.media3:media3-container:$media3_version"
    // Common functionality for media database components
    implementation "androidx.media3:media3-database:$media3_version"
    // Common functionality for media decoders
    implementation "androidx.media3:media3-decoder:$media3_version"
    // Common functionality for loading data
    implementation "androidx.media3:media3-datasource:$media3_version"
    // Common functionality used across multiple media libraries
    implementation "androidx.media3:media3-common:$media3_version"
}

Kotlin

dependencies {
    val media3_version = "1.3.0"

    // For media playback using ExoPlayer
    implementation("androidx.media3:media3-exoplayer:$media3_version")

    // For DASH playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-dash:$media3_version")
    // For HLS playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-hls:$media3_version")
    // For SmoothStreaming playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version")
    // For RTSP playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version")
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation("androidx.media3:media3-exoplayer-midi:$media3_version")
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-ima:$media3_version")

    // For loading data using the Cronet network stack
    implementation("androidx.media3:media3-datasource-cronet:$media3_version")
    // For loading data using the OkHttp network stack
    implementation("androidx.media3:media3-datasource-okhttp:$media3_version")
    // For loading data using librtmp
    implementation("androidx.media3:media3-datasource-rtmp:$media3_version")

    // For building media playback UIs
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation("androidx.media3:media3-ui-leanback:$media3_version")

    // For exposing and controlling media sessions
    implementation("androidx.media3:media3-session:$media3_version")

    // For extracting data from media containers
    implementation("androidx.media3:media3-extractor:$media3_version")

    // For integrating with Cast
    implementation("androidx.media3:media3-cast:$media3_version")

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version")

    // For transforming media files
    implementation("androidx.media3:media3-transformer:$media3_version")

    // For applying effects on video frames
    implementation("androidx.media3:media3-effect:$media3_version")

    // For muxing media files
    implementation("androidx.media3:media3-muxer:$media3_version")

    // Utilities for testing media components (including ExoPlayer components)
    implementation("androidx.media3:media3-test-utils:$media3_version")
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation("androidx.media3:media3-test-utils-robolectric:$media3_version")

    // Common functionality for reading and writing media containers
    implementation("androidx.media3:media3-container:$media3_version")
    // Common functionality for media database components
    implementation("androidx.media3:media3-database:$media3_version")
    // Common functionality for media decoders
    implementation("androidx.media3:media3-decoder:$media3_version")
    // Common functionality for loading data
    implementation("androidx.media3:media3-datasource:$media3_version")
    // Common functionality used across multiple media libraries
    implementation("androidx.media3:media3-common:$media3_version")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋:

您的意見可協助我們改善 Jetpack。您可以使用 Media3 Issue Tracker 尋找問題的答案、已知問題和功能要求,以及提出新問題。

1.3.0 版

1.3.0 版

2024 年 3 月 6 日

發布了 androidx.media3:media3-*:1.3.0。1.3.0 版包含這些修訂版本

  • 常見程式庫:
    • 實作對 android.resource://package/[type/]name 原始資源 URI 的支援,其中 package 與目前應用程式的套件不同。一直以來,我們都記錄過這個問題,不過現在才沒有正確實作。
    • 將由應用程式程式碼設定的 MIME 類型正規化,或從媒體讀取以完全小寫。
    • 定義 AdPlaybackState 中使用完整的 MediaItem (而非單一 Uri) 的廣告。
    • minSdk 調高至 19 (Android KitKat)。這項資訊與所有其他 AndroidX 程式庫一致,這也是我們升級至 AndroidX 依附元件的必要條件。
    • 如有至少一個 artworkUriartworkData 為非空值,則在 MediaMetadata.Builder.populate(MediaMetadata) 中填入該值 (#964)。
  • ExoPlayer:
    • 新增 PreloadMediaSourcePreloadMediaPeriod,讓應用程式在播放前,於特定開始位置預先載入內容媒體來源。PreloadMediaSource 會負責準備內容媒體來源以接收 Timeline、準備及快取指定起始位置的時段,然後選取該時段的曲目和載入媒體資料。應用程式會實作 PreloadMediaSource.PreloadControl,並將預先載入的來源設為播放器進行播放,藉此控制預先載入的進度。
    • 新增 ExoPlayer.setImageOutput,可讓應用程式設定 ImageRenderer.ImageOutput
    • DefaultRenderersFactory 現在預設會為玩家提供 ImageRenderer,並提供空值的 ImageOutputImageDecoder.Factory.DEFAULT
    • 略過靜音時發出 Player.Listener.onPositionDiscontinuity 事件 (#765)。
    • 新增在擷取期間剖析字幕的實驗性支援。如要啟用這項功能,請使用 MediaSource.Factory.experimentalParseSubtitlesDuringExtraction()
    • 使用 PreloadMediaSource 支援自動調整媒體來源。
    • 使用 HttpEngine API 實作 HttpEngineDataSource,也就是 HttpDataSource
    • 避免將 CompositeSequenceableLoader 設為子類別。這個元件先前設為可擴充,但從未在程式庫中產生子類別。如要自訂,可以使用裝飾器模式包裝執行個體,並導入自訂的 CompositeSequenceableLoaderFactory
    • 修正重複相同時間會導致這個項目的中繼資料遭到清除的問題 (#1007)。
    • BundledChunkExtractor.FactoryDefaultHlsExtractorFactory 上的 experimentalSetSubtitleParserFactory 方法重新命名為 setSubtitleParserFactory,並禁止傳遞 null。使用新的 experimentalParseSubtitlesDuringExtraction(boolean) 方法控管剖析行為。
    • 開始支援自訂擷取期間使用的 SubtitleParser.Factory。您可以使用 MediaSource.Factory.setSubtitleParserFactory() 完成這項操作。
    • 將來源前置字串新增至從 MergingMediaSource 產生的所有 Format.id 欄位。這有助於識別產生 Format 的來源。(#883)。
    • 修正用於驗證自訂通用媒體用戶端資料 (CMCD) 金鑰名稱的規則運算式,方法是修改該鍵,使其僅檢查連字號 (#1028)。
    • 停止對 CMCD 查詢參數進行雙重編碼 (#1075)。
  • 轉換程式:
    • 新增對 H.265/HEVC SEF 慢動作影片的支援功能。
    • 加快轉譯速度,尤其是編輯「移除影片」時。
    • 新增 API,確保輸出檔案會在影片畫面中開始播放。這可讓剪輯作業的輸出內容與播放器實作項目更相容,因為播放器實作項目只會在顯示時間戳記之前顯示第一個視訊影格 (#829)。
    • 支援將單一資產 MP4 剪輯作業最佳化。
    • 新增支援,確保影片影格在輸出檔案中擁有第一個時間戳記。修正 iOS 播放器中以黑色畫面開頭的輸出檔案 (#829)。
  • 選取曲目:
    • 新增 DefaultTrackSelector.selectImageTrack 即可啟用圖片音軌選取功能。
    • 新增 TrackSelectionParameters.isPrioritizeImageOverVideoEnabled,以判斷是否要同時選取圖片軌和視訊軌。預設值為 false,表示系統會優先選取影片音軌。
  • 擷取工具:
    • 在 MP4 擷取器中新增額外的 AV1C 剖析,以擷取 ColorInfo.colorSpaceColorInfo.colorTransferColorInfo.colorRange 值 (#692)。
    • MP3:使用固定位元率 (CBR) 搜尋具有 Info 標頭 (相當於 Xing 標頭的 CBR) 的檔案。我們之前是使用 Info 標頭中的搜尋資料表,但相較於忽略並假設檔案為 CBR,這樣搜尋的精確度就會較低。
    • MPEG2-TS:新增 DTS、DTS-LBR 和 DTS:X Profile2 支援 (#275)。
    • 從 TS 描述元擷取音訊類型,並將其對應至角色旗標,讓使用者做出更明智的音軌選取 (#973)。
  • 音訊:
    • 運用順暢的音量適應力改善靜音略過演算法;保留最小靜音和更自然靜音持續時間 (#7423)。
    • 更準確地回報略過的靜音部分。(#1035)。
  • 影片:
    • 變更接受 VideoFrameProcessor.Factory 引數的 MediaCodecVideoRenderer 建構函式,將其替換為接受 VideoSinkProvider 引數的建構函式。想要插入自訂 VideoFrameProcessor.Factory 的應用程式,可將使用自訂 VideoFrameProcessor.FactoryCompositingVideoSinkProvider 執行個體化,並將影片接收器供應器傳遞給 MediaCodecVideoRenderer
  • 文字:
    • 修正點陣圖提示序列化,以解決使用 DefaultExtractorsFactory.setTextTrackTranscodingEnabled 時發生的 Tried to marshall a Parcel that contained Binder objects 錯誤。(#836)。
    • CEA-708:忽略 rowLock 值。CEA-708-E S-2023 規格表示,無論串流中出現的值為何,都應將 rowLockcolumnLock 皆確定為 true (系統不會實作 columnLock 支援,因此實際上會假設一律為 false)。
  • 圖片:
    • 新增對 DASH 縮圖的支援。格線圖片會經過裁剪,並提供個別縮圖給接近呈現時間的 ImageOutput
  • DRM:
  • IMA 擴充功能:
    • 修正無法播放缺少適當副檔名的 DASH 和 HLS 廣告。
  • 工作階段:
    • 停用 TV 應用程式的按兩下偵測 (#962)。
    • 修正在媒體控制器和工作階段之間,不會傳輸僅含非空值額外項目的 MediaItem.RequestMetadata 的問題。
    • MediaLibrarySession.Builder 中新增只採用 Context (而非 MediaLibraryService) 的建構函式。
  • HLS 擴充功能:
    • HlsMediaPeriod 縮減為套件私有瀏覽權限。此類型不應直接依賴 HLS 套件外部。
    • 解析會更有效率地前往片段開頭。(#1031)。
  • 解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等):
    • MIDI 解碼器:忽略 SysEx 事件訊息 (#710)。
  • 測試公用程式:
    • 不要在 TestPlayerRunHelper.playUntilPosition 中暫停播放。測試會將播放保持在播放狀態,但會暫停進度,直到測試能夠新增斷言和進一步動作為止。
  • 試用版應用程式..
    • 新增短篇示範模組,以示範在短篇內容用途中使用 PreloadMediaSource 的用法。

1.3.0-rc01 版

2024 年 2 月 22 日

使用 1.3.0 穩定版

1.3.0-beta01 版

2024 年 2 月 7 日

使用 1.3.0 穩定版

1.3.0-alpha01 版

2024 年 1 月 15 日

使用 1.3.0 穩定版

1.2.0 版

1.2.1 版

2024 年 1 月 9 日

  • ExoPlayer:
    • 修正手動搜尋超出 LiveConfiguration.min/maxOffset 範圍的問題:將偏移值調整回 min/maxOffset 的問題。
    • 修正 OPUS 和 VORBIS 管道版面配置不適用於 3、5、6、7 和 8 個管道的問題 (#8396)。
    • 修正以下問題:在直播活動中跳轉至零後,追蹤選項無法正確讓串流從預設位置開始 (#9347)。
    • 修正新的 CmcdData.Factory 例項從區塊來源接收 bufferedDurationUs 的負值值,導致 IllegalArgumentException 的問題。(#888)。
  • 轉換程式:
    • 解決編碼器因設定高作業率而在設定時擲回的問題。
  • 擷取工具:
    • 將 JPEG 動態相片中的次要 (無法播放) HEVC 音軌標示為 ROLE_FLAG_ALTERNATE,避免這些項目因解析度較高而自動選取播放。
    • 修正 TS H264 串流的錯誤主要畫面格偵測錯誤 (#864)。
    • 修正 TS 串流超過 47721 秒的時間長度 (#855)。
  • 音訊:
    • 修正多次呼叫 SilenceSkippingAudioProcessor 時對 EOS 的處理方式 (#712)。
  • 影片:
    • 針對 Galaxy Tab S7 FE、Chromecast (支援 Google TV) 和 Lenovo M10 FHD Plus 中的裝置問題新增解決方法,導致系統將 60fps AVC 串流標示為不支援的 (#693)。
  • 中繼資料:
    • 修正僅透過使用大寫鍵的 Vorbis 註解填入 MediaMetadata 的錯誤。(#876)。
    • 在剖析非常大型的 ID3 影格時擷取 OutOfMemoryError,表示播放可以在沒有標記資訊的情況下繼續,而不會完全播放失敗。
  • DRM:
    • 將假的 ClearKey https://default.url 授權網址解決方法延伸至 API 33 以上版本 (先前這個解決方法僅適用於 API 33) (#837)。
    • 修正以下問題:從加密模式切換至未附加途徑的清除內容時,發生 ERROR_DRM_SESSION_NOT_OPENED 的問題。這個錯誤是因不正確使用安全解碼器播放明確內容所致。
  • 工作階段:
    • 將自訂鍵和值置入 MediaMetadataCompatMediaMetadata.extras,並將 MediaMetadata.extras 放入 MediaMetadataCompat (#756#802)。
    • 修正舊版控制器的廣播 notifyChildrenChanged 問題 (#644)。
    • 修正錯誤:針對已停用的通知 setWhen 計時器設定排除時間,導致部分裝置上造成當機。(#903)。
    • 修正在系統收到第一次通知更新時,媒體通知控制器未完成連線作業的 IllegalStateException 問題 (#917)。
  • UI:
    • 修正在 BottomSheetDialogFragment 中與 Material Design 搭配使用時,無法使用前進和倒轉按鈕的問題 (#511)。
    • 修正 PlayerControlView 快速快轉按鈕中的數字未對齊的問題 (#547)。
  • DASH 擴充功能:
    • 在 DASH 資訊清單中,將「f800」剖析為 Dolby 的通道數量 (#688)。
  • 解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等):
    • MIDI:修正向前跳轉略過計畫變更事件的問題 (#704)。
    • 遷移至 FFmpeg 6.0,並將支援的 NDK 更新至 r26b (#707#867)。
  • Cast 擴充功能:
    • 清理 Timeline 建立作業,在投放裝置載入媒體失敗時,不會使應用程式當機。(#708)。

1.2.0 版

2023 年 11 月 15 日

  • 常見程式庫:
    • @Nullable Throwable 參數新增至 Log.Logger 介面中的方法。這些方法的 message 參數不再包含傳遞至 Log.{d,i,w,e}() 方法的 Throwable 的任何相關資訊,因此實作需要視需要手動附加這項資訊 (可能使用 Logger.appendThrowableString(String, Throwable))。
    • 修正 Kotlin 相容性問題:系統不會將可為空值的一般類型參數和可為空值的陣列元素類型偵測為可為空值。例如 TrackSelectorResultSimpleDecoder 方法參數 (#6792)。
    • 變更 Util.shouldShowPlayButton 中的預設 UI 和通知行為,讓播放暫時被暫停 (例如因為短暫的音訊焦點失去情形) 顯示「播放」按鈕。舊版行為可以使用 PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false)MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) 加以維護 (#11213)。
    • androidx.annotation:annotation-experimental 升級至 1.3.1 即可修正 https://issuetracker.google.com/251172715。
    • ExoPlayer.setAudioAttributes 移至 Player 介面。
  • ExoPlayer:
    • 修正因無法正確識別僅限解碼樣本而導致 AC4 串流中的尋找問題。(#11000)。
    • 透過 ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput 啟用這項功能時,在不合適的音訊輸出裝置 (例如 Wear OS 裝置的內建喇叭) 上加入抑製播放功能。如果在沒有合適的音訊輸出可用時嘗試播放,或是在播放期間所有合適輸出都中斷連線,則播放抑制原因將更新為 Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT。連接合適的輸出內容時,系統就會移除隱藏原因。
    • 新增 MediaSource.canUpdateMediaItemMediaSource.updateMediaItem,以便在透過 Player.replaceMediaItem(s) 建立後接受 MediaItem 更新。
    • 允許程式庫透過 Player.replaceMediaItem(s) 提供的所有 MediaSource 類別更新 MediaItem (#33#9978)。
    • MimeTypes.TEXT_EXOPLAYER_CUES 重新命名為 MimeTypes.APPLICATION_MEDIA3_CUES
    • 新增 PngExtractor,可將整個 PNG 檔案傳送及讀取至 TrackOutput 做為範例。
    • SequenceableLoader 介面中的 SequenceableLoader.continueLoading(long) 方法強化為 SequenceableLoader.continueLoading(LoadingInfo loadingInfo)LoadingInfo 包含 playbackSpeedlastRebufferRealtimeMs 在現有的 playbackPositionUs 等其他參數。
    • ChunkSource 介面中的 ChunkSource.getNextChunk(long, long, List, ChunkHolder) 方法強化為 ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder)
    • 在「通用媒體用戶端資料」(CMCD) 記錄中新增額外欄位:緩衝區星號 (bs)、期限 (dl)、播放速率 (pr) 和啟動 (su) (#8699)。
    • 將 Luma 和色域位元深度新增至 ColorInfo (#491)。
    • 在「通用媒體用戶端資料」(CMCD) 記錄中新增額外欄位:下一個物件要求 (nor) 和下一個範圍要求 (nrr) (#8699)。
    • 新增使用查詢參數 (#553) 傳輸通用媒體用戶端資料 (CMCD) 資料的功能。
    • 修正 ExperimentalBandwidthMeter 中的 ConcurrentModificationException。(#612)。
    • MediaPeriodId 參數新增至 CompositeMediaSource.getMediaTimeForChildMediaTime
    • 支援 ConcatenatingMediaSource2 中的 ClippingMediaSource (以及具有時段/時間範圍偏移的其他來源)。(#11226)。
    • 變更 BaseRenderer.onStreamChanged() 即可一併接收 MediaPeriodId 引數。
  • 轉換程式:
    • 剖析圖片輸入的 EXIF 旋轉資料。
    • 移除 TransformationRequest.HdrMode 註解類型及其相關常數。請改用 Composition.HdrMode 及其相關常數。
    • 簡化 OverlaySettings 來修正旋轉問題。
    • 已將 SampleConsumer.queueInputBitmapframeRatedurationUs 參數變更為 TimestampIterator
  • 選取曲目:
    • 新增 DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness 以明確允許或禁止不流暢調整。預設將沿用目前的 true 行為。
  • 擷取工具:
    • MPEG-TS:將串流的最後一個存取單位傳遞至範例佇列,確保轉譯最後一個影格。(#7909)。
    • 修正判定 rotationDegrees 時的錯字。已將 projectionPosePitch 變更為 projectionPoseRoll (#461)。
    • 移除假設可使用 instanceof 直接檢查 Extractor 執行個體。如果想在執行階段存取 Extractor 的實作詳細資料,必須先呼叫 Extractor.getUnderlyingInstance
    • 新增 BmpExtractor
    • 新增 WebpExtractor
    • 新增 HeifExtractor
    • Mp4Extractor 新增 QuickTime Classic 支援。
  • 音訊:
    • 新增 MP4 和 Matroska 中 24/32 位元大端 PCM 的支援,並在 MP4 中剖析 lpcm 的 PCM 編碼。
    • 新增在 MP4 中擷取 Vorbis 音訊的支援。
    • 新增 AudioSink.getFormatOffloadSupport(Format),用於擷取卸載層級支援接收器,可透過 DefaultAudioOffloadSupportProvider 提供格式。該函式會傳回包含 isFormatSupportedisGaplessSupportedisSpeedChangeSupported 的新 AudioOffloadSupport
    • 新增 AudioSink.setOffloadMode(),以便設定音訊接收器上的卸載設定。預設值為 AudioSink.OFFLOAD_MODE_DISABLED
    • 您可以透過 TrackSelectionParameters 中的 setAudioOffloadPreference 啟用卸載。如果偏好設定設為啟用,裝置就會支援該格式的卸載,而音軌選取是單一音軌,系統將啟用音訊卸載。
    • 如果將 audioOffloadModePreference 設為 AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIREDDefaultTrackSelector 就只會選取音軌,且只有在卸載時支援該音軌格式。如果在卸載時未支援任何音軌,系統就不會選取任何音軌。
    • 追蹤轉換後發生播放位置問題,因此在 API 級別 33 之前,停用卸載支援。
    • DefaultRenderersFactory.buildAudioSink 方法簽章中移除參數 enableOffload
    • 移除方法 DefaultAudioSink.Builder.setOffloadMode
    • 移除 intdef 值 DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED
    • 新增在卸載播放期間對 Opus 無間隙中繼資料的支援。
    • 如果首次寫入失敗,請停用卸載功能,允許轉譯器復原作業。(#627)。
    • 針對純音訊卸載播放預設啟用卸載排程功能。
    • 刪除 ExoPlayer.experimentalSetOffloadSchedulingEnabledAudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged
    • 已將 onExperimentalSleepingForOffloadChanged 重新命名為 onSleepingForOffloadChanged,並將 onExperimentalOffloadedPlayback 重新命名為 onOffloadedPlayback
    • 將音訊卸載模式相關的 TrackSelectionParameters 介面和定義移至內部 AudioOffloadPreferences 類別。
    • onAudioTrackInitializedonAudioTrackReleased 回呼新增至 AnalyticsListenerAudioRendererEventListenerAudioSink.Listener
    • 修正 DTS Express 音訊緩衝區反向溢位問題 (#650)。
    • 修正 E-AC3-JOC 的功能檢查擲回 IllegalArgumentException 的錯誤。(#677)。
  • 影片:
    • 允許 MediaCodecVideoRenderer 使用自訂 VideoFrameProcessor.Factory
    • 修正音訊串流起始時間戳記為負值時,無法轉譯第一個影格的錯誤。(#291)。
  • 文字:
    • 移除 ExoplayerCuesDecoder。包含 sampleMimeType = application/x-media3-cues 的文字軌現在由 TextRenderer 直接處理,不需使用 SubtitleDecoder 執行個體。
  • 中繼資料:
    • 系統不會再針對「僅限解碼」範例呼叫 MetadataDecoder.decode,因為實作時仍必須傳回空值。
  • 效果:
    • 新增依時間戳記將點陣圖輸入排入佇列的 VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>)
    • VideoFrameProcessor.registerInputStream() 變更為非封鎖式。應用程式必須實作 VideoFrameProcessor.Listener#onInputStreamRegistered()
    • 已將 VideoFrameProcessor.queueInputBitmapframeRatedurationUs 參數變更為 TimestampIterator
  • IMA 擴充功能:
    • 修正多時段 DASH 直播 (不是播放清單中第一個項目) 擲回例外狀況的錯誤 (#571)。
    • 在呼叫 AdsLoader.destroy() 前請先釋出 StreamManager
    • 將 IMA SDK 版本遞增升級至 3.31.0。
  • 工作階段:
    • DefaultMediaNotificationProvider 中的通知前景服務行為設為 FOREGROUND_SERVICE_IMMEDIATE。(#167)。
    • 請只使用 API 31 以上的 android.media.session.MediaSession.setMediaButtonBroadcastReceiver(),以免 Samsung 裝置上已淘汰的 API 發生問題。(#167)。
    • 使用媒體通知控制器做為 Proxy,即可設定可用指令和自訂版面配置,用來填入通知和平台工作階段。
    • 轉換 MediaSessionService.onStartCommand() 在 Media3 中收到的媒體按鈕事件,而非將其轉送至平台工作階段和 Media3。如此一來,呼叫端控制器一律是媒體通知控制器,應用程式可以輕鬆辨識來自通知的呼叫,方法與所有支援的 API 級別相同。
    • 修正 MediaController.getCurrentPosition() 在連線至舊版 MediaSessionCompat 時無法提升的錯誤。
    • 新增 MediaLibrarySession.getSubscribedControllers(mediaId) 以使用方便。
    • 覆寫 MediaLibrarySession.Callback.onSubscribe() 以斷言控制器訂閱的父項 ID 是否可用。如果成功,系統會立即接受訂閱,並立即呼叫 notifyChildrenChanged(),通知瀏覽器。(#561)。
    • 新增 Automotive OS 的工作階段示範模組,並啟用 Android Auto 的工作階段示範。
    • 當媒體通知控制器無法使用 COMMAND_GET_TIMELINE 時,請勿設定架構工作階段的佇列。在 Android Auto 做為用戶端控制器讀取架構工作階段時,Android Auto 使用者介面中的 queue 按鈕會一併顯示 (#339)。
    • 預設使用 DataSourceBitmapLoader,而非 SimpleBitmapLoader (#271#327)。
    • 新增 MediaSession.Callback.onMediaButtonEvent(Intent),可讓應用程式覆寫預設的媒體按鈕事件處理程序。
  • UI:
    • 為 Wear OS 裝置新增 Player.Listener 實作方式,以便處理因 Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT 造成的播放抑製作業,方法是啟動系統對話方塊,讓使用者連線至合適的音訊輸出內容 (例如藍牙耳機)。如果在可設定的逾時時間 (預設為 5 分鐘) 內連線到合適的裝置,事件監聽器就會自動繼續播放。
  • 下載內容:
    • DownloadService 宣告「資料同步處理」前景服務類型,以便與 Android 14 相容。使用這項服務時,應用程式也必須在資訊清單中將 dataSync 新增為 foregroundServiceType,並新增 FOREGROUND_SERVICE_DATA_SYNC 權限 (#11239)。
  • HLS 擴充功能:
    • 使用從上次載入開始時間 (而非上次載入完成時間) 計算的間隔重新整理 HLS 即時播放清單 (#663)。
  • DASH 擴充功能:
    • 區隔範本網址允許使用多個相同的 DASH ID。
    • 新增在擷取期間剖析字幕的實驗性支援。這樣做對於合併重疊的字幕有更好的支援,包括解決在字幕片段之間切換時閃爍的問題。如要啟用這項功能,請使用 DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction()。(#288)。
  • RTSP 擴充功能:
    • 修正在返回 TCP 時可能引發 IndexOutOfBoundsException 的競爭狀況,或在某些情況下發生播放停止運作的問題。
    • 傳回 RtspMediaPeriod 的載入狀態時,檢查 RTSP 設定中的狀態。(#577)。
    • 在選項回應公開標頭中忽略自訂 Rtsp 要求方法 (#613)。
    • 在傳送保持運作 RTSP 選項要求的時間間隔,使用 RTSP 設定回應逾時值 (#662)。
  • 解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等):
    • 發布 MIDI 解碼器模組,該模組支援使用 Jsyn 程式庫合成音訊的標準 MIDI 檔案。
    • 新增 DecoderOutputBuffer.shouldBeSkipped 即可直接標記不需要呈現的輸出緩衝區。比起即將淘汰的 C.BUFFER_FLAG_DECODE_ONLY,請優先採用。
    • 新增 Decoder.setOutputStartTimeUsSimpleDecoder.isAtLeastOutputStartTimeUs,讓解碼器在開始時間之前捨棄僅限解碼的範例。請優先採用即將淘汰的 Buffer.isDecodeOnly
    • 修正將 MIDI 解碼器構件發布至 Maven 存放區的錯誤。構件已重新命名為 media3-exoplayer-midi (#734)。
  • Leanback 擴充功能:
    • 修正停用介面可能導致 Leanback 程式碼發生 ArithmeticException 的錯誤 (#617)。
  • 測試公用程式:
    • 請確保 TestExoPlayerBuilderFakeClock 與 Espresso UI 測試和 Compose UI 測試相容。修正在 Espresso 或 Compose 檢視畫面互動期間,播放時間沒有確定性的錯誤。
  • 移除已淘汰的符號:
    • 移除 TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean)TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean)。請改用 Composition.Builder.setHdrMode(int),並將 Composition 傳遞至 Transformer.start(Composition, String)
    • 移除已淘汰的 DownloadNotificationHelper.buildProgressNotification 方法,改用可接受 notMetRequirements 參數的非已淘汰方法。

1.2.0-rc01 版

2023 年 11 月 1 日

使用 1.2.0 穩定版

1.2.0-beta01 版

2023 年 10 月 19 日

使用 1.2.0 穩定版

1.2.0-alpha02 版

2023 年 9 月 29 日

使用 1.2.0 穩定版

1.2.0-alpha01 版

2023 年 8 月 17 日

使用 1.2.0 穩定版

1.1.0 版本

1.1.1 版

2023 年 8 月 16 日

  • 常見程式庫:
    • 從所有模組中移除意外新增的 multidex 依附元件。(#499)。
  • ExoPlayer:
    • 修正 PlaybackStatsListener 中的以下問題:在播放清單清除後,會建立錯誤的 PlaybackStats
    • 在「通用媒體用戶端資料」(CMCD) 記錄中新增額外欄位:串流格式 (sf)、串流類型 (st)、版本 (v)、頂端位元率 (tb)、物件時間長度 (d)、已測量的處理量 (mtp) 和物件類型 (ot) (#8699)。
  • 音訊:
    • 修正播放極短檔案時 Player.getState() 從未轉換成 STATE_ENDED 的錯誤。(#538)。
  • 音訊卸載:
    • 根據 RFC 7845 規定,在位元串流前將 Ogg ID 標頭和註解標頭網頁附加至位元串流,以便播放卸載的 Opus 播放。
  • 影片:
    • H.265/HEVC:修正剖析 SPS 短與長期參考相片資訊的問題。
  • 文字:
    • CEA-608:將提示截斷邏輯變更為只考慮顯示的文字。之前在將提示長度限制為 32 個字元 (在技術上來說是正確的) 時,已納入縮排和定位點偏移 (#11019)。
  • IMA 擴充功能:
    • 將 IMA SDK 版本遞增升級至 3.30.3。
  • 工作階段:
    • 在控制器狀態中加入自訂版面配置,並提供 getter 來存取。自訂版面配置變更時,系統會呼叫 MediaController.Listener.onCustomLayoutChanged。如果應用程式想要對不同的 Media3 控制器傳送不同自訂版面配置,可以在 MediaSession.Callback.onConnect 中使用AcceptedResultBuilder,確保在連線完成時,控制器可以使用自訂版面配置。
    • 修正 MediaLibraryServiceLegacyStub 傳送錯誤至不支援此情況的 Result,因此會產生 UnsupportedOperationException。(#78)。
    • 修正 PlayerWrapper 透過舊版指令 (COMMAND_ADJUST_DEVICE_VOLUMECOMMAND_SET_DEVICE_VOLUME) 和新指令 (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGSCOMMAND_SET_DEVICE_VOLUME_WITH_FLAGS) (#554) 確定 volumeControlType 的方式,從而建立 VolumeProviderCompat

1.1.0 版本

2023 年 7 月 5 日

  • 常見程式庫:
    • 為不適用的音訊路徑新增抑制原因,並在所準備變更原因 (抑制) 過長時播放。(#15)。
    • 為玩家新增指令:
      • COMMAND_GET_METADATA
      • COMMAND_SET_PLAYLIST_METADATA
      • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
      • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
    • 為 Player 新增超載方法,可讓使用者指定音量標記:
      • void setDeviceVolume(int, int)
      • void increaseDeviceVolume(int)
      • void decreaseDeviceVolume(int)
      • void setDeviceMuted(boolean, int)
    • DeviceInfo 新增 Builder,並淘汰現有的建構函式。
    • 新增 DeviceInfo.routingControllerId 即可指定遠端播放的路由控制器 ID。
    • 新增 Player.replaceMediaItem(s) 做為捷徑,以便在相同位置新增和移除項目 (#8046)。
  • ExoPlayer:
    • 只有在明確選擇啟用時,ExoPlayer 才能控制裝置音量方法。使用 ExoPlayer.Builder.setDeviceVolumeControlEnabled 即可存取:
      • getDeviceVolume()
      • isDeviceMuted()
      • setDeviceVolume(int)setDeviceVolume(int, int)
      • increaseDeviceVolume(int)increaseDeviceVolume(int, int)
      • decreaseDeviceVolume(int)decreaseDeviceVolume(int, int)
    • 新增 FilteringMediaSource,以從 MediaSource 篩選可用的測試群組類型。
    • 開始支援在自動調整串流格式 DASH、HLS 和 SmoothStreaming 的傳出要求中加入通用媒體用戶端資料 (CMCD)。下列欄位已納入 brblcidrtpsid (#8699)。API 結構和 API 方法:
      • CMCD 記錄預設為停用,請使用 MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory) 啟用。
      • 根據預設,所有金鑰都會啟用,請覆寫 CmcdConfiguration.RequestConfig.isKeyAllowed(String key) 以篩除記錄的金鑰。
      • 覆寫 CmcdConfiguration.RequestConfig.getCustomData() 即可啟用自訂金鑰記錄。
    • 在主要示範的資訊清單中新增額外動作,以便使用自訂 *.exolist.json 檔案啟動試用版應用程式 (#439)。
    • 新增 ExoPlayer.setVideoEffects(),以便在影片播放期間使用 Effect
    • 更新 SampleQueue,將 sourceId 儲存為 long 而非 int。這會變更公開方法 SampleQueue.sourceIdSampleQueue.peekSourceId 的簽名。
    • LoadControl 方法 shouldStartPlaybackonTracksSelected 新增參數,將這些方法與相關的 MediaPeriod 建立關聯。
    • 新增時間軸參數,其中包含對應至地圖上用 UID 的句點,進而變更 ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) 的簽名。這是為了避免多週期直播的並行問題。
    • 淘汰 EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs)BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs)。 可以改為呼叫沒有 mediaTimeOffsetUs 的方法變體。請注意,即使為已淘汰的變數,調度器所調度的 MediaLoadData 物件中也不會再新增偏移值 startTimeUsendTimeUs
    • ExoTrackSelection.blacklist 重新命名為 excludeTrack,並將 isBlacklisted 重新命名為 isTrackExcluded
    • 修正在空白播放清單上呼叫時,ExoPlayer.setMediaItem(s)addMediaItem(s) 之間的不一致行為。
  • 轉換程式:
    • 移除 Transformer.Builder.setMediaSourceFactory(MediaSource.Factory)。 改用 ExoPlayerAssetLoader.Factory(MediaSource.Factory)Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory)
    • 移除 Transformer.startTransformation(MediaItem, ParcelFileDescriptor)
    • 修正如果在輸入影格待處理時收到影片串流的訊號,轉換可能會卡住 (導致多工逾時) 錯誤。
    • 透過 MediaCodecList 查詢轉碼器 (而非使用 findDecoder/EncoderForFormat 公用程式),藉此擴大支援範圍。
    • 移除 DefaultEncoderFactory 中的 B Frame 設定,因為這項設定在某些裝置上無法運作。
  • 音軌選取:
    • 新增預設為停用的 DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange。啟用後,當轉譯器功能變更時,DefaultTrackSelector 會觸發新的音軌選取動作。
  • 擷取工具:
    • Ogg:修正長時間搜尋檔案時發生的錯誤。(#391)。
    • FMP4:修正 TimestampAdjuster 使用中繼資料取樣時間來自 emsg Atom 的問題,初始化錯誤的時間戳記偏移 (#356)。
  • 音訊:
    • 修正在已啟用通道且AudioProcessors啟用的情況下,部分播放作業失敗的錯誤,例如用於無間斷剪輯功能 (#10847)。
    • 在直接播放 (卸載) 中封裝 Ogg 封包中的 Opus 影格。
    • 使用卸載時間表,在睡眠期間推斷目前位置。
    • 新增 Renderer.release()AudioSink.release(),以便在玩家生命週期結束時釋出資源。
    • 監聽 DefaultAudioSink 中的音訊功能變更。在 DefaultAudioSink 的建構函式中加入必要參數 context,其中 DefaultAudioSink 會註冊為 AudioCapabilitiesReceiver 的事件監聽器,並在通知功能異動時更新其 audioCapabilities 屬性。
    • 透過 AudioSink.Listener 介面中的新事件 onAudioCapabilitiesChanged 以及觸發 onRendererCapabilitiesChanged 事件的新版介面 RendererCapabilities.Listener,來傳播音訊功能變更。
    • 新增 ChannelMixingAudioProcessor,以便對音訊頻道套用縮放/混合功能。
    • 將新的 int 值 DISCARD_REASON_AUDIO_BYPASS_POSSIBLE 新增至 DecoderDiscardReasons,以在音訊功能變更後有可能略過模式時捨棄音訊解碼器。
    • 新增 DTS Express 和 DTS:X 的直接播放支援 (#335)。
  • 影片:
    • 當轉譯器停用時,讓 MediaCodecVideoRenderer 回報寬度和高度為 0 的 VideoSize。當 Player.getVideoSize() 變更時,系統會據此呼叫 Player.Listener.onVideoSizeChanged。經過本次變更後,當 Player.getCurrentTracks 不支援影片,或尚未判斷支援視訊軌的大小時,使用 MediaCodecVideoRenderer 的 ExoPlayer 影片大小寬度和高度為 0。
  • DRM:
    • 減少在 DefaultDrmSession 上不應從 DRM 套件外部呼叫的多個僅限內部方法:
      • void onMediaDrmEvent(int)
      • void provision()
      • void onProvisionCompleted()
      • onProvisionError(Exception, boolean)
  • Muxer:
    • 新增可用於建立 MP4 容器檔案的 muxer 程式庫。
  • IMA 擴充功能:
    • 為 DAI 啟用多時段直播 DASH 串流。請注意,目前的實作方式尚未支援在直播中搜尋。(#10912)。
    • 修正直播中插入新廣告群組的錯誤,因為在連續時間軸中計算的內容位置會略有不同。
  • 工作階段:
    • 新增輔助方法 MediaSession.getControllerForCurrentRequest,以取得目前呼叫 Player 方法的控制器相關資訊。
    • 新增 androidx.media3.session.MediaButtonReceiver,可讓應用程式使用藍牙耳機等事件傳送的媒體按鈕事件,實作播放繼續作業。(#167)。
    • 將預設實作新增至 MediaSession.Callback.onAddMediaItems,允許在含有 LocalConfiguration (例如 URI) 的 MediaItems (例如 URI) 時,將要求傳遞至 Player (#282)。
    • 在精簡的媒體通知檢視畫面中,新增「前往上一個畫面」和「前往下一個」指令按鈕 (適用於 Android 12 以下版本)。(#410)。
    • 將預設實作新增至 MediaSession.Callback.onAddMediaItems,允許在含有 LocalConfiguration (例如 URI) 的 MediaItems (例如 URI) 時,將要求傳遞至 Player (#282)。
    • 在精簡的媒體通知檢視畫面中,新增「前往上一個畫面」和「前往下一個」指令按鈕 (適用於 Android 12 以下版本)。(#410)。
  • UI:
    • 新增公用程式方法 shouldShowPlayButtonhandlePlayPauseButtonAction,透過播放/暫停按鈕編寫自訂 UI 元素。
  • RTSP 擴充功能:
    • 針對 MPEG4-LATM,在說明回應 SDP 訊息中缺少時,使用預設的設定檔層級 ID 值 (#302)。
    • 如果 DESCRIBE 回應標頭中出現,則使用基本 URI 進行 RTSP 工作階段的相對路徑解析 (#11160)。
  • DASH 擴充功能:
    • MediaLoadData.startTimeMsMediaLoadData.endTimeMs 中移除多時段 DASH 串流的媒體時間偏移。
    • 修正重新準備多週期即時 Dash 媒體來源產生 IndexOutOfBoundsException 的錯誤 (#10838)。
  • HLS 擴充功能:
    • 新增 HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) 來設定逾時,讓載入執行緒等待 TimestampAdjuster 初始化。如果初始化未在逾時前完成,系統會擲回 PlaybackException,以免播放無止盡的延遲。逾時預設為零 (#323)。
  • 測試公用程式:
    • 檢查 DataSourceContractTest 中的 URI 配置不區分大小寫。
  • 移除已淘汰的符號:
    • 移除 DefaultAudioSink 建構函式,改用 DefaultAudioSink.Builder
    • 移除 HlsMasterPlaylist,請改用 HlsMultivariantPlaylist
    • 移除 Player.stop(boolean)。如果 resettrue,請改用 Player.stop()Player.clearMediaItems()
    • 移除兩個已淘汰的 SimpleCache 建構函式,請改用會接受 DatabaseProvider 的非淘汰建構函式,以提升效能。
    • 移除 DefaultBandwidthMeter 建構函式,請改用 DefaultBandwidthMeter.Builder
    • 移除 DefaultDrmSessionManager 建構函式,請改用 DefaultDrmSessionManager.Builder
    • 移除兩個已淘汰的 HttpDataSource.InvalidResponseCodeException 建構函式,請使用可接受額外欄位(causeresponseBody) 的非已淘汰建構函式來強化錯誤記錄。
    • 移除 DownloadHelper.forProgressiveDownloadHelper.forHlsDownloadHelper.forDashDownloadHelper.forSmoothStreaming,請改用 DownloadHelper.forMediaItem
    • 移除已淘汰的 DownloadService 建構函式,改用未淘汰的建構函式,當中包含提供 channelDescriptionResourceId 參數的選項。
    • 移除 Charsets 已淘汰的字串常數 (ASCII_NAMEUTF8_NAMEISO88591_NAMEUTF16_NAMEUTF16LE_NAME),請改用 kotlin.text 套件、java.nio.charset.StandardCharsetscom.google.common.base.Charsets 中的 Kotlin 字元集。
    • 移除已淘汰的 WorkManagerScheduler 建構函式,改用未淘汰的建構函式,其中含有改為提供 Context 參數的選項。
    • 移除用於將 Format 類別例項化的已淘汰方法 createVideoSampleFormatcreateAudioSampleFormatcreateContainerFormatcreateSampleFormat。請改用 Format.Builder 建立 Format 的例項。
    • 移除已淘汰的方法 copyWithMaxInputSizecopyWithSubsampleOffsetUscopyWithLabelcopyWithManifestFormatInfocopyWithGaplessInfocopyWithFrameRatecopyWithDrmInitDatacopyWithMetadatacopyWithBitratecopyWithVideoSize,改用 Format.buildUpon() 和 setter 方法。
    • 移除已淘汰的 ExoPlayer.retry(),請改用 prepare()
    • 移除已淘汰的零引數 DefaultTrackSelector 建構函式,請改用 DefaultTrackSelector(Context)
    • 移除已淘汰的 OfflineLicenseHelper 建構函式,請改用 OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)
    • 移除已淘汰的 DownloadManager 建構函式,改用可接受 Executor 的建構函式。
    • 移除已淘汰的 Cue 建構函式,請改用 Cue.Builder
    • 移除已淘汰的 OfflineLicenseHelper 建構函式,請改用 OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher)
    • 移除四個已淘汰的 AnalyticsListener 方法:
      • onDecoderEnabled,請改用 onAudioEnabled 和/或 onVideoEnabled
      • onDecoderInitialized,請改用 onAudioDecoderInitialized 和/或 onVideoDecoderInitialized
      • onDecoderInputFormatChanged,請改用 onAudioInputFormatChanged 和/或 onVideoInputFormatChanged
      • onDecoderDisabled,請改用 onAudioDisabled 和/或 onVideoDisabled
    • 移除已淘汰的 Player.Listener.onSeekProcessedAnalyticsListener.onSeekProcessed,請改用 onPositionDiscontinuity 搭配 DISCONTINUITY_REASON_SEEK
    • 移除 ExoPlayer.setHandleWakeLock(boolean),改用 setWakeMode(int)
    • 移除已淘汰的 DefaultLoadControl.Builder.createDefaultLoadControl(),請改用 build()
    • 移除已淘汰的 MediaItem.PlaybackProperties,請改用 MediaItem.LocalConfiguration。淘汰的欄位 MediaItem.playbackProperties 現在屬於 MediaItem.LocalConfiguration 類型。

1.1.0-rc01 版本

2023 年 6 月 21 日

使用 1.1.0 穩定版

1.1.0-beta01 版本

2023 年 6 月 7 日

使用 1.1.0 穩定版

1.1.0-alpha01 版

2023 年 5 月 10 日

使用 1.1.0 穩定版

1.0.0 版本

1.0.2 版

2023 年 5 月 18 日

發布了 androidx.media3:media3-*:1.0.21.0.2 版包含此連結所列的修訂項目。

此版本可對應至 ExoPlayer 2.18.7 版

這個版本包含下列自 1.0.1 版以來的變更:

  • 核心程式庫:
    • 新增 Buffer.isLastSample(),表示 Buffer 是否包含標記 C.BUFFER_FLAG_LAST_SAMPLE
    • 修正以下問題:在未讀取「串流結束」樣本的情況下,將最後一個影格的樣本從佇列移除時,系統可能無法轉譯最後一個影格。(#11079)。
  • 擷取工具:
    • 修正透過重複使用 RTSP 和 MP4 擷取器使用的剖析邏輯,在 MPEG-TS 檔案中剖析 H.265 SPS 的問題 (#303)。
  • 文字:
    • SSA:如果 UTF-16 檔案開頭為位元組順序標記,則新增對這類檔案的支援 (#319)。
  • 工作階段:
    • 修正當 MediaController 連線至會更新動作的舊版 MediaSessionCompat 時,不會更新可用指令的問題。
    • 修正導致 MediaLibraryService 無法在 API 30 上使用 params.isRecent == trueCallback.onGetLibraryRoot 呼叫傳回空值的錯誤 (#355)。
    • 修正 MediaSessionServiceMediaLibraryService 的記憶體流失問題 (#346)。
    • 修正 MediaSession 中組合 Timeline 和位置更新時可能會導致 MediaController 擲回 IllegalStateException 的錯誤。

1.0.1 版

2023 年 4 月 18 日

發布了 androidx.media3:media3-*:1.0.11.0.1 版包含以下修訂項目。

此版本可對應至 ExoPlayer 2.18.6 版

  • 核心程式庫:
    • 在跳轉至預設位置時,重設目標直播覆寫值 (#11051)。
    • 修正媒體中空白範例串流可能會導致播放停滯的錯誤。
  • 工作階段:
    • 修正錯誤:舊版 MediaSessionCompat 發布的多個相同佇列項目會導致 MediaController 發生例外狀況 (#290)。
    • 將缺少的 MediaSession.broadcastCustomCommand 轉送新增至舊版 MediaControllerCompat.Callback.onSessionEvent。(#293)。
    • 修正呼叫 MediaSession.setPlayer 時,無法更新可用指令的錯誤。
    • 修正TrackSelectionOverride透過 MediaController 傳送的執行個體,如果其參照的群組具有 Format.metadata (#296),系統會忽略該問題。
    • 修正需要使用 Player.COMMAND_GET_CURRENT_MEDIA_ITEM 透過舊版 MediaSessionCompat 存取中繼資料的問題。
    • 修正MediaSession在背景執行緒上執行個體導致 MediaSessionService 時發生當機的問題 (#318)。
    • 修正程式庫宣告媒體按鈕接收器,但應用程式不知情的情況下的問題。(#314)。
  • DASH:
    • 修正空白區隔時間軸的處理問題 (#11014)。
  • RTSP:
    • 如果 RTSP 設定使用 UDP 執行失敗,並顯示 RTSP 錯誤 461,則透過 TCP 重試 (#11069)。

1.0.0 版本

2023 年 3 月 22 日

發布了 androidx.media3:media3-*:1.0.01.0.0 版包含此連結所列的修訂項目。

此版本可對應至 ExoPlayer 2.18.5 版

自 1.0.0-rc02 以來沒有任何異動。

1.0.0-rc02 版

2023 年 3 月 2 日

發布了 androidx.media3:media3-*:1.0.0-rc02查看 1.0.0-rc02 版的修訂項

此版本可對應至 ExoPlayer 2.18.4 版

  • 核心程式庫:
    • 修正 API 33 的網路類型偵測問題。(#10970)。
    • 修正呼叫 ExoPlayer.isTunnelingEnabled 時發生的 NullPointerException (#10977)。
  • 下載內容:
    • 請將兩個片段的開始時間差異於 SegmentDownloader 和子類別中的設定合併。(#248)。
  • 音訊:
    • 修正在 Samsung 裝置上播放不透明 MP3 播放問題的問題。(#8594)。
    • 修正錯誤:在停用音訊後立即設定的播放速度可能會遭到先前的速度異動覆寫 (#10882)。
  • 影片:
    • 將 HEVC HDR10 格式對應至 HEVCProfileMain10HDR10 (而非 HEVCProfileMain10)。
    • 新增 Chromecast (支援 Google TV) 和 Lenovo M10 FHD Plus 的裝置問題,導致系統無法將 60fps AVC 串流標示為不支援的 (#10898)。
    • 修正播放影格速率高於螢幕刷新率的媒體時,影格版本效能問題。
  • 投放:
    • 修正在媒體項目之間轉換時暫時性 STATE_IDLE。(#245)。
  • RTSP:
    • 找出剖析無效 RTSP 描述回應訊息時擲回的 IllegalArgumentException 錯誤。(#10971)。
  • 工作階段:
    • 修正通知播放/暫停按鈕不會隨著玩家狀態更新的錯誤 (#192)。
  • IMA 擴充功能:
    • 修正導致無法啟動任何廣告的 DAI 串流作業,因為系統並未收到第一個 (且在缺少廣告的情況下) LOADED事件。

1.0.0-rc01 版本

2023 年 2 月 16 日

發布了 androidx.media3:media3-*:1.0.0-rc011.0.0-rc01 版包含以下修訂項目。

此版本可對應至 ExoPlayer 2.18.3 版

  • 核心程式庫:
    • 調整轉譯器的解碼器排序邏輯,以維持 MediaCodecSelector 的偏好設定,即使解碼器回報可能無法順利播放媒體亦然。舉例來說,在預設選取器中,系統會優先採用僅提供功能性支援的硬體解碼器,而非完全支援格式的軟體解碼器。(#10604)。
    • 新增 ExoPlayer.Builder.setPlaybackLooper,可為新的 ExoPlayer 執行個體設定既有的播放執行緒。
    • 允許清除下載管理員協助程式。(#10776)。
    • 新增參數至 BasePlayer.seekTo,以指示用於搜尋的指令。
    • 在 API 21 以上版本載入可繪項目時使用主題。(#220)。
    • 新增 ConcatenatingMediaSource2,允許將多個媒體項目合併至單一視窗。(#247)。
  • 擷取工具:
    • 剖析 trak atom 時,如果範例資料表 (stbl) 缺少必要的範例說明 (stsd),則請擲回 ParserException 而非 NullPointerException
    • 在 fMP4 中直接搜尋同步影格時,正確略過範例 (#10941)。
  • 音訊:
    • 使用壓縮的音訊格式位元率來計算直接播放 (直通) 中 AudioTrack 的緩衝區大小下限。
  • 文字:
    • 修正在字幕檔案不含提示的情況下,TextRenderer 將無效 (負數) 索引傳遞至 Subtitle.getEventTime 的問題。
    • SubRip:針對開頭為位元組順序標記的 UTF-16 檔案新增支援。
  • 中繼資料:
    • 依據 ID3 v2.4 的許可,從 ID3 影格剖析多個以空值分隔的值。
    • 新增 MediaMetadata.mediaType,來表示內容類型或中繼資料說明的資料夾類型。
    • 新增 MediaMetadata.isBrowsable 以取代 MediaMetadata.folderType。資料夾類型會在下一個版本中被淘汰。
  • DASH:
    • 為圖片調整集新增完整剖析功能,包括圖塊數量。(#3752)。
  • UI:
    • 修正已淘汰的 PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener),以確保瀏覽權限變更會傳遞至已註冊的事件監聽器。(#229)。
    • 修正使用從右到左 (RTL) 版面配置時,PlayerView 內中央播放器控制項的排序方式。(#227)。
  • 工作階段:
    • 新增抽象 SimpleBasePlayer,以協助實作自訂玩家的 Player 介面。
    • 新增輔助方法,以將平台工作階段符記轉換為 Media3 SessionToken (#171)。
    • 使用 onMediaMetadataChanged 來觸發平台媒體工作階段的更新作業。(#219)。
    • 將媒體工作階段新增為 DefaultMediaNotificationProvidergetMediaButtons() 引數,並使用不可變動的清單以確保清晰度。(#216)。
    • 新增 onSetMediaItems 回呼監聽器以提供修改/設定 MediaItem 清單的方式,在播放器上設定索引和位置之前,依工作階段起始索引和位置 (#156)。
    • 避免在非藍牙媒體按鈕事件上輕觸兩下偵測 (#233)。
    • 使 QueueTimeline 出現可疑的舊版工作階段狀態時更可靠 (#241)。
  • 中繼資料:
    • 依據 ID3 v2.4 的許可,從 ID3 影格剖析多個以空值分隔的值。
    • 新增 MediaMetadata.mediaType,來表示內容類型或中繼資料說明的資料夾類型。
    • 新增 MediaMetadata.isBrowsable 以取代 MediaMetadata.folderType。資料夾類型會在下一個版本中被淘汰。
  • Cast 擴充功能:
    • 將 Cast SDK 版本遞增升級至 21.2.0。
  • IMA 擴充功能:
    • 移除應用程式執行緒上 ImaServerSideAdInsertionMediaSource 的播放器監聽器,以免發生執行緒問題。
    • 將屬性 focusSkipButtonWhenAvailable 新增至 ImaServerSideAdInsertionMediaSource.AdsLoader.Builder,以要求在電視裝置上聚焦略過按鈕,並根據預設將其設定為 true。
    • 將方法 focusSkipButton() 新增至 ImaServerSideAdInsertionMediaSource.AdsLoader,以程式輔助方式要求聚焦略過按鈕。
    • 將 IMA SDK 版本遞增升級至 3.29.0。
  • 試用版應用程式..
    • 在執行階段要求下載通知的通知權限。(#10884)。

1.0.0-beta03 版

2022 年 11 月 22 日

發布了 androidx.media3:media3-*:1.0.0-beta031.0.0-beta03 版包含此連結所列的修訂項目。

此版本可對應至 ExoPlayer 2.18.2 版

  • 核心程式庫:
    • 新增 ExoPlayer.isTunnelingEnabled 來檢查目前所選的音軌是否已啟用通道。(#2518)。
    • 新增 WrappingMediaSource 來將換行簡化為 MediaSource。(#7279)。
    • 在播放因可用記憶體不足而卡住時捨棄背景緩衝區。
    • 啟用卸載時關閉追蹤「doSomeWork」區塊。
    • 修正 PlaybackStatsListener 中快速跳轉的工作階段追蹤問題。(#180)。
    • 在單一項目播放清單中呼叫 seekToNextseekToPrevious 時,傳送缺少的 onMediaItemTransition 回呼 (#10667)。
    • 新增 Player.getSurfaceSize,可傳回算繪影片的途徑大小。
    • 修正在播放器釋出期間移除事件監聽器會導致 IllegalStateException 的錯誤。(#10758)。
  • 版本:
    • 強制執行最低 compileSdkVersion,以避免編譯錯誤。(#10684)。
    • 避免包含在其他 Gradle 版本時,發布模塊。
  • 音軌選取:
    • 如果螢幕不支援它,則使用 Dolby Vision 的其他音軌。(#8944)。
  • 下載內容:
    • 修正由同一個 PriorityTaskManager 同時下載和播放而在 ProgressiveDownloader 中可能導致的無限迴圈 (#10570)。
    • 立即顯示下載通知。(#183)。
    • 將平行下載移除限制限制在 1 次,以免建立過多執行緒。(#10458)。
  • 影片:
    • 如果螢幕不支援 Dolby Vision,不妨試試替代解碼器。 (#9794)。
  • 音訊:
    • SingleThreadExecutor 用於發布 AudioTrack 執行個體,以免同時發布多個播放器時發生 OutOfMemory 錯誤。(#10057)。
    • 已針對 AudioTrack 卸載狀態新增 AudioOffloadListener.onExperimentalOffloadedPlayback。(#134)。
    • AudioTrackBufferSizeProvider 設為公開介面。
    • 新增 ExoPlayer.setPreferredAudioDevice 以設定偏好的音訊輸出裝置 (#135)。
    • androidx.media3.exoplayer.audio.AudioProcessor 重新命名為 androidx.media3.common.audio.AudioProcessor
    • 將 8 聲道和 12 聲道音訊對應到所有 Android 版本的 7.1 和 7.1.4 聲道遮罩 (#10701)。
  • 中繼資料:
    • 現在可以設定 MetadataRenderer,以在中繼資料可用時盡快轉譯。建立具有 MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean) 的執行個體,以指定轉譯器要否要提早輸出中繼資料,或與播放器位置同步。
  • DRM:
    • 解決 Android 13 ClearKey 實作中的錯誤,該錯誤會傳回非空白但無效的授權網址。
    • 修正在播放清單中切換數位版權管理配置 (例如 Widevine 至 ClearKey) 時會發生 setMediaDrmSession failed: session not opened 錯誤。
  • 文字:
    • CEA-608:確保系統正確處理欄位 2 的服務切換指令。(#10666)。
  • DASH:
    • 從資訊清單中剖析 EventStream.presentationTimeOffset (#10460)。
  • UI:
    • 將播放器目前的覆寫設定做為 TrackSelectionDialogBuilder 中的預設值使用 (#10429)。
  • 工作階段:
    • 即使某些需要非同步解析,仍可確保指令以正確順序執行 (#85)。
    • 新增 DefaultMediaNotificationProvider.Builder 以建構 DefaultMediaNotificationProvider 執行個體。建構工具可以設定供應商使用的通知 ID、通知管道 ID 和通知管道名稱。此外,請新增方法 DefaultMediaNotificationProvider.setSmallIcon(int),以設定通知小圖示。(#104)。
    • 確保在不捨棄 MediaController.release() 前傳送指令。(#99)。
    • SimpleBitmapLoader 可以從 file:// URI 載入點陣圖 (#108)。
    • 修正防止 MediaController 在一段時間內搜尋廣告 (#122) 的斷言。
    • 播放結束後,MediaSessionService 就會停止在前景播放,並顯示可重新啟動播放上一次所播放媒體項目的通知。(#112)。
    • 請勿為了暫停而啟動具有待處理意圖的前景服務。(#167)。
    • 手動隱藏與 DefaultNotificationProvider 在 API 26 和 API 27 (API 28 以上版本會自動隱藏標記) 上建立通知相關聯的「標記」(#131)。
    • 修正從舊版 MediaSession 至 Media3 MediaController 的第二個繫結機制連線導致 IllegalStateException 的錯誤。(#49)。
  • RTSP:
    • 新增 H263 片段化封包處理 (#119)。
    • 新增對 MP4A-LATM 的支援。(#162)。
  • 我是:
    • 新增載入廣告資訊的逾時事件,以處理 IMA SDK 載入廣告時卡住的情況。(#10510)。
    • 避免在跳轉至內容結尾時略過片中廣告 (#10685)。
    • 針對包含伺服器端插入廣告的直播,正確計算視窗持續時間,例如 IMA DAI (#10764)。
  • FFmpeg 擴充功能:
    • 新增必要的旗標,以連結 FFmpeg 程式庫與 NDK 23.1.7779620 以上版本 (#9933)。
  • AV1 擴充功能:
    • 請更新 CMake 版本,以免與最新的 Android Studio 版本不相容。(#9933)。
  • Cast 擴充功能:
    • 實作 getDeviceInfo(),以便在使用 MediaController 控製播放時能夠識別 CastPlayer。(#142)。
  • 轉換程式:
    • 新增多工監控計時器,用來偵測產生輸出樣本的速度太慢。
  • 移除已淘汰的符號:
    • 移除 Transformer.Builder.setOutputMimeType(String)。這項功能已停用。使用預設多工器時,MIME 類型一律為 MP4。

1.0.0-beta02 版

2022 年 7 月 21 日

發布了 androidx.media3:media3-*:1.0.0-beta02查看 1.0.0-beta02 版的修訂項

此版本可對應至 ExoPlayer 2.18.1 版

  • 核心程式庫:
    • 確認透過 ExoPlayer.setShuffleOrder 變更 ShuffleOrder 會導致使用 reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGEDPlayer.Listener#onTimelineChanged 呼叫 (#9889)。
    • 如果是漸進式媒體,請只加入在緩衝處理位置選取的曲目 (#10361)。
    • 允許所有 ExoPlayer 記錄輸出使用自訂記錄器 (#9752)。
    • 修正 DefaultMediaSourceFactory 中的 setDataSourceFactory 實作,在某些情況下無法正常運作的問題 (#116)。
  • 擷取工具:
    • 修正 H265 短期參考相片集的剖析問題 (#10316)。
    • 修正從 esds 方塊剖析位元率的問題 (#10381)。
  • DASH:
    • 從資訊清單中清除 ClearKey 授權網址 (#10246)。
  • UI:
    • 確保 TalkBack 會在播放控制項選單中公告目前使用中的速度選項 (#10298)。
  • RTSP:
    • 新增 VP8 片段化封包處理 (#110)。
  • Leanback 擴充功能:
    • 監聽 LeanbackAdapter 中的 playWhenReady 變更 (10420)。
  • 投放:
    • 請使用已在 CastTimeline 中以 Window.mediaItem 傳遞至播放清單方法的 MediaItem (#25#8212)。
    • 支援使用 CastPlayerPlayer.getMetadata()Listener.onMediaMetadataChanged() (#25)。

1.0.0-beta01 版本

2022 年 6 月 16 日

發布了 androidx.media3:media3-*:1.0.0-beta011.0.0-beta01 版包含此連結所列的修訂項目。

這與 ExoPlayer 2.18.0 版相對應。

  • 核心程式庫:
    • 透過 MediaMetricsManager 啟用 Android 平台診斷支援功能。ExoPlayer 會向平台傳送播放事件和效能資料,有助於在裝置提供系統效能與偵錯資訊。如果裝置使用者已啟用分享使用狀況與診斷資料功能,則 Google 也可能會收集以上資料。您可以透過 ExoPlayer.Builder.setUsePlatformDiagnostics(false),讓應用程式選擇不採用 ExoPlayer 的平台診斷貢獻功能。
    • 修正使用 MergingMediaSource 會造成音軌重設過度頻繁的問題,例如在播放途中側載字幕及變更選取的字幕便會發生這個情況 (#10248)。
    • 停止在 API 29 及 30 偵測 5G-NSA 網路類型。這些播放動作會假設是透過 4G 網路進行。
    • 不允許將 null 傳遞至 MediaSource.Factory.setDrmSessionManagerProviderMediaSource.Factory.setLoadErrorHandlingPolicy。如果有必要的話,可以明確傳遞 DefaultDrmSessionManagerProviderDefaultLoadErrorHandlingPolicy 的執行個體。
    • 新增 MediaItem.RequestMetadata 以代表在不知道確切 LocalConfiguration 時播放媒體所需的中繼資料。另外也移除 MediaMetadata.mediaUrl,因為現在這個中繼資料已內含在 RequestMetadata
    • 新增 Player.Command.COMMAND_SET_MEDIA_ITEM,以便讓播放器設定單翼項目。
  • 音軌選取:
    • TrackSelectionOverrides 類別壓平合併至 TrackSelectionParameters,並將 TrackSelectionOverride 升級至頂層類別。
    • TracksInfo 重新命名為 Tracks,並將 TracksInfo.TrackGroupInfo 重新命名為 Tracks.GroupPlayer.getCurrentTracksInfoPlayer.Listener.onTracksInfoChanged 也已經重新命名為 Player.getCurrentTracksPlayer.Listener.onTracksChanged。這包括「取消淘汰」Player.Listener.onTracksChanged 方法名稱,不過參數類型不同。
    • DefaultTrackSelector.buildUponParametersDefaultTrackSelector.Parameters.buildUpon 變更為回傳 DefaultTrackSelector.Parameters.Builder,而不是已淘汰的 DefaultTrackSelector.ParametersBuilder
    • 新增系統預設啟用的 DefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities。啟用後,DefaultTrackSelector 會偏好使用頻道數量並未超出裝置輸出能力範圍的音軌。在手持裝置上,DefaultTrackSelector 比起多頻道音訊格式更偏好使用立體聲/單聲道,除非多頻道格式可以設定空間音訊 (Android 12L 以上) 或是 Dolby 環場音效格式。另外,若在支援音訊空間化的裝置上,DefaultTrackSelector 會監控空間音訊化屬性的變更情況,並在變更時觸發選取新的音軌。設有 television UI 模式的裝置不受這些限制,系統會偏好使用最多頻道數量的格式。如果想啟用此功能,必須用 Context 建構 DefaultTrackSelector 執行個體。
  • 影片:
    • DummySurface 重新命名為 PlaceholderSurface
    • 新增 MediaCodecVideoRenderer.getCodecMaxInputSize 的 AV1 支援功能。
  • 音訊:
    • 使用 LG AC3 音訊解碼器通告非標準的 MIME 類型。
    • AudioAttributes.getAudioAttributesV21() 的傳回類型從 android.media.AudioAttributes 變更為新的 AudioAttributesV21 包裝函式類別,防止 API 21 以下會發生 ART 驗證過慢的情況。
    • 在 HTTP 即時串流不分區塊準備時,會發生未設定格式音訊頻道數量的情況,此時請查詢平台 (API 29 以上) 或為音訊直通假設音訊編碼頻道數量 (10204)。
    • 如果解碼器輸出 12 頻道 PCM 音訊,請用頻道遮罩 AudioFormat.CHANNEL_OUT_7POINT1POINT4 設定 AudioTrack (#10322)。
  • DRM
    • 如果在變更格式後需要立即尋求 DRM 工作階段,請確定 DRM 工作階段一律可以正常更新 (10274)。
  • 文字:
    • Player.getCurrentCues() 變更為回傳 CueGroup,而不是 List<Cue>
    • SSA:在 BorderStyle == 3 的情況下支援 OutlineColour 樣式設定 (也就是說 OutlineColour 會設定提示的背景) (#8435)。
    • CEA-708:將資料剖析為多個服務區塊,並忽略並未和目前選取的服務編號相關的區塊。
    • 移除 RawCcExtractor,這個項目只有 Google 內部字幕格式使用。
  • 擷取工具:
    • 新增 AVI 的支援 (#2092)。
    • Matroska:為 Opus 音軌剖析 DiscardPadding
    • MP4:從 esds 方格中剖析位元率。
    • Ogg:允許重複的 Opus ID 及留言標頭 (10038)。
  • UI:
    • 修正 useController=false 時,在 PlayerView 上遞送事件到 OnClickListener 組合的問題 (#9605)。同時,修正所有檢視畫面設定的遞送事件到 OnLongClickListener 的問題。
    • 修正在點擊 ACTION_UP 之前,將連續 PlayerView 離開邊界的一系列觸控事件視為點擊 (#9861)。
    • 修正 PlayerView 輕觸時可能會觸發播放而不是隱藏控制項的無障礙功能問題 (#8627)。
    • 重新編寫 TrackSelectionViewTrackSelectionDialogBuilder,以便正確搭配 Player 介面使用,而不是 ExoPlayer。這樣做可讓檢視畫面和其他 Player 實作內容一同使用,並可移除 UI 模組對於 ExoPlayer 模組的依附性。這是一項破壞性變更。
    • 不在 PlayerView 音軌選取器內顯示強製文字音軌,當選擇「None」(無) 時,保留合適的強製文字音軌 (#9432)。
  • DASH:
    • 從 DTS AudioChannelConfiguration 元素剖析頻道數量,這樣便能重新啟用 DTS 串流的音訊直通 (#10159)。
    • 禁止將 null 傳遞至 DashMediaSource.Factory.setCompositeSequenceableLoaderFactory。如果有必要的話,可以明確傳遞 DefaultCompositeSequenceableLoaderFactory 的執行個體。
  • HLS:
    • 如果播放清單的轉碼器屬性並未含有該音訊轉碼器,則使用備用的分區塊準備 (#10065)。
    • 禁止將 null 傳遞至 HlsMediaSource.Factory.setCompositeSequenceableLoaderFactoryHlsMediaSource.Factory.setPlaylistParserFactoryHlsMediaSource.Factory.setPlaylistTrackerFactory。如果有必要的話,可以明確傳遞 DefaultCompositeSequenceableLoaderFactoryDefaultHlsPlaylistParserFactory 的執行個體或 DefaultHlsPlaylistTracker.FACTORY 的參考資料。
  • 流暢串流:
    • 禁止將 null 傳遞至 SsMediaSource.Factory.setCompositeSequenceableLoaderFactory。如果有必要的話,可以明確傳遞 DefaultCompositeSequenceableLoaderFactory 的執行個體。
  • RTSP:
    • 新增 H263 的 RTP 讀取工具 (#63)。
    • 新增 MPEG4 的 RTP 讀取工具 (#35)。
    • 新增 HEVC 的 RTP 讀取工具 (#36)。
    • 新增 AMR 的 RTP 讀取工具。目前僅支援單頻道和非交錯 AMR 串流。不支援複合 AMR RTP 酬載(#46)。
    • 新增 VP8 的 RTP 讀取工具 (#47)。
    • 新增 WAV 的 RTP 讀取工具 (#56)。
    • 修正 RTSP 基本授權標頭。(#9544)。
    • 停止檢查強制性的 SDP 欄位,因為 ExoPlayer 不需要這些欄位 (#10049)。
    • 在剖析 RTSP 時間點時擲回已檢查過的例外狀況 (#10165)。
    • 新增 VP9 的 RTP 讀取工具 (#47)。
    • 新增 OPUS 的 RTP 讀取工具 (#53)。
  • 資料來源:
    • DummyDataSource 重新命名為 PlaceholderDataSource
    • 解決 OkHttp 中斷處理的問題。
  • 工作階段:
    • MediaSession.MediaItemFiller 替換為 MediaSession.Callback.onAddMediaItems,以便要求使用非同步解析。
    • MediaController 連結到舊版工作階段時,支援 setMediaItems(s) 方法。
    • 移除 MediaController.setMediaUriMediaSession.Callback.onSetMediaUri。您可以用 MediaController.setMediaItemMediaSession.Callback.onAddMediaItems 達到相同功能。
    • 將舊版的 MediaController 播放媒體呼叫傳遞給 MediaSession.Callback.onAddMediaItems,而不是 onSetMediaUri
    • 新增 MediaNotification.ProviderDefaultMediaNotificationProvider,以便自訂通知內容。
    • 新增 BitmapLoaderSimpleBitmapLoader,以便下載作品圖片。
    • 新增 MediaSession.setCustomLayout(),以便為舊版工作階段提供回溯相容性。
    • 新增 MediaSession.setSessionExtras(),以便提供和舊版工作階段同等的功能。
    • MediaSession.MediaSessionCallback 重新命名為 MediaSession.CallbackMediaLibrarySession.MediaLibrarySessionCallback 重新命名為 MediaLibrarySession.Callback,並將 MediaSession.Builder.setSessionCallback 重新命名為 setCallback
    • 修正 MediaControllerImplLegacy 中的 NPE (#59)。
    • 更新時間軸的工作階段位置 (#51)。
    • 修正釋放控制器之後 MediaControllerImplBase 裡的 NPE (#74)。
  • 廣告播放 / IMA:
    • 將廣告輪詢頻率從 100ms 降為 200ms,以符合美國媒體評議會 (MRC) 建議內容。
  • FFmpeg 擴充功能:
    • 將 CMake 版本更新至 3.21.0+,以避免發生導致 AndroidStudio Gradle 同步處理失敗的 CMake 錯誤 (#9933)。
  • 移除已淘汰的符號:
    • 移除 Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray)。改用 Player.Listener.onTracksChanged(Tracks)
    • 移除 Player.getCurrentTrackGroupsPlayer.getCurrentTrackSelections。改用 Player.getCurrentTracks。您也可以繼續使用 ExoPlayer.getCurrentTrackGroupsExoPlayer.getCurrentTrackSelections,不過這些項目會繼續視為已淘汰的方法。
    • 移除 DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORTDEFAULT_TRACK_SELECTOR_PARAMETERS 等常數。請盡量改為使用 getDefaultTrackSelectorParameters(Context)DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT
    • 移除建構函式 DefaultTrackSelector(ExoTrackSelection.Factory)。請改用 DefaultTrackSelector(Context, ExoTrackSelection.Factory)
    • 移除 Transformer.Builder.setContextContext 應改為傳遞至 Transformer.Builder 建構函式。

1.0.0-alpha03 版本

2022 年 3 月14 日

發布了 androidx.media3:media3-*:1.0.0-alpha03查看 1.0.0-alpha03 版的修訂項

這與 ExoPlayer 2.17.1 版相對應。

  • 音訊:
    • 修正在 HLS 中檢查 Dolby Atmos (E-AC3-JOC) 音訊功能時發生的錯誤。
  • 擷取工具:
    • FMP4:修正針對同時包含 v0 和 v1 emsg Atom 的串流,emsg 範例中繼資料可能以錯誤順序輸出的問題 (#9996)。
  • 文字:
    • 修正 SingleSampleMediaSource.Factory.setTrackIdMediaItem.SubtitleConfiguration.Builder.setId 的互動方式,以便優先處理 SubtitleConfiguration 欄位;如果未設定,改回使用 Factory 值 (#10016)。
  • 廣告播放:
    • 修正即時 HLS SSAI 串流中,廣告時段之間的音訊欠載問題。

1.0.0-alpha02 版

2022 年 3 月 2 日

發布了 androidx.media3:media3-*:1.0.0-alpha021.0.0-alpha02 版包含此連結所列的修訂項目。

這與 ExoPlayer 2.17.0 版相對應。

  • 核心程式庫:
    • 新增受保護的方法 DefaultRenderersFactory.getCodecAdapterFactory(),讓覆寫 buildVideoRenderers()buildAudioRenderers()DefaultRenderersFactory 子類別可以存取轉碼器轉接器工廠,並將其傳遞至所建立的 MediaCodecRenderer 執行個體。
    • 將 ICY 標頭欄位 namegenre 分別傳播至 MediaMetadata.stationMediaMetadata.genre,這樣他們才能透過 Player.Listener.onMediaMetadataChanged() 到達應用程式 (#9677 )。
    • DefaultHttpDataSource#getResponseHeaders 移除空值索引鍵。
    • 建立 MediaCodec 執行個體失敗時,休眠然後再試一次。這個方法適用於部分裝置將途徑從安全轉碼器切換至其他轉碼器時發生的問題 (#8696)。
    • 新增 MediaCodecAdapter.getMetrics(),以便讓使用者從 MediaCodec 取得指標資料。(#9766)。
    • 修正 Maven 依附元件解析度 (#8353)。
    • 針對未啟用低延遲功能或使用者要求設定速度的直播,停用自動速度調整項 (#9329)。
    • DecoderCounters#inputBufferCount 重新命名為 queuedInputBufferCount
    • SimpleExoPlayer.renderers 設為私人。轉譯器可透過 ExoPlayer.getRenderer 存取。
    • 已將部分 AnalyticsListener.EventFlags 常數值更新為符合 Player.EventFlags 中的值。
    • AnalyticsCollector 分割為介面和預設實作作業,若應用程式不需要,即可用 R8 將其移除。
  • 音軌選取:
    • 在音軌選取中支援偏好的影片角色旗標 (#9402)。
    • 更新影片音軌選取邏輯,在選取多重影片音軌以便調整時,採用偏好的 MIME 類型和角色旗標 (#9519)。
    • 更新影片和音軌選取邏輯,僅選擇具有相同解碼器和硬體支援等級的可調整選項格式 (#9565)。
    • 更新影片軌選取邏輯,如果主要的硬體加速解碼器支援多個轉碼器,則偏好選用效率較高的轉碼器 (#4835)。
    • 偏好音訊內容偏好設定 (例如「預設」音軌或符合系統語言代碼語言的音軌),而不是技術音軌選取限制 (例如偏好的 MIME 類型或頻道數量上限)。
    • 修正音軌選取問題:覆寫其中一個音軌組時,並未停用相同類型的其他音軌組 (#9675)。
    • 修正未正確套用非空白及空白混合音軌覆寫的音軌選取問題 (#9649)。
    • TrackGroupArrayTrackGroup 禁止重複。您隨時可以在 TrackGroup 建構函式中設定 id,藉此區分 TrackGroup。此做法修正使用主動音軌覆寫後,在應用程式背景作業後恢復播放時發生的異常終止問題 (#9718)。
    • 修正 AdaptiveTrackSelection 中的邏輯,允許在網路頻寬足夠時提高品質,即使播放品質已非常接近目前邊緣 (#9784)。
  • 影片:
    • 修正 Dolby Vision 中的解碼器備用邏輯,視需要使用相容的 H264/H265 解碼器。
  • 音訊:
    • 修正 Dolby Atmos (E-AC3-JOC) 的解碼器備用邏輯,視需要使用相容的 E-AC3 解碼器。
    • 變更 AudioCapabilities API,要求明確傳遞 AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES (而非 null)。
    • AudioTrackBufferSizeProvider 插入 DefaultAudioSink,允許自訂 AudioTrack 緩衝區空間的計算方式。(#8891)。
    • 如果要求的緩衝區空間 > 1 MB,請重新嘗試建立 AudioTrack。(#9712)。
  • 擷取工具:
    • WAV:新增 RF64 串流支援 (#9543)。
    • 修正 H.265 SPS NAL 單元的剖析錯誤 (#9719)。
    • 在 Ogg Opus 和 Ogg Vorbis 檔案中剖析 Vorbis 評論 (包括 METADATA_BLOCK_PICTURE)。
  • 文字:
    • 新增 MediaItem.SubtitleConfiguration.id 欄位,系統會將該欄位套用到透過設定建立的字幕軌的 Format.id 欄位 (#9673)。
    • 在 Matroska 容器中新增 WebVTT 字幕的基本支援 (#9886)。
    • 禁止 Cea708Decoder 讀取超過服務區塊宣告的大小。
  • DRM:
    • DrmSessionManager.(pre)acquireSessionplaybackLooper 移除。當自訂 MediaSource 中的應用程式使用 DrmSessionManager 時,必須改將 playbackLooper 傳遞至 DrmSessionManager.setPlayer
  • 廣告播放 / IMA:
    • 新增 IMA 動態廣告插播 (DAI) 支援 (#8213)。
    • 將方法新增至 AdPlaybackState 以允許重設廣告群組,以便系統再次播放廣告群組 (#9615)。
    • 在廣告播放期間強制執行 1.0 的播放速度 (#9018)。
    • 修正廣告群組載入失敗,並導致播放立即重設的問題 (#9929)。
  • UI:
    • 修正使用特定主題時,StyledPlayerView 倒轉和快轉按鈕中數字的顏色 (#9765)。
    • 正確平移播放速度字串 (#9811)。
  • DASH:
    • Representation 中新增剖析的必要和補充屬性 (#9579)。
    • 支援 forced-subtitle 音軌角色 (#9727)。
    • 停止將 main 音軌角色解讀為 C.SELECTION_FLAG_DEFAULT
    • 針對未宣告 DVB 命名空間的資訊清單,修正基本網址排除邏輯 (#9856)。
    • 支援相對 MPD.Location 網址 (#9939)。
  • HLS:
    • 正確填入純音訊 HLS 串流的 Format.label (#9608)。
    • 預設使用不分區塊準備,以縮短啟動時間。如果轉譯內容包含並未在主要播放清單中宣告的互斥隱藏式輔助字幕軌,您應該將該轉譯內容加入主要播放清單以供播放,或是使用 HlsMediaSource.Factory.setAllowChunklessPreparation(false) 關閉不分區塊準備。
    • 支援在 HLS 中準確搜尋主要畫面格 (#2882)。
  • RTSP:
    • 提供用戶端 API 以覆寫任何伺服器連線所用的 SocketFactory (#9606)。
    • 如果兩者同時存在,請優先採用 DIGEST 驗證方法,而非 BASIC 方法 (#9800)。
    • 在 RTSP 音軌時間碼無法使用時處理 (#9775)。
    • 忽略無效的 RTP-Info 標頭值 (#9619)。
  • 轉換程式:
    • 將最低 API 版提升至 21。
    • TransformationException 現已用於描述轉換期間發生的錯誤。
    • 新增 TransformationRequest 來指定轉換選項。
    • 允許註冊多個事件監聽器。
    • 修正轉換程式在部分轉碼器輸出讀取後卡住的問題。
    • 修正釋出多工器時,Transformer.getProgress 中可能擲回的 NPE。
    • 新增用於套用轉換的試用版應用程式。
  • MediaSession 擴充功能:
    • 根據預設,MediaSessionConnector 現在會在停止時清除播放清單。 如果希望應用程式保留播放清單,可在連接器上呼叫 setClearMediaItemsOnStop(false)
  • Cast 擴充功能:
    • 修正導致 CastPlayer 無法正確呼叫 onIsPlayingChanged 的錯誤 (#9792)。
    • 支援音訊中繼資料,包括有 DefaultMediaItemConverter 的圖片 (#9663)。
  • FFmpeg 擴充功能:
    • build_ffmpeg.sh 依賴 LLVM 而非 GNU 的作業區公用程式 (#9933)。
  • Android 12 相容性:
    • 升級 Cast 擴充功能,使其仰賴 com.google.android.gms:play-services-cast-framework:20.1.0。先前版本的 play-services-cast-framework 與指定 Android 12 的應用程式不相容,並在建立 PendingIntent 時會因 IllegalArgumentException 異常終止 (#9528)。
  • 移除已淘汰的符號:
    • 移除 Player.EventListener。改用 Player.Listener
    • 移除 MediaSourceFactory#setDrmSessionManagerMediaSourceFactory#setDrmHttpDataSourceFactoryMediaSourceFactory#setDrmUserAgent。改用 MediaSourceFactory#setDrmSessionManagerProvider
    • 移除 MediaSourceFactory#setStreamKeys。改用 MediaItem.Builder#setStreamKeys
    • 移除 MediaSourceFactory#createMediaSource(Uri)。改用 MediaSourceFactory#createMediaSource(MediaItem)
    • setTagDashMediaSourceHlsMediaSourceSsMediaSource 中移除。改用 MediaItem.Builder#setTag
    • 移除 DashMediaSource#setLivePresentationDelayMs(long, boolean)。使用 MediaItem.Builder#setLiveConfigurationMediaItem.LiveConfiguration.Builder#setTargetOffsetMs 覆寫資訊清單,或使用 DashMediaSource#setFallbackTargetLiveOffsetMs 提供備用值。
    • 移除 (Simple)ExoPlayer.setThrowsWhenUsingWrongThread。無法再選擇不採用執行緒強制執行功能。
    • 移除 ActionFileActionFileUpgradeUtil。使用 ExoPlayer 2.16.1 以下版,以使用 ActionFileUpgradeUtil 將舊版操作檔案合併到 DefaultDownloadIndex
    • 移除 ProgressiveMediaSource#setExtractorsFactory。改用 ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) 建構函式。
    • 移除 ProgressiveMediaSource.Factory#setTagProgressiveMediaSource.Factory#setCustomCacheKey。改用 MediaItem.Builder#setTagMediaItem.Builder#setCustomCacheKey
    • 移除 DefaultRenderersFactory(Context, @ExtensionRendererMode int)DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) 建構函式。改用 DefaultRenderersFactory(Context) 建構函式、DefaultRenderersFactory#setExtensionRendererModeDefaultRenderersFactory#setAllowedVideoJoiningTimeMs
    • 移除所有公開的 CronetDataSource 建構函式。改用 CronetDataSource.Factory
  • 請將下列 IntDefs 變更為僅限 @Target(TYPE_USE)。這可能會導致 Kotlin 環境中的用量編譯作業中斷,移動備註類型的註解可修正此問題 (Int)。
    • @AacAudioObjectType
    • @Ac3Util.SyncFrameInfo.StreamType
    • @AdLoadException.Type
    • @AdtsExtractor.Flags
    • @AmrExtractor.Flags
    • @AspectRatioFrameLayout.ResizeMode
    • @AudioFocusManager.PlayerCommand
    • @AudioSink.SinkFormatSupport
    • @BinarySearchSeeker.TimestampSearchResult.Type
    • @BufferReplacementMode
    • @C.BufferFlags
    • @C.ColorRange
    • @C.ColorSpace
    • @C.ColorTransfer
    • @C.CryptoMode
    • @C.Encoding
    • @C.PcmEncoding
    • @C.Projection
    • @C.SelectionReason
    • @C.StereoMode
    • @C.VideoOutputMode
    • @CacheDataSource.Flags
    • @CaptionStyleCompat.EdgeType
    • @DataSpec.Flags
    • @DataSpec.HttpMethods
    • @DecoderDiscardReasons
    • @DecoderReuseResult
    • @DefaultAudioSink.OutputMode
    • @DefaultDrmSessionManager.Mode
    • @DefaultTrackSelector.SelectionEligibility
    • @DefaultTsPayloadReaderFactory.Flags
    • @EGLSurfaceTexture.SecureMode
    • @EbmlProcessor.ElementType
    • @ExoMediaDrm.KeyRequest.RequestType
    • @ExtensionRendererMode
    • @Extractor.ReadResult
    • @FileTypes.Type
    • @FlacExtractor.Flags (com.google.android.exoplayer2.ext.flac 套件中)
    • @FlacExtractor.Flags (com.google.android.exoplayer2.extractor.flac 套件中)
    • @FragmentedMp4Extractor.Flags
    • @HlsMediaPlaylist.PlaylistType
    • @HttpDataSourceException.Type
    • @IllegalClippingException.Reason
    • @IllegalMergeException.Reason
    • @LoadErrorHandlingPolicy.FallbackType
    • @MatroskaExtractor.Flags
    • @Mp3Extractor.Flags
    • @Mp4Extractor.Flags
    • @NotificationUtil.Importance
    • @PlaybackException.FieldNumber
    • @PlayerNotificationManager.Priority
    • @PlayerNotificationManager.Visibility
    • @PlayerView.ShowBuffering
    • @Renderer.State
    • @RendererCapabilities.AdaptiveSupport
    • @RendererCapabilities.Capabilities
    • @RendererCapabilities.DecoderSupport
    • @RendererCapabilities.FormatSupport
    • @RendererCapabilities.HardwareAccelerationSupport
    • @RendererCapabilities.TunnelingSupport
    • @SampleStream.ReadDataResult
    • @SampleStream.ReadFlags
    • @StyledPlayerView.ShowBuffering
    • @SubtitleView.ViewType
    • @TextAnnotation.Position
    • @TextEmphasisSpan.MarkFill
    • @TextEmphasisSpan.MarkShape
    • @Track.Transformation
    • @TrackOutput.SampleDataPart
    • @Transformer.ProgressState
    • @TsExtractor.Mode
    • @TsPayloadReader.Flags
    • @WebvttCssStyle.FontSizeUnit

1.0.0-alpha01 版

2021 年 10 月 27 日

發布了 androidx.media3:media3-*:1.0.0-alpha011.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

Media3 是媒體支援程式庫 (包括 ExoPlayer) 的新園地。第一個 Alpha 版包含下列早期功能性程式庫實作,目的是用於實作媒體應用實例:

  • ExoPlayer,這是 Android 的應用程式等級媒體播放器,易於自訂及擴充。
  • 媒體工作階段功能,用於公開和控制播放。這個新的工作階段模組使用與 ExoPlayer 相同的 Player 介面。
  • 用於建立媒體播放使用者介面的 UI 元件。
  • 其他程式庫中可與 ExoPlayer 搭配使用的模組包裝功能,例如透過 IMA SDK 插入廣告。

詳情請參閱 Media3 GitHub 專案

ExoPlayer 先前是在另一個 ExoPlayer GitHub 專案中代管。在 Media3 中,其套件名稱為 androidx.media3.exoplayer。我們打算持續維護及發布 ExoPlayer GitHub 專案一段時間,讓應用程式有時間遷移至 Media3。Media3 將取代所有 ExoPlayer 模組 (舊版 Media2 和 mediasession 擴充功能除外,前述兩者會以新版 media3-session 模組取代)。如此一來,不需使用轉接器/連接器類別,就能直接整合播放器及媒體工作階段。