本頁面由 Cloud Translation API 翻譯而成。

Media3

媒體用途的支援程式庫。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2024 年 11 月 13 日	1.4.1	1.5.0-rc01	-	-

宣告依附元件

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

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

Groovy

dependencies {
    def media3_version = "1.4.1"

    // 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"
    // Common Kotlin-specific functionality
    implementation "androidx.media3:media3-common-ktx:$media3_version"
}

Kotlin

dependencies {
    val media3_version = "1.4.1"

    // 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")
    // Common Kotlin-specific functionality
    implementation("androidx.media3:media3-common-ktx:$media3_version")
}

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

意見回饋

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

1.5 版本

1.5.0-rc02 (2024-11-19)

發布 androidx.media3:media3-*:1.5.0-rc02。

1.5.0-rc02 版包含這些修訂項目。

自 1.5.0-rc01 版本以來，此版本包含下列變更：

擷取工具：
- 新增 AC-4 級別 4 的 ISO 基本媒體檔案格式支援 (#1265)。
文字：
- 修正每個樣本含有多個 SEI 訊息的內容中，出現的 CEA-608 字幕錯誤。
- 修正啟用 CEA-608 字幕時，DASH 多時段串流播放會卡住的問題 (#1863)。
- 修正 MP4 檔案中錯誤標示每個樣本為同步樣本的 CEA-608 字幕亂碼問題。(#1863)。
試用版應用程式
- 解決短版應用程式示範內容中的記憶體流失問題 (#1839)。

1.5.0-rc01 (2024-11-13)

發布 androidx.media3:media3-*:1.5.0-rc01。

1.5.0-rc01 版包含這些修訂項目。

自 1.5.0-beta01 版本以來，此版本包含下列變更：

ExoPlayer：
- 修正錯誤：在多時段 DASH 串流中，播放清單項目或時段的時間長度不符合實際內容，可能會導致項目結尾的畫面凍結 (#1698)。
- 將 setter 新增至 SntpClient，設定自上次更新後經過的最大時間，之後系統會重新初始化用戶端 (#1794)。
擷取工具：
- 修正 MP4 檔案 mdhd 方塊中的媒體時間長度剖析，以處理 -1 值 (#1819)。
- 新增支援在 MP4 檔案中識別 H.263 影片的 h263 方塊。(#1821)。
資料來源：
- DataSourceContractTest：斷言 DataSource.getUri() 會傳回已解析的 URI (如說明所述)。如果這與要求的 URI 不同，測試可以使用新的 DataSourceContractTest.TestResource.Builder.setResolvedUri() 方法指出這點。
- DataSourceContractTest：斷言 DataSource.getUri() 和 getResponseHeaders() 在呼叫 open() 失敗 (因「找不到」資源) 且在後續 close() 呼叫之前，會傳回「open」值。
  - 覆寫 DataSourceContractTest.getNotFoundResources() 可讓測試子類別提供多個「找不到」資源，並提供任何預期的標頭。這樣一來，您就能區分 HTTP 404 (含標頭) 和「找不到伺服器」(不含標頭)。
文字：
- 修正 H.264 MPEG-TS 串流中未輸出的 CEA-608 字幕 (這項功能在 1.5.0-alpha01 中遭到 https://github.com/androidx/media/commit/03a205f220ecf7681f85f8a752227e3986e257ff 中中斷)。
- 支援 Dolby Vision 內容中的 CEA-608 字幕。(#1820)。
RTSP 擴充功能：
- 修正剖析含有標頭擴充功能的 RTP 封包時發生的當機問題 (#1225)。

1.5.0-beta01 版

2024 年 10 月 30 日

發布了 androidx.media3:media3-*:1.5.0-beta01。1.5.0-beta01 版包含這些修訂項目。

通用程式庫：
- 從手動未註解的內部類別中移除 @DoNotInline 註解，以免發生執行階段類別驗證失敗。最新版本的 R8 會自動進行這類離線呼叫，以避免執行階段失敗 (因此不再需要手動離線)。由於 compileSdk = 35，程式庫的所有 Gradle 使用者都必須使用 Android Gradle 外掛程式的版本，且該版本必須使用可執行此操作的 R8 版本。使用非 Gradle 建構系統的程式庫使用者，需要確保 R8 等同的縮減/模糊處理步驟執行類似的自動脫離行程，以免發生執行階段類別驗證失敗。其他 AndroidX 程式庫已完成這項變更。
ExoPlayer：
- 修正 MediaCodec.CryptoException 在 MediaCodec 以非同步模式運作時，有時會回報為「未預期的執行階段錯誤」的問題 (API 31 以上版本的預設行為)。
- 使用 PreloadMediaSource.PreloadControl.onContinueLoadingRequested() 傳遞 bufferedDurationUs，而非 bufferedPositionUs。並將 DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS 變更為 DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS，應用程式必須傳遞代表從預設起始位置開始的特定時間長度的值，並使用此 IntDef 為對應的媒體來源預先載入，而非傳遞位置。
- 新增 ForwardingRenderer 實作項目，將所有方法呼叫轉送至其他轉譯器 (1703)。
- 為播放清單中的下一個項目新增播放清單預先載入功能。應用程式可以呼叫 ExoPlayer.setPreloadConfiguration(PreloadConfiguration) 來啟用預先載入功能。預先載入功能預設為停用。在選擇啟用且不干擾播放的情況下，DefaultLoadControl 會限制預先載入作業，只在播放器未載入播放內容時開始及繼續。應用程式可以根據需要實作 LoadControl.shouldContinuePreloading()，藉此變更這項行為 (例如在 DefaultLoadControl 中覆寫此方法)。如果應用程式使用 LoadControl 的自訂實作，LoadControl 的預設實作會停用預先載入功能。
- 新增方法 MediaSourceEventListener.EventDispatcher.dispatchEvent()，允許叫用子類別事件監聽器的事件 (1736)。
- 新增 DefaultPreloadManager.Builder，以便使用一致的共用設定建構 DefaultPreloadManager 和 ExoPlayer 例項。
- 從 LoadControl.onTracksSelected() 中移除 Renderer[] 參數，因為 DefaultLoadControl 實作可從 ExoTrackSelection[] 擷取串流類型。
- 已淘汰 DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[])，並將方法標記為 final，以免遭到覆寫。請改用新的 DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[])。
- 在 MergingMediaSource 中回報來自次要來源的 MediaSourceEventListener 事件。這會導致系統為側載字幕 (使用 MediaItem.LocalConfiguration.subtitleConfigurations 新增的字幕) 回報載入開始/錯誤/取消/完成事件，這些事件可能會顯示為從 AnalyticsListener 傳送的重複載入事件。
- 防止字幕和中繼資料錯誤導致播放作業完全停止。相反地，系統會停用有問題的音軌，並繼續播放其他音軌 (#1722)。
  - 在新的字幕處理程序 (在擷取期間) 中，系統會透過 onLoadError 回呼發出相關的剖析錯誤 (例如無效的字幕資料) 和載入錯誤 (例如 HTTP 404)。
  - 在舊版字幕處理作業 (轉譯期間) 中，系統只會透過 onLoadError 回呼發出相關聯的載入錯誤，而剖析錯誤會遭到靜默忽略 (這是先前行為)。
轉換程式：
- 將使用 MediaItem.Builder.setImageDurationMs 設定圖片時間長度設為匯出圖片的必要條件。
- 新增對音訊 EditedMediaItems 序列中間空白的匯出支援。
曲目選取：
- DefaultTrackSelector：在其他因素相同的情況下，優先採用以物件為基礎的音訊，而非以管道為基礎的音訊。
擷取工具：
- 修正在 MP4 檔案中處理編輯清單時，針對非關鍵影格媒體起始位置的預告片範例處理方式 (#1659)。
- 使用 Mp4Extractor 和 FragmentedMp4Extractor 中 mdhd 方塊的媒體時間長度，改善影格速率計算方式 (#1531)。
- 修正 MP4 編輯清單中 media_time 的錯誤縮放比例。雖然 segment_duration 已使用電影時間尺度正確縮放，但 media_time 現在會使用軌道時間尺度進行適當縮放，這符合 MP4 格式標準的規定 (#1792)。
- 使用編輯清單，處理 MP4 endIndices 計算中的亂序影格 (#1797)。
音訊：
- 修正在搜尋期間可能發生的爆音問題。
- 修正 Sonic 的時間拉伸/音高轉移演算法累積的截斷錯誤。
- 修正 SpeedChangingAudioProcessor 中導致輸出影格遺失的錯誤。
影片：
- 針對 Galaxy Tab S7 FE 的裝置問題新增因應措施，該問題會導致 60fps 安全 H.264 串流標示為不支援 (#1619)。
- 針對在最後一個樣本後卡住且未傳回串流結束信號的編解碼，新增因應措施。
文字：
- 確認 HLS 中的 WebVTT 字幕時間戳記非常大 (以微秒表示並乘以 90,000 MPEG 時間基底時，會溢出 64 位元 long)，以便顯示 (#1763)。
中繼資料：
- 將 C.TRACK_TYPE_METADATA 類型指派給含有 icy 或 vnd.dvb.ait 內容的曲目。
DRM：
- 修正開啟 DRM 工作階段失敗後，從 DefaultDrmSession.requiresSecureDecoder 取得 IllegalStateException 的問題。這個問題是在 1.5.0-alpha01 中引入。
Muxers：
IMA 擴充功能：
- 修正缺少前置廣告的伺服器端插入式 DAI 串流，在播放完最後一個中插廣告後可能會導致 ArrayIndexOutOfBoundsException 的錯誤 (#1741)。
工作階段：
- 修正錯誤：連線至舊版服務時，導致從 MediaBrowser 傳送的自訂指令調度至 MediaSessionCompat.Callback，而非方法的 MediaBrowserServiceCompat 變體。這會導致 MediaBrowser 無法接收舊版服務傳回的實際傳回值 (#1474)。
- 設定媒體按鈕意圖的廣播接收器時，處理特定製造商裝置擲回的 IllegalArgumentException (#1730)。
- 新增媒體項目的指令按鈕。這會為舊版程式庫中的 Custom browse actions 新增 Media3 API，並使用 MediaBrowserCompat。請注意，Media3 指令按鈕適用於媒體項目，適用於 MediaBrowser 和 MediaController。請參閱「自訂 AAOS 瀏覽動作」。
- 修正以下錯誤：Media3 控制器有時無法在要求 play() 後，讓工作階段應用程式啟動前景服務。
- 限制 CommandButton.Builder.setIconUri 只接受內容 Uri。
- 連線至舊版 MediaBrowserCompat 時，將 Media3 瀏覽器的連線提示傳遞至初始 MediaBrowserCompat。服務可以透過第一次呼叫 onGetRoot() 接收做為根提示的連線提示。
- 修正錯誤：當瀏覽器訂閱 parentid 後，連線至舊版瀏覽器服務的 MediaBrowser 不會收到服務傳送的錯誤。
- 改善互通性行為，讓連線至舊版 MediaBrowserService 的 Media3 瀏覽器在訂閱父項時，不會兩次要求 parentId 的子項。
UI：
- 由於以 XML 為基礎的共用轉場效果有問題，因此在 PlayerView-in-Compose-AndroidView 因應做法中，讓影片在經過拉伸/裁剪後，才會啟用。在 AndroidView 中使用 PlayerView 的應用程式需要呼叫 PlayerView.setEnableComposeSurfaceSyncWorkaround，才能選擇加入 (#1237、#1594)。
- 將 setFullscreenButtonState 新增至 PlayerView，以便視需要更新全螢幕按鈕的圖示，也就是在外部頻道上更新，且不會回應點擊互動 (#1590、#184)。
- 修正錯誤：如果有應用程式定義的文字音軌選取偏好設定，文字選取功能就無法使用「None」(無) 選項。
流暢串流擴充功能：
- 修正播放含有文字音軌的 SmoothStreaming 串流時發生的 Bad magic number for Bundle 錯誤 (#1779)。
RTSP 擴充功能：
- 修正網址中含有經過編碼的 @ 字元時，系統會移除使用者資訊的問題 (#1138)。
解碼器擴充功能 (FFmpeg、VP9、AV1 等)：
- 在 Android 15 上為解碼器擴充功能新增 16 KB 頁面支援 (#1685)。
Cast 擴充功能：
- 在 CastSession 中斷連線後停止清除時間軸，這樣發送端應用程式就能在連線中斷後在本機恢復播放。
- 在提供 Context 時填入 CastPlayer 的 DeviceInfo。這可讓您將 MediaSession 連結至 RoutingSession，這是整合 Output Switcher 所需的必要步驟 (#1056)。
移除已淘汰的符號：
- 移除已淘汰的 DefaultEncoderFactory 建構函式。改用 DefaultEncoderFactory.Builder。

1.5.0-alpha01 版本

2024 年 9 月 10 日

這個版本包含自 1.4.1 版本以來的下列變更：

通用程式庫：
- 新增 ForwardingSimpleBasePlayer，允許轉寄至其他播放器，並進行小幅調整，同時確保完整一致性和事件監聽器處理方式。(#1183)。
- 將 SimpleBasePlayer.State.playlist 替換為 getPlaylist() 方法。
- 為 SimpleBasePlayer.State.Builder.setPlaylist() 新增覆寫值，直接指定 Timeline 和目前的 Tracks 和 Metadata，而非建構播放清單結構。
- 將 minSdk 提高至 21 (Android Lollipop)。這與所有其他 AndroidX 程式庫一致。
- 新增 androidx.media3:media3-common-ktx 構件，提供以 Common 程式庫為基礎的 Kotlin 專屬功能
- 新增 Player.listen 暫停擴充功能，以便旋轉協同程式，讓其監聽 Player.Events 至 media3-common-ktx 程式庫。
ExoPlayer：
- MediaCodecRenderer.onProcessedStreamChange() 現在可針對每個媒體項目呼叫。先前並未為第一個項目呼叫此方法。請使用 MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart() 啟用這項功能。
- 新增 PreloadMediaSource.PreloadControl.onPreloadError，讓 PreloadMediaSource.PreloadControl 實作在發生錯誤時採取行動。
- 新增 BasePreloadManager.Listener，將預先載入事件傳播至應用程式。
- 允許變更 SNTP 用戶端逾時時間，並在逾時時重試其他地址 (#1540)。
- 移除 MediaCodecAdapter.Configuration.flags，因為該欄位一律為零。
- 允許使用者在 Wear OS API 35 以上版本 (裝置宣傳支援此功能) 中選取內建喇叭進行播放。
- 延遲對 Context.getSystemService(Context.AUDIO_SERVICE) 的封鎖呼叫，直到啟用音訊焦點處理機制為止。這樣可確保在未啟用音訊焦點處理功能時，不會執行封鎖呼叫 (#1616)。
- 載入失敗時，無論緩衝時間長短，都允許播放 (#1571)。
- 新增 AnalyticsListener.onRendererReadyChanged()，在個別轉譯器允許播放時傳送信號。
轉換程式：
- 新增 SurfaceAssetLoader，可透過 Surface 將影片資料排入 Transformer 的佇列。
- ImageAssetLoader 會透過 AssetLoader.onError 回報不支援的輸入內容，而不是擲回 IllegalStateException。
擷取工具：
- 允許 Mp4Extractor 和 FragmentedMp4Extractor 識別 H264 樣本，這些樣本不會用於後續樣本的參考。
- 新增選項，在 AmrExtractor 中啟用以索引為依據的尋找功能。
- 將有效影格間的 MP3 檔案視為截斷 (而非無效)，也就是說，如果檔案結尾的資料不是 MP3，且沒有其他中繼資料可指出 MP3 位元組的長度，現在會在 MP3 資料結尾停止播放，而不會因 ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} 而失敗 (#1563)。
資料來源：
- 更新 HttpEngineDataSource，讓使用者從 S 擴充功能 7 版開始使用，而非 API 級別 34 (#1262)。
音訊：
- 如果媒體中含有 CTA-2075 音量中繼資料，系統會自動在編解碼器上設定中繼資料。
- 確保在快轉時，音量能平穩下降。
影片：
- MediaCodecVideoRenderer 可避免解碼未經轉譯或未用於其他樣本做為參考的樣本。
- 在 API 35 以上級別，MediaCodecAdapter 現在可能會在 configure 中接收 null Surface，並呼叫新的 detachOutputSurface 方法，以移除先前設定的 Surface (如果編解碼器支援此操作，則為 MediaCodecInfo.detachedSurfaceSupported)。
- 如果在處理 onOutputFormatChanged 時提供 MediaCodecAdapter 提供的像素顯示比例值，請使用該值 (#1371)。
文字：
- 新增自訂 VoiceSpan，並為 WebVTT 語音區段填入資料。(#1632)。
圖片：
- 新增 ExternallyLoadedImageDecoder，簡化與 Glide 或 Coil 等外部圖片載入程式庫的整合作業。
資料來源：
- 新增 FileDescriptorDataSource，這是可用於從 FileDescriptor 讀取的新 DataSource。(#3757)。
效果：
- 新增 DefaultVideoFrameProcessor 解決方法，以便縮放次要 SurfaceTexture。SurfaceTexture 可能會包含小型縮放功能，可在經過裁剪的緩衝區邊緣周圍裁掉 1 個像素格子邊框。這項問題現已解決，輸出內容更接近預期結果。
- 加快 DefaultVideoFrameProcessor.queueInputBitmap()。因此，使用 Transformer 將圖片匯出至影片的速度會更快。
IMA 擴充功能：
- 修正清除播放清單可能導致 ImaServerSideAdInsertionMediaSource 中的 ArrayIndexOutOfBoundsException 的問題。
工作階段：
- 新增 MediaButtonReceiver.shouldStartForegroundService(Intent)，讓應用程式藉由覆寫此方法，抑制播放命令的播放暫停功能。根據預設，系統一律會啟動服務，且如果播放作業未受到抑制，系統就會使用 ForegroundServiceDidNotStartInTimeException 導致服務當機 (#1528)。
DASH 擴充功能：
- 新增支援從區段中間開始的期間。(#1440)。
解碼器擴充功能 (FFmpeg、VP9、AV1 等)：
- 新增 IAMF 解碼器模組，可支援播放含有 IAMF 音軌的 MP4 檔案，並使用 libiamf 原生程式庫合成音訊。
  - 系統會啟用立體聲版面配置，以及啟用空間化功能的 5.1 聲道，並啟用選用的頭部追蹤功能，但目前不支援雙耳播放功能。
Cast 擴充功能：
- 在 CastSession 中斷後停止清除時間軸，這樣發送端應用程式就能在連線中斷後在本機繼續播放。
- 在提供 Context 時填入 CastPlayer 的 DeviceInfo。這可讓您將 MediaSession 連結至 RoutingSession，這是整合 Output Switcher 所需的必要步驟 (#1056)。
測試公用程式：
- DataSourceContractTest 現在包含用於驗證以下項目的測試：
  - 輸入串流 read position 已更新。
  - 輸出緩衝區 offset 已正確套用。
移除已淘汰的符號：
- 移除已淘汰的 Player.hasPrevious、Player.hasPreviousWindow()。請改用 Player.hasPreviousMediaItem()。
- 移除已淘汰的 Player.previous() 方法。改用 Player.seekToPreviousMediaItem()。
- 移除已淘汰的 DrmSessionEventListener.onDrmSessionAcquired 方法。

1.4.0 版本

1.4.1 版本

2024 年 8 月 27 日

發布了 androidx.media3:media3-*:1.4.1。1.4.1 版包含這些修訂項目。

ExoPlayer：
- 在 PreloadMediaSource 中以非同步方式處理預先載入回呼 (#1568)。
- 載入失敗時，無論緩衝時間長短，都允許播放 (#1571)。
擷取工具：
- MP3：根據 Info 影格中的長度欄位，正確略過尾隨的非 MP3 資料，以修正 Searched too many bytes 錯誤 (#1480)。
文字：
- TTML：修正百分比 tts:fontSize 值的處理方式，確保這些值能正確繼承自含有百分比 tts:fontSize 值的父節點。
- 修正 LegacySubtitleUtil 中的 IndexOutOfBoundsException，因為系統無法正確處理要求的輸出開始時間大於或等於 Subtitle 中最終事件時間的情況 (#1516)。
DRM：
- 修正在播放 L1 Widevine 內容的 API 31 以上版本裝置上發生的 android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE 錯誤。這個錯誤是因為架構 MediaDrm.requiresSecureDecoder 方法的實作不完整 (#1603)。
效果：
- 將 release() 方法新增至 GlObjectsProvider。
工作階段：
- 將 KEYCODE_HEADSETHOOK 的輕觸兩下動作轉換為「seek to next」動作，如說明文件所述 (#1493)。
- 在 MediaButtonReceiver 中將 KEYCODE_HEADSETHOOK 視為「播放」指令，以便決定是否要忽略該指令，以免產生 ForegroundServiceDidNotStartInTimeException。(#1581)。
RTSP 擴充功能：
- 在 SDP 剖析中略過無效的媒體描述 (#1087)。

1.4.0 版本

2024 年 7 月 25 日

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

通用程式庫：
- 將假設為無操作的搜尋呼叫傳遞至受保護的 BasePlayer.seekTo() 和 SimpleBasePlayer.handleSeek() 方法，而不是忽略這些呼叫。如果您在自訂播放器中實作這些方法，可能需要使用 mediaItemIndex == C.INDEX_UNSET 處理這些額外的呼叫。
- 移除對強化版 Java 8 去除糖化的編譯依附元件 (#1312)。
- 確認傳遞至 MediaItem.Builder.setImageDurationMs() 的時間長度會忽略非圖片 MediaItem (如說明所述)。
- 新增 Format.customData 以儲存應用程式提供的 Format 例項相關自訂資訊。
ExoPlayer：
- 新增 BasePreloadManager，根據 rankingData 定義的優先順序，協調多個來源的預先載入作業。您可以透過擴充這個類別來進行自訂。新增 DefaultPreloadManager，該元素會使用 PreloadMediaSource 將來源的媒體樣本預先載入記憶體，並使用整數 rankingData 表示 UI 上項目的索引。
- 將 PlayerId 新增至 LoadControl 的大多數方法，讓 LoadControl 實作項目支援多位玩家。
- 移除 Buffer.isDecodeOnly() 和 C.BUFFER_FLAG_DECODE_ONLY。由於轉譯器和解碼器會根據時間戳記決定是否略過緩衝區，因此不需要設定這個標記。自訂 Renderer 實作項目應檢查緩衝時間是否至少為 BaseRenderer.getLastResetPositionUs()，以決定是否應顯示樣本。自訂 SimpleDecoder 實作項目可視需要檢查 isAtLeastOutputStartTimeUs()，或使用 DecoderOutputBuffer.shouldBeSkipped 標記其他緩衝區，以便略過這些緩衝區。
- 允許 TargetPreloadStatusControl.getTargetPreloadStatus(T) 傳回空值，表示不使用指定 rankingData 預先載入 MediaSource。
- 將 remove(MediaSource) 新增至 BasePreloadManager。
- 將 reset() 新增至 BasePreloadManager，釋出所有保留來源，同時保留預先載入管理員例項。
- 新增 ExoPlayer.setPriority() (和 Builder.setPriority())，定義在 PriorityTaskManager 中使用的優先順序值，以及 API 35 中的 MediaCodec 重要性。
- 修正更新上次重新緩衝時間時，導致 CMCD 中 bs (緩衝區飢餓) 鍵錯誤的問題 (#1124)。
- 新增 PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) 以表示來源已載入至結尾。這可讓 DefaultPreloadManager 和自訂 PreloadMediaSource.PreloadControl 實作項目預先載入下一個來源，或執行其他動作。
- 修正在項目結尾跳過靜音時，可能會觸發播放例外狀況的錯誤。
- 將 clear 新增至 PreloadMediaSource，即可捨棄預先載入期間。
- 新增錯誤代碼 PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED，用於在為優先順序較高的工作回收編碼器資源時。
- 讓 AdsMediaSource 在初始內容媒體準備完成前載入片頭廣告 (#1358)。
- 修正錯誤：在原始週期已從資訊清單中移除後，重新準備多週期 DASH 直播時，播放作業會移至 STATE_ENDED。
- 將 PreloadMediaSource.PreloadControl 中的 onTimelineRefreshed() 重新命名為 onSourcePrepared()，並將 onPrepared() 重新命名為 onTracksSelected()。並相應地重新命名 DefaultPreloadManager.Stage 中的 IntDefs。
- 新增實驗性功能，支援動態排程，以便更妥善地將工作與 CPU 喚醒週期對齊，並延遲喚醒時間，讓轉譯器可以繼續進行。您可以在設定 ExoPlayer 例項時，使用 experimentalSetDynamicSchedulingEnabled() 啟用這項功能。
- 新增 Renderer.getDurationToProgressUs()。Renderer 可以實作這個方法，將播放器必須提前播放的時間長度傳回給 ExoPlayer，以便轉譯器繼續播放。如果 ExoPlayer 是使用 experimentalSetDynamicSchedulingEnabled() 設定，ExoPlayer 會在計算排定工作工作的時間時呼叫此方法。
- 新增 MediaCodecAdapter#OnBufferAvailableListener 以便在 MediaCodecRenderer 可使用輸入和輸出緩衝區時發出快訊。MediaCodecRenderer 會在收到這些回呼時傳送信號給 ExoPlayer，如果 ExoPlayer 是使用 experimentalSetDynamicSchedulingEnabled() 設定，ExoPlayer 就會排程其工作迴圈，因為轉譯器可以取得進度。
- 請使用資料類別來處理 LoadControl 方法，而非個別參數。
- 新增 ExoPlayer.isReleased()，檢查是否已呼叫 Exoplayer.release()。
- 新增 ExoPlayer.Builder.setMaxSeekToPreviousPositionMs() 來設定 seekToPrevious() 搜尋上一個項目的最大位置 (#1425)。
- 修正部分音訊焦點不一致的問題，例如在播放器暫停時，未回報完整或暫時性焦點遺失 (#1436)。
- 修正擷取器在初始準備步驟後回報額外曲目所造成的潛在 IndexOutOfBoundsException (#1476)。
- ExoPlayer.setVideoEffect() 中的 Effects 會收到經過移除轉譯器偏移的時間戳記。(#1098)。
- 修正在處理播放器錯誤時，發生在讀取其他播放清單項目時的潛在 IllegalArgumentException (#1483)。
轉換程式：
- 將 audioConversionProcess 和 videoConversionProcess 新增至 ExportResult，指出輸出檔案中各個音軌的製作方式。
- 放寬裁剪最佳化 H.264 等級檢查。
- 新增支援功能，可依序切換 SDR 和 HDR 輸入媒體。
- 新增對組合層級音效的支援。
- 新增將 Ultra HDR 圖片轉碼為 HDR 影片的支援功能。
- 修正 DefaultAudioMixer 在重設及重複使用後，不會輸出正確位元組數量的問題。
- 解決解碼器錯誤，即處理 PCM 輸入時，音訊通道數量上限為立體聲。
- 在 ExoPlayerAssetLoader 中選取音軌時，請忽略音訊聲道數限制，因為這項限制只會套用於播放。
- 將 androidx.media3.transformer.Muxer 介面替換為 androidx.media3.muxer.Muxer，並移除 androidx.media3.transformer.Muxer。
- 修正從內容 URI 配置載入 HEIC 圖片的問題。(#1373)。
- 在 AudioGraphInput 中調整音軌時間長度，以改善影音同步。
- 移除 ExportResult.processedInputs 欄位。如果您要使用這個欄位提供編解碼詳細資料，請改用 DefaultDecoderFactory.listener。如果發生編解碼例外狀況，您可以在 ExportException.codecInfo 中查看編解碼詳細資料。
擷取工具：
- MPEG-TS：將串流的最後一個存取單位傳遞至取樣佇列，藉此回溯變更，確保最後一格畫面會算繪 (#7909)。納入修正項目，解決僅含 I 框的 HLS 串流(#1150) 和 H.262 HLS 串流 (#1126) 出現的問題。
- MP3：優先使用 Info 影格中的資料大小，而非基礎串流 (例如檔案大小或 HTTP Content-Length 標頭) 回報的大小。這有助於從持續比特率搜尋計算中排除無法播放的預告片資料 (例如專輯封面)，讓搜尋更準確 (#1376)。
- MP3：使用 Info 影格 (如有) 中的影格計數和其他資料，計算固定比特率搜尋的平均比特率，而非從 Info 影格後方影格的比特率推估，因為後者可能會人為地偏低，例如 PCUT 影格 (#1376)。
- 修正 AVI 容器中的 PCM 音訊格式擷取問題。
音訊：
- 修正 DTS:X Profile 2 編碼屬性，以便進行直通播放 (#1299)。
- 對於卸載播放作業，請在呼叫 AudioTrack.stop() 之前，先在 DefaultAudioSink 中重設串流完成的追蹤欄位，以便 AudioTrack.StreamEventCallback#onPresentationEnded 正確識別所有待播放資料。
- 修正 SilenceSkippingAudioProcessor 中的錯誤，在不同音訊格式之間的轉換 (例如立體聲轉換為單聲道) 可能會導致處理器擲回例外狀況 (#1352)。
- 實作 MediaCodecAudioRenderer.getDurationToProgressUs()，讓 ExoPlayer 在 MediaCodecAudioRenderer 可取得進展時，動態排定其主要工作迴圈。
影片：
- 修正在播放過程中切換介面時，Listener.onRenderedFirstFrame() 提早到達的問題。
- 修正 Dolby Vision 中的解碼器備用邏輯，視需要使用相容的 AV1 解碼器 (#1389)。
- 修正在播放期間啟用影片轉譯器時，可能會導致轉碼器例外狀況的問題。
文字：
- 修正在跳過某個尋找位置之前，字幕會跳過的問題。這個問題僅在 Media3 1.4.0-alpha01 中出現。
- 變更預設的字幕剖析行為，讓剖析作業在擷取期間而非轉譯期間執行 (請參閱ExoPlayer 的架構圖，瞭解擷取和轉譯的差異)。
  - 如要覆寫這項變更，請同時呼叫 MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) 和 TextRenderer.experimentalSetLegacyDecodingEnabled(true)。如要瞭解如何將這些元件連接至 ExoPlayer 例項，請參閱自訂說明文件。這些方法 (以及所有舊版字幕解碼支援功能) 將在日後推出的版本中移除。
  - 含有自訂 SubtitleDecoder 實作項目的應用程式需要更新，改為實作 SubtitleParser (以及 SubtitleParser.Factory 而非 SubtitleDecoderFactory)。
- PGS：修正長度長度解碼，將 0 解析為顏色索引，而非字面上的顏色值 (#1367)。
- CEA-708：忽略 rowLock 值。CEA-708-E S-2023 規格指出，無論串流中顯示的值為何，都應假設 rowLock 和 columnLock 都是 true (columnLock 支援功能並未實作，因此系統會假設該值一律為 false)。
  - 這項功能原本已納入 1.3.0-alpha01 版本資訊，但在 1.3.0-rc01 發布前，變更內容不慎遭到還原。這個問題現已修正，因此變更內容會再次顯示。
- CEA-708：避免 ExoPlayer 在處理「set pen location」指令時，新增重複的換行符號 (#1315)。
- 當 WebVTT 字幕樣本不含任何提示 (例如 DASH 串流的一部分) 時，請修正 LegacySubtitleUtil 中的 IllegalArgumentException (#1516)。
中繼資料：
- 修正 MP4 與 ID3 排序標記的對應關係。先前，系統會將「album sort」(soal)、「artist sort」(soar) 和「album artist sort」(soaa) MP4 標記錯誤對應至 TSO2、TSOA 和 TSOP ID3 標記 (#1302)。
- 修正讀取 MP4 (/iTunes) 數字 gnre (類型) 和 tmpo (節奏) 標記的問題，當值長度超過一個位元組時。
- 將 ID3 TCON 影格傳播至 MediaMetadata.genre (#1305)。
圖片：
- 新增對非正方形 DASH 縮圖格線的支援 (#1300)。
- 新增對 API 34 以上版本的 AVIF 支援。
- 允許 null 做為 ExoPlayer.setImageOutput() 的參數，以清除先前設定的 ImageOutput。
資料來源：
- 實作 android.resource://package/id 原始資源 URI 的支援功能，其中 package 與目前應用程式的套件不同。這項做法先前未在文件中說明可行，但比起依名稱存取其他套件中的資源，這更有效率。
- 在 DataSpec 建構函式中，積極檢查 url 是否非空值。這個參數已標註為非空值。
- 允許 ByteArrayDataSource 在 open() 期間將 URI 解析為位元組陣列，而非在建構時硬式編碼 (#1405)。
DRM：
- 允許在 DefaultDrmSessionManagerProvider 上設定 LoadErrorHandlingPolicy。(#1271)。
效果：
- 在 SpeedChangeEffect 中，支援在同一個 EditedMediaItem 或 Composition 中進行多項速度變更。
- 支援從超 HDR 點陣圖輸入 HLG 和 PQ 輸出。
- 新增對 EGL_GL_COLORSPACE_BT2020_HLG_EXT 的支援，可改善 ExoPlayer.setVideoEffect 和 Transformer 的 Debug SurfaceView 中的 HLG 途徑輸出。
- 更新覆蓋矩陣實作，藉由翻轉 setOverlayFrameAnchor() 中套用的 x 和 y 值，使其與說明文件一致。如果使用 OverlaySettings.Builder.setOverlayFrameAnchor()，請將 x 和 y 值乘以 -1 來翻轉。
- 修正 TimestampWrapper 與 ExoPlayer#setVideoEffects 搭配使用時會異常終止的問題 (#821)。
- 將預設 SDR 色彩工作空間從線性顏色變更為電氣 BT 709 SDR 影片。另外提供第三個選項，可保留原始的色彩空間。
- 允許定義 EditedMediaItemSequences 的不確定 z 順序 (#1055)。
- 在不同 HDR 內容之間維持一致的亮度範圍 (使用 HLG 範圍)。
- 新增 HDR 內容的 Ultra HDR (位圖) 疊加層支援功能。
- 允許在 API 26 之前使用 SeparableConvolution 特效。
- 移除未使用的 OverlaySettings.useHdr，因為疊加圖層和影格必須使用相同的動態範圍。
- 新增 TextOverlay 的 HDR 支援功能。您可以使用 OverlaySettings.Builder.setHdrLuminanceMultiplier() 調整文字覆蓋層的亮度。
IMA 擴充功能：
- 將應用程式播放DAI 廣告串流所需的 API 升級為穩定版。
- 將 replaceAdTagParameters(Map <String, String>) 新增至 ImaServerSideAdInsertionMediaSource.AdLoader，以便在執行階段取代廣告標記參數。
- 修正廣告播放期間發生播放器錯誤時，系統未呼叫 VideoAdPlayer.VideoAdPlayerCallback.onError() 的錯誤 (#1334)。
- 將 IMA SDK 版本升級至 3.33.0，以便修正使用 data:// 廣告代碼 URI 時的 NullPointerException (#700)。
工作階段：
- 將 CommandButton.enabled 的預設值變更為 true，並確保即使可使用相關聯的指令，控制器的值仍可保持為 false。
- 為 CommandButton 新增圖示常數，應使用該常數取代自訂圖示資源。
- 新增 MediaSessionService.isPlaybackOngoing()，讓應用程式查詢是否需要在 onTaskRemoved() 中停止服務。(#1219)。
- 新增 MediaSessionService.pauseAllPlayersAndStopSelf()，方便暫停所有工作階段的播放，並呼叫 stopSelf() 終止 MediaSessionService 的生命週期。
- 覆寫 MediaSessionService.onTaskRemoved(Intent) 以提供安全的預設實作方式，在播放中時讓服務持續在前景執行，否則則停止服務。
- 將時間長度設為平台工作階段中繼資料，即可隱藏直播媒體通知中的尋軌列 (#1256)。
- 將 MediaMetadata 轉換為 MediaDescriptionCompat，以便在選取中繼資料屬性時，使用與 media1 相同的偏好順序和邏輯。
- 新增 MediaSession.sendError()，可將非致命錯誤傳送至 Media3 控制器。使用通知控制器 (請參閱 MediaSession.getMediaNotificationControllerInfo()) 時，自訂錯誤會用於將平台工作階段的 PlaybackState 更新為錯誤狀態，並提供指定的錯誤資訊 (#543)。
- 新增 MediaSession.Callback.onPlayerInteractionFinished()，在特定控制器的一系列玩家互動完成時通知工作階段。
- 新增 SessionError，並在 SessionResult 和 LibraryResult 中使用該值，而非錯誤代碼，以便提供有關錯誤的更多資訊，並盡可能提供解決錯誤的方法。
- 發布 media3 控制器測試應用程式的程式碼，用於測試與發布媒體工作階段的應用程式互動情形。
- 將傳遞至 media3 的 MediaSession[Builder].setSessionExtras() 額外項目，傳播至 media1 控制器的 PlaybackStateCompat.getExtras()。
- 將嚴重和一般錯誤對應至平台工作階段。PlaybackException 會對應至 PlaybackStateCompat 的致命錯誤狀態。以 MediaSession.sendError(ControllerInfo, SessionError) 傳送至媒體通知控制器的 SessionError 會對應至 PlaybackStateCompat 中的非重大錯誤，這表示已設定錯誤代碼和訊息，但平台工作階段的狀態仍與 STATE_ERROR 不同。
- 允許為每個控制器設定工作階段活動，以便覆寫全域工作階段活動。您可以使用 AcceptedResultBuilder.setSessionActivivty(PendingIntent) 建立 ConnectionResult，藉此在連線時為控制器定義工作階段活動。連線後，您可以使用 MediaSession.setSessionActivity(ControllerInfo, PendingIntent) 更新工作階段活動。
- 改善對 MediaLibrarySession.Callback 的呼叫錯誤複製功能。您現在可以使用 MediaLibrarySession.Builder.setLibraryErrorReplicationMode() 選擇錯誤類型，或選擇停用預設啟用的錯誤複製功能，來設定錯誤複製功能。
UI：
- 在連接至 ExoPlayer 時，為 PlayerView 新增圖片顯示支援功能 (#1144)。
- 透過 XML 屬性在 PlayerControlView 中新增各種圖示的自訂設定，以便為每個 PlayerView 例項允許不同的可繪項目，而非全域覆寫 (#1200)。
- 在 API 34 的 Compose AndroidView 中使用 SurfaceView 時，解決會導致影片拉長/裁剪的平台錯誤 (#1237)。
下載內容：
- 確認 DownloadHelper 不會洩漏未發布的 Renderer 例項，因為這可能會導致應用程式與 IllegalStateException: Too many receivers, total of 1000, registered for pid 一同異常終止 (#1224)。
Cronet 擴充功能：
- 修正 CronetDataSource 中的 SocketTimeoutException。在某些版本的 Cronet 中，回呼提供的要求不一定相同。這會導致回呼無法完成，且要求逾時 (https://issuetracker.google.com/328442628)。
HLS 擴充功能：
- 修正以下錯誤：待處理的 EMSG 樣本在 HlsSampleStreamWrapper 中以不正確的偏移量委派，導致 IndexOutOfBoundsException 或 IllegalArgumentException (#1002)。
- 修正非主要播放清單會持續重新載入 LL-HLS 串流的問題 (#1240)。
- 修正錯誤：為 HLS 啟用 CMCD 時，初始化區段會導致 Source Error 和 IllegalArgumentException。
- 修正在直播播放期間，非主要播放播放清單未更新的錯誤 (#1240)。
- 修正為 HLS 即時串流啟用 CMCD 時會導致 ArrayIndexOutOfBoundsException 的錯誤 (#1395)。
DASH 擴充功能：
- 修正重新準備多時段直播時，可能會擲回 IndexOutOfBoundsException 的錯誤 (#1329)。
- 新增對 dashif:Laurl 授權網址的支援 (#1345)。
Cast 擴充功能：
- 修正在 Media3 媒體項目中，將 MediaQueueItem 的專輯名稱轉換為藝人名稱的錯誤 (#1255)。
測試公用程式：
- 在 FakeRenderer 中實作 onInit() 和 onRelease()。
- 變更 TestPlayerRunHelper.runUntil()/playUntil() 方法，以便在發生非致命錯誤 (例如回報至 AnalyticsListener.onVideoCodecError() 的錯誤) 時失敗。使用新的 TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX() 方法鏈結來停用這項行為。
試用版應用程式：
- 在短片應用程式示範中使用 DefaultPreloadManager。
- 允許透過指令列的 Intent 引數設定重複模式 (#1266)。
- 如果裝置支援，請使用 HttpEngineDataSource 做為 HttpDataSource。
移除已淘汰的符號：
- 移除 CronetDataSourceFactory。改用 CronetDataSource.Factory。
- 移除部分 DataSpec 建構函式。改用 DataSpec.Builder。
- 從 DefaultHttpDataSource、OkHttpDataSource 和 CronetDataSource 中移除 setContentTypePredicate(Predicate) 方法。請改為在每個 XXXDataSource.Factory 上使用等效方法。
- 移除 OkHttpDataSource 建構函式和 OkHttpDataSourceFactory。請改用 OkHttpDataSource.Factory。
- 移除 PlayerMessage.setHandler(Handler)。改用 setLooper(Looper)。
- 移除 Timeline.Window.isLive 欄位。請改用 isLive() 方法。
- 移除 DefaultHttpDataSource 建構函式。改用 DefaultHttpDataSource.Factory。
- 移除 DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS。改用 DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS。
- 移除 MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean)。改用 MediaCodecInfo.canReuseCodec(Format, Format)。
- 移除 DrmSessionManager.DUMMY 和 getDummyDrmSessionManager() 方法。請改用 DrmSessionManager.DRM_UNSUPPORTED。
- 移除 AnalyticsListener.onAudioInputFormatChanged(EventTime, Format)、AnalyticsListener.onVideoInputFormatChanged(EventTime, Format)、AudioRendererEventListener.onAudioInputFormatChanged(Format)、VideoRendererEventListener.onVideoInputFormatChanged(Format)。請改用採用 DecoderReuseEvaluation 的超載。
- 移除 RendererSupport.FormatSupport IntDef 和 FORMAT_HANDLED、FORMAT_EXCEEDS_CAPABILITIES、FORMAT_UNSUPPORTED_DRM、FORMAT_UNSUPPORTED_SUBTYPE、FORMAT_UNSUPPORTED_TYPE 常數。請改用 androidx.media3.common.C 中的等效 IntDef 和常數 (例如 C.FORMAT_HANDLED)。
- 移除 Bundleable 介面。這包括移除所有 Bundleable.Creator<Foo> CREATOR 常數欄位。呼叫端應改為針對每個類型使用 Bundle toBundle() 和 static Foo fromBundle(Bundle) 方法。

1.4.0-rc01 版本

2024 年 7 月 10 日

使用 1.4.0 穩定版。

1.4.0-beta01 版本

2024 年 6 月 26 日

使用 1.4.0 穩定版。

1.4.0-alpha02 版

2024 年 6 月 7 日

使用 1.4.0 穩定版。

1.4.0-alpha01 版

2024 年 4 月 17 日

使用 1.4.0 穩定版。

1.3.0 版本

1.3.1 版本

2024 年 4 月 11 日

發布了 androidx.media3:media3-*:1.3.1。1.3.1 版包含這些修訂項目。

通用程式庫：
- 新增 Format.labels，允許使用經本地化或其他替代標籤。
ExoPlayer：
- 修正 PreloadMediaPeriod 在再次預先載入時無法保留串流的問題。
- 在重新選取曲目時，將正確的對應 TrackSelectionResult 套用至播放期間。
- 在媒體項目之間轉換時，只有在提前啟用轉譯器後，才開始提前播放 (#1017)。
- 為 DefaultVideoFrameProcessor.Factory.Builder.build() 的 proguard -keepclasseswithmembers 規則新增缺少的傳回類型。(#1187)。
轉換程式：
- 針對 MediaMuxer 在 API 30 之前不支援負面呈現時間戳記而擲回的例外狀況，新增解決方法。
曲目選取：
- DefaultTrackSelector：請優先使用「合理」的影片音軌 (每秒 10 張影格以上)，而非低於或未設定的每秒影格數。這可確保播放器從動態相片中擷取的 MP4 中選取「實際」的影片音軌，其中可能包含兩個 HEVC 音軌，其中一個具有較高的解析度，但幀數非常少 (#1051)。
擷取工具：
- 修正從 WAV 檔案讀取奇數大小的區塊時，未略過填充資料的問題 (#1117)。
- MP3：從 XING 和 VBRI 等中繼資料框架填入 Format.averageBitrate。
- MPEG-TS：還原變更，該變更旨在透過將串流的最後存取單位傳遞至取樣佇列，確保最後一格會算繪 (#7909)。這是因為這項變更會導致僅含 I 框的 HLS 串流 (#1150) 和 H.262 HLS 串流 (#1126) 出現新問題。
音訊：
- 如果音訊音軌無法在卸載模式下初始化，請停用卸載功能，允許轉譯器復原。
影片：
- 針對 Galaxy Tab S7 FE、Chromecast 支援 Google TV 和 Lenovo M10 FHD Plus 的裝置問題，新增解決方法，以免 60fps H265 串流流量標示為不支援
- 新增權變措施，確保在建立隧道時，即使裝置未依 API 要求自動執行這項操作，也能一律算繪第一個影格 (#1169)。(#966)。
- 修正 HDR 色彩資訊處理會導致編解碼器異常行為，並防止 SDR 影片音軌使用可調整式格式切換的情形。(#1158)。
文字：
- WebVTT：避免直接連續提示從 WebvttParser.parse 建立額外的 CuesWithTiming 例項 (#1177)。
DRM：
- 解決 NoSuchMethodError 問題，在某些 Android 14 裝置上，NoSuchMethodError 可能會由 MediaDrm 架構擲回，而非 ResourceBusyException 或 NotProvisionedException (#1145)。
效果：
- 透過轉換色域，改善 PQ 到 SDR 的色調對應。
工作階段：
- 修正控制器取代目前項目時，目前位置會跳回的問題 (#951)。
- 修正在媒體控制器和工作階段之間，只有非空值 extras 的 MediaMetadata 無法傳輸的問題 (#1176)。
UI：
- 如果 Locale 無法識別顯示名稱，則改為加入音軌語言名稱 (#988)。
DASH 擴充功能：
- 將資訊清單中的所有 Label 元素填入 Format.labels (#1054)。
RTSP 擴充功能：
- 在 SDP 剖析中略過空白的工作階段資訊值 (i-tag)。(#1087)。
解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等)：
- 預設會停用 MIDI 擴充功能做為本機依附元件，因為需要設定額外的 Maven 存放區。需要從本機依附元件取得此模組的使用者可以重新啟用此模組。

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 依附元件的必要條件。
- 當至少一個 artworkUri 和 artworkData 非空值時，在 MediaMetadata.Builder.populate(MediaMetadata) 中填入這兩者 (#964)。
ExoPlayer：
- 新增 PreloadMediaSource 和 PreloadMediaPeriod，讓應用程式在播放前，在特定的開始位置預先載入內容媒體來源。PreloadMediaSource 會負責準備內容媒體來源，以便接收 Timeline，並在指定的開始位置準備及快取期間，選取曲目並載入該期間的媒體資料。應用程式可透過實作 PreloadMediaSource.PreloadControl 控制預先載入進度，並將預先載入的來源設為播放器，以便播放。
- 新增 ExoPlayer.setImageOutput，讓應用程式設定 ImageRenderer.ImageOutput。
- DefaultRenderersFactory 現在預設會向播放器提供 ImageRenderer，並使用空值 ImageOutput 和 ImageDecoder.Factory.DEFAULT。
- 當略過靜音時，請發出 Player.Listener.onPositionDiscontinuity 事件 (#765)。
- 新增實驗性支援，可在擷取期間剖析字幕。您可以使用 MediaSource.Factory.experimentalParseSubtitlesDuringExtraction() 啟用這項功能。
- 使用 PreloadMediaSource 支援自適應媒體來源。
- 使用 HttpEngine API 實作 HttpEngineDataSource，這是 HttpDataSource。
- 禁止對 CompositeSequenceableLoader 進行子類化。這個元件先前已可擴充，但從未在程式庫中進行子類別化。您可以使用裝飾器模式包裝例項，並實作自訂 CompositeSequenceableLoaderFactory，藉此完成自訂。
- 修正重複相同時間會導致此項目的中繼資料遭到清除的問題 (#1007)。
- 將 BundledChunkExtractor.Factory 和 DefaultHlsExtractorFactory 上的 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 Extractor 中新增額外的 AV1C 剖析，以便擷取 ColorInfo.colorSpace、ColorInfo.colorTransfer 和 ColorInfo.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.Factory 的 CompositingVideoSinkProvider，並將影片接收器提供者傳遞至 MediaCodecVideoRenderer。
文字：
- 修正點陣圖提示的序列化，以便在使用 DefaultExtractorsFactory.setTextTrackTranscodingEnabled 時解決 Tried to marshall a Parcel that contained Binder objects 錯誤 (#836)。
- CEA-708：忽略 rowLock 值。CEA-708-E S-2023 規格指出，無論串流中顯示的值為何，都應假設 rowLock 和 columnLock 都是 true (columnLock 支援功能未實作，因此系統會假設該值一律為 false)。
圖片：
- 新增對 DASH 縮圖的支援。系統會裁剪格狀圖片，並提供個別縮圖，以便在 ImageOutput 接近顯示時間時顯示。
DRM：
- 根據預設，即使後續加密樣本的金鑰尚未準備就緒，系統也會立即播放 DRM 內容中的「純音訊」未加密樣本。如果播放位置到達加密的樣本時，金鑰仍未準備就緒，就可能導致播放中斷。不過，先前的播放作業不會在這個時間點開始。您可以使用 MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey 或 DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys 停用這項行為。
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)。
- 修正長度超過 47721 秒的 TS 串流的時間估計值 (#855)。
音訊：
- 修正多次呼叫 SilenceSkippingAudioProcessor 時的 EOS 處理方式 (#712)。
影片：
- 針對 Galaxy Tab S7 FE、Chromecast (支援 Google TV) 和 Lenovo M10 FHD Plus 的裝置問題，新增因應措施，以免 60fps AVC 串流標示為不支援 (#693)。
中繼資料：
- 修正錯誤：MediaMetadata 只會從使用大寫鍵的 Vorbis 註解填入資料。(#876)。
- 在剖析非常大的 ID3 影格時擷取 OutOfMemoryError，表示播放作業可以繼續進行，而不會因標記資訊而完全失敗。
DRM：
- 將針對不明確的 ClearKey https://default.url 授權網址的解決方法擴展至 API 33 以上版本 (先前這項解決方法僅適用於 API 33) (#837)。
- 修正在沒有附加至播放器的途徑時，從加密內容切換為清晰內容的 ERROR_DRM_SESSION_NOT_OPENED 問題。這是因為不正確使用安全解碼器播放未加密的內容。
工作階段：
- 將自訂鍵和值從 MediaMetadataCompat 移至 MediaMetadata.extras 和 MediaMetadata.extras 到 MediaMetadataCompat (#756、#802)。
- 修正舊版控制器的 notifyChildrenChanged 廣播問題 (#644)。
- 修正錯誤：為通知的停用 setWhen 計時器設定負數時間，導致部分裝置發生異常終止問題 (#903)。
- 修正 IllegalStateException，當媒體通知控制器在首次要求通知更新時未完成連線 (#917)。
UI：
- 修正在 BottomSheetDialogFragment 中使用 Material Design 時，無法顯示快轉和倒轉按鈕的問題 (#511)。
- 修正 PlayerControlView 快轉按鈕中的數字未對齊的問題 (#547)。
DASH 擴充功能：
- 在 DASH 資訊清單中，將「f800」剖析為 Dolby 的頻道數量為 5 (#688)。
解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等)：
- MIDI：修正向前跳轉時會略過 Program Change 事件的問題 (#704)。
- 遷移至 FFmpeg 6.0，並將支援的 NDK 更新至 r26b (#707、#867)。
Cast 擴充功能：
- 淨化 Timeline 的建立作業，以免在投放裝置上載入媒體失敗時，導致應用程式異常終止 (#708)。

1.2.0 版本

2023 年 11 月 15 日

通用程式庫：
- 在 Log.Logger 介面中的方法中新增 @Nullable Throwable 參數。這些方法的 message 參數不再包含任何關於傳遞至 Log.{d,i,w,e}() 方法的 Throwable 的資訊，因此實作項目需要視需要手動附加這項資訊 (可能使用 Logger.appendThrowableString(String, Throwable))。
- 修正 Kotlin 相容性問題，即未偵測到可為空值的泛型類型參數和可為空值的陣列元素類型為可為空值。例如 TrackSelectorResult 和 SimpleDecoder 方法參數 (#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.canUpdateMediaItem 和 MediaSource.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 除了現有的 playbackPositionUs 外，還包含其他參數，包括 playbackSpeed 和 lastRebufferRealtimeMs。
- 將 ChunkSource 介面中的 ChunkSource.getNextChunk(long, long, List, ChunkHolder) 方法提升至 ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder)。
- 在通用媒體用戶端資料 (CMCD) 記錄中新增其他欄位：緩衝區飢餓 (bs)、期限 (dl)、播放速率 (pr) 和啟動 (su) (#8699)。
- 將亮度和色度位元深度新增至 ColorInfo (#491)。
- 在 Common Media Client Data (CMCD) 記錄中新增其他欄位：下一個物件要求 (nor) 和下一個範圍要求 (nrr) (#8699)。
- 新增功能，以便使用查詢參數傳送通用媒體用戶端資料 (CMCD) 資料 (#553)。
- 修正 ExperimentalBandwidthMeter 中的 ConcurrentModificationException (#612)。
- 將 MediaPeriodId 參數新增至 CompositeMediaSource.getMediaTimeForChildMediaTime。
- 在 ConcatenatingMediaSource2 中支援 ClippingMediaSource (以及其他具有週期/視窗時間偏移的來源) (#11226)。
- 變更 BaseRenderer.onStreamChanged()，讓其也能接收 MediaPeriodId 引數。
轉換程式：
- 剖析圖片輸入內容的 EXIF 旋轉資料。
- 移除 TransformationRequest.HdrMode 註解類型及其相關常數。請改用 Composition.HdrMode 及其相關常數。
- 簡化 OverlaySettings 以修正旋轉問題。
- 已將 SampleConsumer.queueInputBitmap 的 frameRate 和 durationUs 參數變更為 TimestampIterator。
曲目選取：
- 新增 DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness，以便明確允許或禁止非無縫調整。預設會維持 true 目前的行為。
擷取工具：
- MPEG-TS：將串流的最後一個存取單位傳遞至樣本佇列，確保最後一個影格會算繪 (#7909)。
- 修正判斷 rotationDegrees 時的錯字。已將 projectionPosePitch 變更為 projectionPoseRoll (#461)。
- 移除假設 Extractor 例項可直接透過 instanceof 檢查。如果您想在執行階段存取 Extractor 的實作詳細資料，必須先呼叫 Extractor.getUnderlyingInstance。
- 新增 BmpExtractor。
- 新增 WebpExtractor。
- 新增 HeifExtractor。
- 在 Mp4Extractor 中新增對 QuickTime classic 的支援。
音訊：
- 新增對 MP4 和 Matroska 中 24/32 位元大端字 PCM 的支援，並剖析 MP4 中 lpcm 的 PCM 編碼。
- 新增支援 MP4 中的 Vorbis 音訊擷取功能。
- 新增 AudioSink.getFormatOffloadSupport(Format)，可透過 DefaultAudioOffloadSupportProvider 擷取匯流程可為格式提供的卸載支援層級。此方法會傳回包含 isFormatSupported、isGaplessSupported 和 isSpeedChangeSupported 的新 AudioOffloadSupport。
- 新增 AudioSink.setOffloadMode()，透過該函式設定音訊接收端的卸載設定。預設值為 AudioSink.OFFLOAD_MODE_DISABLED。
- 您可以透過 TrackSelectionParameters 中的 setAudioOffloadPreference 啟用卸載功能。如果已啟用設定偏好設定，裝置支援該格式的卸載作業，且所選音軌為單一音訊音軌，系統就會啟用音訊卸載作業。
- 如果 audioOffloadModePreference 設為 AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED，DefaultTrackSelector 只會選取音訊音軌，且只有在該音軌格式在卸載時受支援的情況下才會選取。如果在卸載時未支援任何音軌，系統就不會選取任何音軌。
- 由於曲目轉換後的播放位置問題，在 API 級別 33 以下版本中停用離線播放的無縫支援功能。
- 從 DefaultRenderersFactory.buildAudioSink 方法簽章中移除參數 enableOffload。
- 移除方法 DefaultAudioSink.Builder.setOffloadMode。
- 移除 intdef 值 DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED。
- 新增在離線播放期間支援 Opus 無縫中繼資料。
- 如果首次寫入失敗，請停用卸載功能，以便轉譯器復原 (#627)。
- 預設啟用 Offload Scheduling，以便播放已卸載的純音訊內容。
- 刪除 ExoPlayer.experimentalSetOffloadSchedulingEnabled 和 AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged。
- 已將 onExperimentalSleepingForOffloadChanged 重新命名為 onSleepingForOffloadChanged，並將 onExperimentalOffloadedPlayback 重新命名為 onOffloadedPlayback。
- 將音訊卸載模式相關的 TrackSelectionParameters 介面和定義移至內部 AudioOffloadPreferences 類別。
- 將 onAudioTrackInitialized 和 onAudioTrackReleased 回呼新增至 AnalyticsListener、AudioRendererEventListener 和 AudioSink.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.queueInputBitmap 的 frameRate 和 durationUs 參數變更為 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，設定可用指令和用於填入通知和平台工作階段的自訂版面配置。
- 將 Media3 內 MediaSessionService.onStartCommand() 收到的媒體按鈕事件轉換，而非將這些事件重新導向至平台工作階段，再傳回至 Media3。如此一來，呼叫端控制器一律會是媒體通知控制器，應用程式就能在所有支援的 API 級別上以相同方式輕鬆辨識來自通知的呼叫。
- 修正連線至舊版 MediaSessionCompat 時，MediaController.getCurrentPosition() 不會推進的錯誤。
- 為方便起見，請新增 MediaLibrarySession.getSubscribedControllers(mediaId)。
- 覆寫 MediaLibrarySession.Callback.onSubscribe()，宣告控制器訂閱的父項 ID 是否可用。如果成功，系統會接受訂閱，並立即呼叫 notifyChildrenChanged() 通知瀏覽器 (#561)。
- 新增 Automotive OS 的工作階段示範模組，並啟用 Android Auto 的工作階段示範。
- 如果媒體通知控制器無法使用 COMMAND_GET_TIMELINE，請勿設定架構工作階段的佇列。將 Android Auto 做為從架構工作階段讀取的用戶端控制器，這樣一來，Android Auto 的 UI 就不會顯示 queue 按鈕 (#339)。
- 預設使用 DataSourceBitmapLoader 而非 SimpleBitmapLoader。(#271、#327)。
- 新增 MediaSession.Callback.onMediaButtonEvent(Intent)，讓應用程式覆寫預設的媒體按鈕事件處理方式。
UI：
- 為 Wear OS 裝置新增 Player.Listener 實作項目，以便處理因 Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT 而抑制播放功能的情況，方法是啟動系統對話方塊，讓使用者連線至適當的音訊輸出裝置 (例如藍牙耳機)。如果在可設定的逾時時間 (預設為 5 分鐘) 內連上合適的裝置，監聽器就會自動繼續播放。
下載內容：
- 為 DownloadService 聲明「dataSync」前景服務類型，以便與 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)。
- 忽略 Options 回應公開標頭中的自訂 Rtsp 要求方法 (#613)。
- 在傳送保活 RTSP 選項要求的時間間隔中使用 RTSP 設定回應逾時值 (#662)。
解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等)：
- 發布 MIDI 解碼器模組，支援使用 Jsyn 程式庫合成音訊，以便播放標準 MIDI 檔案。
- 新增 DecoderOutputBuffer.shouldBeSkipped，直接標示不需要呈現的輸出緩衝區。建議您使用此方法，而非即將淘汰的 C.BUFFER_FLAG_DECODE_ONLY。
- 新增 Decoder.setOutputStartTimeUs 和 SimpleDecoder.isAtLeastOutputStartTimeUs，讓解碼器在開始時間之前捨棄僅解碼的樣本。建議您改用 Buffer.isDecodeOnly，後者即將淘汰。
- 修正將 MIDI 解碼器構件發布至 Maven 存放區的錯誤。已將構件重新命名為 media3-exoplayer-midi (#734)。
Leanback 擴充功能：
- 修正停用途徑可能導致 Leanback 程式碼中的 ArithmeticException 的錯誤 (#617)。
測試公用程式：
- 讓 TestExoPlayerBuilder 和 FakeClock 與 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。
- 在 Common Media Client Data (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)。
- 透過舊版指令 (COMMAND_ADJUST_DEVICE_VOLUME 和 COMMAND_SET_DEVICE_VOLUME) 和新指令 (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS 和 COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS) 判斷 volumeControlType，修正 PlayerWrapper 建立 VolumeProviderCompat 的方式 (#554)。

1.1.0 版本

2023 年 7 月 5 日

通用程式庫：
- 新增不合適音訊路徑的抑制原因，並在準備就緒時播放變更抑制太久的原因。 (#15)。
- 新增指令至 Player：
  - 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)。已納入以下欄位：br、bl、cid、rtp 和 sid (#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.sourceId 和 SampleQueue.peekSourceId 的簽章。
- 在 LoadControl 方法 shouldStartPlayback 和 onTracksSelected 中新增參數，讓這些方法與相關的 MediaPeriod 建立關聯。
- 變更 ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>) 的簽章，方法是新增時間軸參數，其中包含以 UID 做為地圖中索引鍵的時間段落。這項設定是為了避免多時段直播發生並行問題。
- 淘汰 EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) 和 BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs)。您可以改為呼叫不含 mediaTimeOffsetUs 的變化版本方法。請注意，即使是已淘汰的變化版本，系統也不會再將偏移量新增至調度器所調度的 MediaLoadData 物件的 startTimeUs 和 endTimeUs。
- 將 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 框設定，因為這項設定無法在部分裝置上運作。
音軌選取：
- 新增預設為停用的 DefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange。啟用後，當轉譯器功能變更時，DefaultTrackSelector 會觸發新的曲目選取作業。
擷取工具：
- Ogg：修正在長時間檔案中搜尋時發生的錯誤 (#391)。
- FMP4：修正 TimestampAdjuster 會使用 emsg atom 的中繼資料範例時間，初始化錯誤的時間戳記偏移值的問題 (#356)。
音訊：
- 修正以下錯誤：啟用隧道且 AudioProcessors 處於活動狀態時，部分播放作業會失敗，例如無縫修剪 (#10847)。
- 在直接播放 (卸載) 中，將 Opus 影格封裝在 Ogg 封包中。
- 在睡眠期間使用卸載排程推斷目前位置。
- 新增 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 不支援影片，或是尚未確定支援的影片軌道大小，ExoPlayer 的影片大小 (含 MediaCodecVideoRenderer) 寬度和高度會是 0。
DRM：
- 在 DefaultDrmSession 上降低多個僅限內部的方法的瀏覽權限，因為這些方法不會從 DRM 套件外部呼叫：
  - void onMediaDrmEvent(int)
  - void provision()
  - void onProvisionCompleted()
  - onProvisionError(Exception, boolean)
Muxer：
- 新增可用於建立 MP4 容器檔案的 muxer 程式庫。
IMA 擴充功能：
- 為動態廣告插播啟用多週期 DASH 直播串流。請注意，目前的實作方式尚不支援在直播中尋找內容 (#10912)。
- 修正在直播中插入新廣告群組的錯誤，因為連續時間軸中計算的內容位置略有不同。
工作階段：
- 新增輔助方法 MediaSession.getControllerForCurrentRequest，以取得目前呼叫 Player 方法的控制器相關資訊。
- 新增 androidx.media3.session.MediaButtonReceiver，讓應用程式可透過媒體按鈕事件 (例如藍牙耳機傳送的事件) 實作播放恢復功能 (#167)。
- 在 MediaSession.Callback.onAddMediaItems 中新增預設實作項目，讓要求的 MediaItems 在有 LocalConfiguration (例如 URI) 時，可傳遞至 Player (#282)。
- 預設會在 Android 12 以下版本的小巧媒體通知檢視畫面中，新增「seek to previous」和「seek to next」指令按鈕 (#410)。
- 在 MediaSession.Callback.onAddMediaItems 中新增預設實作項目，讓要求的 MediaItems 在有 LocalConfiguration (例如 URI) 時，可傳遞至 Player (#282)。
- 預設會在 Android 12 以下版本的小巧媒體通知檢視畫面中，新增「seek to previous」和「seek to next」指令按鈕 (#410)。
UI：
- 新增 Util 方法 shouldShowPlayButton 和 handlePlayPauseButtonAction，以便編寫含有播放/暫停按鈕的自訂 UI 元素。
RTSP 擴充功能：
- 針對 MPEG4-LATM，如果 Describe Response SDP 訊息中未提供 profile-level-id 值，請使用預設值。(#302)。
- 如果 DESCRIBE 回應標頭中提供 RTSP 工作階段，請使用基本 URI 解析相對路徑 (#11160)。
DASH 擴充功能：
- 針對多時段 DASH 串流，從 MediaLoadData.startTimeMs 和 MediaLoadData.endTimeMs 移除媒體時間偏移。
- 修正重新準備多週期即時 Dash 媒體來源時會產生 IndexOutOfBoundsException 的錯誤 (#10838)。
HLS 擴充功能：
- 新增 HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) 來為載入執行緒設定逾時值，等待 TimestampAdjuster 初始化。如果初始化未在逾時前完成，系統會擲回 PlaybackException，以免播放作業無限期停止。根據預設，逾時時間會設為零 (#323)。
測試公用程式：
- 檢查 DataSourceContractTest 中的 URI 配置是否區分大小寫。
移除已淘汰的符號：
- 移除 DefaultAudioSink 建構函式，改用 DefaultAudioSink.Builder。
- 移除 HlsMasterPlaylist，改用 HlsMultivariantPlaylist。
- 移除 Player.stop(boolean)。請改用 Player.stop() 和 Player.clearMediaItems() (如果 reset 是 true)。
- 移除兩個已淘汰的 SimpleCache 建構函式，改用採用 DatabaseProvider 的非淘汰建構函式，以便提升效能。
- 移除 DefaultBandwidthMeter 建構函式，改用 DefaultBandwidthMeter.Builder。
- 移除 DefaultDrmSessionManager 建構函式，改用 DefaultDrmSessionManager.Builder。
- 移除兩個已淘汰的 HttpDataSource.InvalidResponseCodeException 建構函式，使用可接受其他欄位的非淘汰建構函式(cause、responseBody) 來強化錯誤記錄。
- 移除 DownloadHelper.forProgressive、DownloadHelper.forHls、DownloadHelper.forDash 和 DownloadHelper.forSmoothStreaming，改用 DownloadHelper.forMediaItem。
- 移除已淘汰的 DownloadService 建構函式，使用不淘汰的建構函式，其中包含提供 channelDescriptionResourceId 參數的選項。
- 移除已淘汰的字元集字串常數 (ASCII_NAME、UTF8_NAME、ISO88591_NAME、UTF16_NAME 和 UTF16LE_NAME)，改用 kotlin.text 套件、java.nio.charset.StandardCharsets 或 com.google.common.base.Charsets 中的 Kotlin 字元集。
- 移除已淘汰的 WorkManagerScheduler 建構函式，改用不淘汰的建構函式，其中包含提供 Context 參數的選項。
- 移除用於例項化 Format 類別的淘汰方法 createVideoSampleFormat、createAudioSampleFormat、createContainerFormat 和 createSampleFormat。請改用 Format.Builder 建立 Format 的例項。
- 移除已淘汰的方法 copyWithMaxInputSize、copyWithSubsampleOffsetUs、copyWithLabel、copyWithManifestFormatInfo、copyWithGaplessInfo、copyWithFrameRate、copyWithDrmInitData、copyWithMetadata、copyWithBitrate 和 copyWithVideoSize，改用 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.onSeekProcessed 和 AnalyticsListener.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.2。1.0.2 版包含此連結所列的修訂項目。

此版本可對應至 ExoPlayer 2.18.7 版。

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

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

1.0.1 版

2023 年 4 月 18 日

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

此版本可對應至 ExoPlayer 2.18.6 版。

核心程式庫：
- 在搜尋預設位置時，重設目標直播串流覆寫值 (#11051)。
- 修正錯誤：媒體中的空白樣本串流可能導致播放卡住。
工作階段：
- 修正錯誤：由舊版 MediaSessionCompat 發布的多個相同佇列項目，會導致 MediaController 發生例外狀況 (#290)。
- 將遺漏的 MediaSession.broadcastCustomCommand 轉送作業新增至舊版 MediaControllerCompat.Callback.onSessionEvent。(#293)。
- 修正呼叫 MediaSession.setPlayer 時不會更新可用指令的錯誤。
- 修正問題：如果 TrackSelectionOverride 例項參照含有 Format.metadata 的群組，系統會忽略從 MediaController 傳送的例項 (#296)。
- 修正 Player.COMMAND_GET_CURRENT_MEDIA_ITEM 必須透過舊版 MediaSessionCompat 存取中繼資料的問題。
- 修正背景執行緒中的 MediaSession 例項在 MediaSessionService 中使用時導致當機的問題 (#318)。
- 修正程式庫宣告媒體按鈕接收器，但應用程式未預期此動作的問題 (#314)。
DASH：
- 修正空白區隔時間軸的處理方式 (#11014)。
RTSP：
- 如果使用 UDP 的 RTSP 設定失敗，並顯示 RTSP 錯誤 461「UnsupportedTransport」(「不支援的傳輸」) (#11069)，請改用 TCP 重試。

1.0.0 版本

2023 年 3 月 22 日

發布了 androidx.media3:media3-*:1.0.0。1.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 Describe 回應訊息時擲回的 IllegalArgumentException (#10971)。
工作階段：
- 修正通知播放/暫停按鈕未隨著播放器狀態更新的錯誤 (#192)。
IMA 擴充功能：
- 修正導致沒有任何廣告的 DAI 串流無法啟動的問題，因為系統未收到第一個 (在沒有廣告的情況下，也是唯一) LOADED 事件。

1.0.0-rc01 版

2023 年 2 月 16 日

發布了 androidx.media3:media3-*:1.0.0-rc01。1.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)。
- 將媒體工作階段新增為 DefaultMediaNotificationProvider 的 getMediaButtons() 引數，並使用不可變動的清單以確保清晰度。(#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-beta03。1.0.0-beta03 版包含此連結所列的修訂項目。

此版本可對應至 ExoPlayer 2.18.2 版。

核心程式庫：
- 新增 ExoPlayer.isTunnelingEnabled 來檢查目前所選的音軌是否已啟用穿隧。(#2518)。
- 新增 WrappingMediaSource 來將換行簡化為 MediaSource。(#7279)。
- 在播放因可用記憶體不足而卡住時捨棄背景緩衝區。
- 啟用卸載時關閉追蹤「doSomeWork」區塊。
- 修正 PlaybackStatsListener 中快速跳轉的工作階段追蹤問題。(#180)。
- 在單一項目播放清單中呼叫 seekToNext 或 seekToPrevious 時，傳送缺少的 onMediaItemTransition 回呼 (#10667)。
- 新增傳回算繪影片的途徑尺寸的 Player.getSurfaceSize。
- 修正在播放器釋出期間移除事件監聽器會導致 IllegalStateException 的錯誤。(#10758)。
版本：
- 強制執行最低 compileSdkVersion，以避免編譯錯誤。(#10684)。
- 避免在其他 Gradle 版本中加入模塊時發布。
音軌選取：
- 如果螢幕不支援 Dolby Vision，則使用 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 聲道音訊對應到所有 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：
- 新增載入廣告資訊的逾時事件，以處理 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_CHANGED 向 Player.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)。
- 支援使用 CastPlayer 的 Player.getMetadata() 和 Listener.onMediaMetadataChanged() (#25)。

1.0.0-beta01 版

2022 年 6 月 16 日

發布了 androidx.media3:media3-*:1.0.0-beta01。1.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.setDrmSessionManagerProvider 和 MediaSource.Factory.setLoadErrorHandlingPolicy。如果有必要的話，可以明確傳遞 DefaultDrmSessionManagerProvider 和 DefaultLoadErrorHandlingPolicy 的執行個體。
- 新增 MediaItem.RequestMetadata，方便在 LocalConfiguration 還不明確時，代表播放媒體所需的中繼資料。另外也移除 MediaMetadata.mediaUrl，因為現在這個中繼資料已內含在 RequestMetadata。
- 新增 Player.Command.COMMAND_SET_MEDIA_ITEM，以便讓播放器設定單翼項目。
音軌選取：
- 將 TrackSelectionOverrides 類別壓平合併至 TrackSelectionParameters，並將 TrackSelectionOverride 升級至頂層類別。
- 將 TracksInfo 重新命名為 Tracks，並將 TracksInfo.TrackGroupInfo 重新命名為 Tracks.Group。Player.getCurrentTracksInfo 和 Player.Listener.onTracksInfoChanged 也已重新命名為 Player.getCurrentTracks 和 Player.Listener.onTracksChanged。這包括「取消淘汰」Player.Listener.onTracksChanged 方法名稱，不過參數類型不同。
- 將 DefaultTrackSelector.buildUponParameters 和 DefaultTrackSelector.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)。
- 重新編寫 TrackSelectionView 和 TrackSelectionDialogBuilder，以便正確搭配 Player 介面使用，而不是 ExoPlayer。這樣做可讓檢視畫面和其他 Player 實作內容一同使用，並可移除 UI 模組對於 ExoPlayer 模組的依附性。這是一項破壞性變更。
- 不在 PlayerView 音軌選取器內顯示強制文字音軌，當選擇「None」(無) 時，保留合適的強制文字音軌 (#9432)。
DASH：
- 從 DTS AudioChannelConfiguration 元素剖析頻道數量，這樣便能重新啟用 DTS 串流的音訊直通 (#10159)。
- 禁止將 null 傳遞至 DashMediaSource.Factory.setCompositeSequenceableLoaderFactory。如果有必要的話，可以明確傳遞 DefaultCompositeSequenceableLoaderFactory 的執行個體。
HLS：
- 如果播放清單的轉碼器屬性並未含有該音訊轉碼器，則使用備用的分區塊準備 (#10065)。
- 禁止將 null 傳遞至 HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory、HlsMediaSource.Factory.setPlaylistParserFactory 及 HlsMediaSource.Factory.setPlaylistTrackerFactory。如果有必要的話，可以明確傳遞 DefaultCompositeSequenceableLoaderFactory、DefaultHlsPlaylistParserFactory 的執行個體或 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.setMediaUri 和 MediaSession.Callback.onSetMediaUri。您可以用 MediaController.setMediaItem 和 MediaSession.Callback.onAddMediaItems 達到相同功能。
- 將舊版的 MediaController 播放媒體呼叫傳遞給 MediaSession.Callback.onAddMediaItems，而不是 onSetMediaUri。
- 新增 MediaNotification.Provider 和 DefaultMediaNotificationProvider，以便自訂通知內容。
- 新增 BitmapLoader 和 SimpleBitmapLoader，以便下載作品圖片。
- 新增 MediaSession.setCustomLayout()，以便為舊版工作階段提供回溯相容性。
- 新增 MediaSession.setSessionExtras()，以便提供和舊版工作階段同等的功能。
- 將 MediaSession.MediaSessionCallback 重新命名為 MediaSession.Callback，MediaLibrarySession.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.getCurrentTrackGroups 和 Player.getCurrentTrackSelections。請改用 Player.getCurrentTracks。您也可以繼續使用 ExoPlayer.getCurrentTrackGroups 和 ExoPlayer.getCurrentTrackSelections，不過這些方法會繼續視為已淘汰的方法。
- 移除 DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT 和 DEFAULT_TRACK_SELECTOR_PARAMETERS 等常數。請盡量改為使用 getDefaultTrackSelectorParameters(Context) 或 DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT。
- 移除建構函式 DefaultTrackSelector(ExoTrackSelection.Factory)。請改用 DefaultTrackSelector(Context, ExoTrackSelection.Factory)。
- 移除 Transformer.Builder.setContext。Context 應改為傳遞至 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.setTrackId 和 MediaItem.SubtitleConfiguration.Builder.setId 的互動方式，以便優先處理 SubtitleConfiguration 欄位；如果未設定，改回使用 Factory 值 (#10016)。
廣告播放：
- 修正即時 HLS SSAI 串流中，廣告時段之間的音訊欠載問題。

1.0.0-alpha02 版

2022 年 3 月 2 日

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

這與 ExoPlayer 2.17.0 版相對應。

核心程式庫：
- 新增受保護的方法 DefaultRenderersFactory.getCodecAdapterFactory()，讓覆寫 buildVideoRenderers() 或 buildAudioRenderers() 的 DefaultRenderersFactory 子類別可以存取轉碼器轉接器工廠，並將其傳遞至所建立的 MediaCodecRenderer 執行個體。
- 將 ICY 標頭欄位 name 和 genre 分別傳播至 MediaMetadata.station 和 MediaMetadata.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)。
- TrackGroupArray 中 TrackGroup 禁止重複。您隨時可以在 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)acquireSession 中 playbackLooper 移除。當自訂 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#setDrmSessionManager、MediaSourceFactory#setDrmHttpDataSourceFactory 和 MediaSourceFactory#setDrmUserAgent。改用 MediaSourceFactory#setDrmSessionManagerProvider。
- 移除 MediaSourceFactory#setStreamKeys。改用 MediaItem.Builder#setStreamKeys。
- 移除 MediaSourceFactory#createMediaSource(Uri)。改用 MediaSourceFactory#createMediaSource(MediaItem)。
- 將 setTag 從 DashMediaSource、HlsMediaSource 和 SsMediaSource 中移除。改用 MediaItem.Builder#setTag。
- 移除 DashMediaSource#setLivePresentationDelayMs(long, boolean)。使用 MediaItem.Builder#setLiveConfiguration 和 MediaItem.LiveConfiguration.Builder#setTargetOffsetMs 覆寫資訊清單，或使用 DashMediaSource#setFallbackTargetLiveOffsetMs 提供備用值。
- 移除 (Simple)ExoPlayer.setThrowsWhenUsingWrongThread。無法再選擇不採用執行緒強制執行功能。
- 移除 ActionFile 和 ActionFileUpgradeUtil。使用 ExoPlayer 2.16.1 以下版，以使用 ActionFileUpgradeUtil 將舊版操作檔案合併到 DefaultDownloadIndex。
- 移除 ProgressiveMediaSource#setExtractorsFactory。改用 ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory) 建構函式。
- 移除 ProgressiveMediaSource.Factory#setTag 和 ProgressiveMediaSource.Factory#setCustomCacheKey。改用 MediaItem.Builder#setTag 和 MediaItem.Builder#setCustomCacheKey。
- 移除 DefaultRenderersFactory(Context, @ExtensionRendererMode int) 和 DefaultRenderersFactory(Context, @ExtensionRendererMode int, long) 建構函式。改用 DefaultRenderersFactory(Context) 建構函式、DefaultRenderersFactory#setExtensionRendererMode 和 DefaultRenderersFactory#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-alpha01。1.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 模組取代)。如此一來，不需使用轉接器/連接器類別，就能直接整合播放器及媒體工作階段。