Media3
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 4 月 12 日 | 1.3.1 | - | - | 1.4.0-alpha01 |
宣告依附元件
如果要為 Media3 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Groovy
dependencies { def media3_version = "1.3.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" }
Kotlin
dependencies { val media3_version = "1.3.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") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋:
您的意見可協助我們改善 Jetpack。您可以使用 Media3 Issue Tracker 尋找問題的答案、已知問題和功能要求,以及提出新問題。
1.4.0 版
1.4.0-alpha01 版
2024 年 4 月 17 日
發布了 androidx.media3:media3-*:1.4.0-alpha01
。1.4.0-alpha01 版包含這些修訂版本。
- 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
。 - 在
BasePreloadManager
中新增remove(MediaSource)
。
- 新增
- 轉換程式:
- 將
audioConversionProcess
和videoConversionProcess
新增至ExportResult
,指出輸出檔案中個別音軌的產生方式。 - 放寬 H.264 等級最佳化檢查。
- 新增對序列中切換 SDR 與 HDR 輸入媒體的支援。
- 新增樂曲層級音效支援功能。
- 新增將 Ultra HDR 圖片轉碼為 HDR 影片的支援。
- 修正
DefaultAudioMixer
在重設並重複使用後未輸出正確位元組數的問題。
- 將
- 影片:
- 修正
Listener.onRenderedFirstFrame()
在播放中途切換途徑時太早抵達的問題。
- 修正
- 資料來源:
- 實作
android.resource://package/id
原始資源 URI 的支援功能,其中package
與目前應用程式的套件不同。先前我們曾記錄過這個做法,但比起以名稱,存取其他套件中的資源,是更有效率的方式。 - 立即檢查
DataSpec
建構函式中的url
並非空值。此參數已加註為非空值。
- 實作
- 效果:
- 支援在
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
來翻轉。
- 支援在
- 工作階段:
- 將
CommandButton.enabled
的預設值變更為true
,並確保控制器的值可以保持 false (即使有相關的指令可用)。 - 為應使用 (而非自訂圖示資源) 的
CommandButton
新增圖示常數。 - 新增
MediaSessionService.isPlaybackOngoing()
,讓應用程式查詢是否需要在onTaskRemoved()
中停止服務。(#1219)。 - 新增
MediaSessionService.pauseAllPlayersAndStopSelf()
,方便暫停播放所有工作階段,並呼叫stopSelf
以終止MediaSessionService
的生命週期。 - 覆寫
MediaSessionService.onTaskRemoved(Intent)
以提供安全的預設實作方式,讓服務在播放進行中或以其他方式停止時,在前景保持執行。
- 將
- 下載內容:
- 確保
DownloadHelper
不會外洩未發布的Renderer
執行個體,這類執行個體最終可能導致應用程式因IllegalStateException: Too many receivers, total of 1000, registered for pid
而異常終止 (#1224)。
- 確保
- 測試公用程式:
- 在
FakeRenderer
中實作onInit()
和onRelease()
。 - 變更
TestPlayerRunHelper.runUntil/playUntil
方法,使其在發生非嚴重錯誤時失敗 (例如回報給AnalyticsListener.onVideoCodecError
的方法)。請使用新的TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX()
方法鏈停用此行為。
- 在
- 試用版應用程式..
- 在短版試用版應用程式中使用
DefaultPreloadManager
。
- 在短版試用版應用程式中使用
- 移除已淘汰的符號:
- 移除
CronetDataSourceFactory
。改用CronetDataSource.Factory
。 - 移除部分
DataSpec
建構函式。改用DataSpec.Builder
。
- 移除
1.3.0 版
1.3.1 版
2024 年 4 月 11 日
發布了 androidx.media3:media3-*:1.3.1
。1.3.1 版包含這些修訂版本。
- 常見程式庫:
- 新增
Format.labels
以允許本地化標籤或其他替代標籤。
- 新增
- ExoPlayer:
- 轉換程式:
- 新增因
MediaMuxer
不支援 API 30 之前的負值呈現時間戳記而擲回的例外狀況。
- 新增因
- 選取曲目:
DefaultTrackSelector
:偏好使用「合理」畫面更新率 (>=10fps) 的視訊軌,而非畫面更新率較低的影片。這樣可確保玩家在擷取自動態相片的 MP4 中,選取「真」視訊軌。這類音軌包含兩個 HEVC 音軌,兩個音軌的解析度較高,但影格數極少 (#1051)。
- 擷取工具:
- 音訊:
- 如果音軌無法在卸載模式下初始化,請停用卸載,允許轉譯器復原。
- 影片:
- 文字:
- WebVTT:防止直接連續提示從
WebvttParser.parse
建立其他CuesWithTiming
執行個體。(#1177)。
- WebVTT:防止直接連續提示從
- DRM:
- 處理可透過
MediaDrm
架構 (而非ResourceBusyException
或NotProvisionedException
) 在某些 Android 14 裝置上擲回的NoSuchMethodError
(#1145)。
- 處理可透過
- 效果:
- 透過轉換色域,改善 PQ 至 SDR 色調對應功能。
- 工作階段:
- 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)。
- 新增
- 轉換程式:
- 選取曲目:
- 新增
DefaultTrackSelector.selectImageTrack
即可啟用圖片音軌選取功能。 - 新增
TrackSelectionParameters.isPrioritizeImageOverVideoEnabled
,以判斷是否要同時選取圖片軌和視訊軌。預設值為false
,表示系統會優先選取影片音軌。
- 新增
- 擷取工具:
- 在 MP4 擷取器中新增額外的 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)。
- 在 MP4 擷取器中新增額外的 AV1C 剖析,以擷取
- 音訊:
- 影片:
- 變更接受
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
。
- 新增對 DASH 縮圖的支援。格線圖片會經過裁剪,並提供個別縮圖給接近呈現時間的
- DRM:
- 根據預設,即使之後加密樣本的金鑰尚未準備就緒,也能立即播放 DRM 內容中「清除待開發客戶」未加密的樣本。當播放位置到達加密樣本時,如果金鑰仍未準備就緒,可能會導致播放中停滯 (但先前播放作業在此時尚未開始播放)。您可以使用
MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey
或DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys
停用這個行為。
- 根據預設,即使之後加密樣本的金鑰尚未準備就緒,也能立即播放 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:
- 轉換程式:
- 解決編碼器因設定高作業率而在設定時擲回的問題。
- 擷取工具:
- 音訊:
- 修正多次呼叫
SilenceSkippingAudioProcessor
時對 EOS 的處理方式 (#712)。
- 修正多次呼叫
- 影片:
- 針對 Galaxy Tab S7 FE、Chromecast (支援 Google TV) 和 Lenovo M10 FHD Plus 中的裝置問題新增解決方法,導致系統將 60fps AVC 串流標示為不支援的 (#693)。
- 中繼資料:
- 修正僅透過使用大寫鍵的 Vorbis 註解填入
MediaMetadata
的錯誤。(#876)。 - 在剖析非常大型的 ID3 影格時擷取
OutOfMemoryError
,表示播放可以在沒有標記資訊的情況下繼續,而不會完全播放失敗。
- 修正僅透過使用大寫鍵的 Vorbis 註解填入
- DRM:
- 將假的 ClearKey
https://default.url
授權網址解決方法延伸至 API 33 以上版本 (先前這個解決方法僅適用於 API 33) (#837)。 - 修正以下問題:從加密模式切換至未附加途徑的清除內容時,發生
ERROR_DRM_SESSION_NOT_OPENED
的問題。這個錯誤是因不正確使用安全解碼器播放明確內容所致。
- 將假的 ClearKey
- 工作階段:
- UI:
- DASH 擴充功能:
- 在 DASH 資訊清單中,將「f800」剖析為 Dolby 的通道數量 (#688)。
- 解碼器擴充功能 (FFmpeg、VP9、AV1、MIDI 等):
- 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 相容性問題:系統不會將可為空值的一般類型參數和可為空值的陣列元素類型偵測為可為空值。例如
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
包含playbackSpeed
和lastRebufferRealtimeMs
在現有的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.queueInputBitmap
的frameRate
和durationUs
參數變更為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
提供格式。該函式會傳回包含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)。
- 針對純音訊卸載播放預設啟用卸載排程功能。
- 刪除
ExoPlayer.experimentalSetOffloadSchedulingEnabled
和AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged
。 - 已將
onExperimentalSleepingForOffloadChanged
重新命名為onSleepingForOffloadChanged
,並將onExperimentalOffloadedPlayback
重新命名為onOffloadedPlayback
。 - 將音訊卸載模式相關的
TrackSelectionParameters
介面和定義移至內部AudioOffloadPreferences
類別。 - 將
onAudioTrackInitialized
和onAudioTrackReleased
回呼新增至AnalyticsListener
、AudioRendererEventListener
和AudioSink.Listener
。 - 修正 DTS Express 音訊緩衝區反向溢位問題 (#650)。
- 修正 E-AC3-JOC 的功能檢查擲回
IllegalArgumentException
的錯誤。(#677)。
- 新增 MP4 和 Matroska 中 24/32 位元大端 PCM 的支援,並在 MP4 中剖析
- 影片:
- 允許
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,即可設定可用指令和自訂版面配置,用來填入通知和平台工作階段。
- 轉換
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 分鐘) 內連線到合適的裝置,事件監聽器就會自動繼續播放。
- 為 Wear OS 裝置新增
- 下載內容:
- 為
DownloadService
宣告「資料同步處理」前景服務類型,以便與 Android 14 相容。使用這項服務時,應用程式也必須在資訊清單中將dataSync
新增為foregroundServiceType
,並新增FOREGROUND_SERVICE_DATA_SYNC
權限 (#11239)。
- 為
- HLS 擴充功能:
- 使用從上次載入開始時間 (而非上次載入完成時間) 計算的間隔重新整理 HLS 即時播放清單 (#663)。
- DASH 擴充功能:
- 區隔範本網址允許使用多個相同的 DASH ID。
- 新增在擷取期間剖析字幕的實驗性支援。這樣做對於合併重疊的字幕有更好的支援,包括解決在字幕片段之間切換時閃爍的問題。如要啟用這項功能,請使用
DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction()
。(#288)。
- RTSP 擴充功能:
- 解碼器擴充功能 (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)。
- 修正停用介面可能導致 Leanback 程式碼發生
- 測試公用程式:
- 請確保
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
。 - 在「通用媒體用戶端資料」(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_VOLUME
和COMMAND_SET_DEVICE_VOLUME
) 和新指令 (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
和COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
) (#554) 確定volumeControlType
的方式,從而建立VolumeProviderCompat
。
- 在控制器狀態中加入自訂版面配置,並提供 getter 來存取。自訂版面配置變更時,系統會呼叫
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)。下列欄位已納入
br
、bl
、cid
、rtp
和sid
(#8699)。API 結構和 API 方法:- CMCD 記錄預設為停用,請使用
MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory)
啟用。 - 根據預設,所有金鑰都會啟用,請覆寫
CmcdConfiguration.RequestConfig.isKeyAllowed(String key)
以篩除記錄的金鑰。 - 覆寫
CmcdConfiguration.RequestConfig.getCustomData()
即可啟用自訂金鑰記錄。
- CMCD 記錄預設為停用,請使用
- 在主要示範的資訊清單中新增額外動作,以便使用自訂
*.exolist.json
檔案啟動試用版應用程式 (#439)。 - 新增
ExoPlayer.setVideoEffects()
,以便在影片播放期間使用Effect
。 - 更新
SampleQueue
,將sourceId
儲存為long
而非int
。這會變更公開方法SampleQueue.sourceId
和SampleQueue.peekSourceId
的簽名。 - 為
LoadControl
方法shouldStartPlayback
和onTracksSelected
新增參數,將這些方法與相關的MediaPeriod
建立關聯。 - 新增時間軸參數,其中包含對應至地圖上用 UID 的句點,進而變更
ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>)
的簽名。這是為了避免多週期直播的並行問題。 - 淘汰
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)
之間的不一致行為。
- 只有在明確選擇啟用時,ExoPlayer 才能控制裝置音量方法。使用
- 轉換程式:
- 移除
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
會觸發新的音軌選取動作。
- 新增預設為停用的
- 擷取工具:
- 音訊:
- 修正在已啟用通道且
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:
- 新增公用程式方法
shouldShowPlayButton
和handlePlayPauseButtonAction
,透過播放/暫停按鈕編寫自訂 UI 元素。
- 新增公用程式方法
- RTSP 擴充功能:
- DASH 擴充功能:
- 從
MediaLoadData.startTimeMs
和MediaLoadData.endTimeMs
中移除多時段 DASH 串流的媒體時間偏移。 - 修正重新準備多週期即時 Dash 媒體來源產生
IndexOutOfBoundsException
的錯誤 (#10838)。
- 從
- HLS 擴充功能:
- 新增
HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long)
來設定逾時,讓載入執行緒等待TimestampAdjuster
初始化。如果初始化未在逾時前完成,系統會擲回PlaybackException
,以免播放無止盡的延遲。逾時預設為零 (#323)。
- 新增
- 測試公用程式:
- 檢查
DataSourceContractTest
中的 URI 配置不區分大小寫。
- 檢查
- 移除已淘汰的符號:
- 移除
DefaultAudioSink
建構函式,改用DefaultAudioSink.Builder
。 - 移除
HlsMasterPlaylist
,請改用HlsMultivariantPlaylist
。 - 移除
Player.stop(boolean)
。如果reset
是true
,請改用Player.stop()
和Player.clearMediaItems()
。 - 移除兩個已淘汰的
SimpleCache
建構函式,請改用會接受DatabaseProvider
的非淘汰建構函式,以提升效能。 - 移除
DefaultBandwidthMeter
建構函式,請改用DefaultBandwidthMeter.Builder
。 - 移除
DefaultDrmSessionManager
建構函式,請改用DefaultDrmSessionManager.Builder
。 - 移除兩個已淘汰的
HttpDataSource.InvalidResponseCodeException
建構函式,請使用可接受額外欄位(cause
、responseBody
) 的非已淘汰建構函式來強化錯誤記錄。 - 移除
DownloadHelper.forProgressive
、DownloadHelper.forHls
、DownloadHelper.forDash
和DownloadHelper.forSmoothStreaming
,請改用DownloadHelper.forMediaItem
。 - 移除已淘汰的
DownloadService
建構函式,改用未淘汰的建構函式,當中包含提供channelDescriptionResourceId
參數的選項。 - 移除 Charsets 已淘汰的字串常數 (
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
。 - 修正以下問題:在未讀取「串流結束」樣本的情況下,將最後一個影格的樣本從佇列移除時,系統可能無法轉譯最後一個影格。(#11079)。
- 新增
- 擷取工具:
- 修正透過重複使用 RTSP 和 MP4 擷取器使用的剖析邏輯,在 MPEG-TS 檔案中剖析 H.265 SPS 的問題 (#303)。
- 文字:
- SSA:如果 UTF-16 檔案開頭為位元組順序標記,則新增對這類檔案的支援 (#319)。
- 工作階段:
- 修正當
MediaController
連線至會更新動作的舊版MediaSessionCompat
時,不會更新可用指令的問題。 - 修正導致
MediaLibraryService
無法在 API 30 上使用params.isRecent == true
的Callback.onGetLibraryRoot
呼叫傳回空值的錯誤 (#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
透過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.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 版。
- 核心程式庫:
- 下載內容:
- 請將兩個片段的開始時間差異於
SegmentDownloader
和子類別中的設定合併。(#248)。
- 請將兩個片段的開始時間差異於
- 音訊:
- 影片:
- 將 HEVC HDR10 格式對應至
HEVCProfileMain10HDR10
(而非HEVCProfileMain10
)。 - 新增 Chromecast (支援 Google TV) 和 Lenovo M10 FHD Plus 的裝置問題,導致系統無法將 60fps AVC 串流標示為不支援的 (#10898)。
- 修正播放影格速率高於螢幕刷新率的媒體時,影格版本效能問題。
- 將 HEVC HDR10 格式對應至
- 投放:
- 修正在媒體項目之間轉換時暫時性
STATE_IDLE
。(#245)。
- 修正在媒體項目之間轉換時暫時性
- RTSP:
- 找出剖析無效 RTSP 描述回應訊息時擲回的 IllegalArgumentException 錯誤。(#10971)。
- 工作階段:
- 修正通知播放/暫停按鈕不會隨著玩家狀態更新的錯誤 (#192)。
- IMA 擴充功能:
- 修正導致無法啟動任何廣告的 DAI 串流作業,因為系統並未收到第一個 (且在缺少廣告的情況下)
LOADED
事件。
- 修正導致無法啟動任何廣告的 DAI 串流作業,因為系統並未收到第一個 (且在缺少廣告的情況下)
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)。
- 剖析 trak atom 時,如果範例資料表 (stbl) 缺少必要的範例說明 (stsd),則請擲回
- 音訊:
- 使用壓縮的音訊格式位元率來計算直接播放 (直通) 中
AudioTrack
的緩衝區大小下限。
- 使用壓縮的音訊格式位元率來計算直接播放 (直通) 中
- 文字:
- 修正在字幕檔案不含提示的情況下,
TextRenderer
將無效 (負數) 索引傳遞至Subtitle.getEventTime
的問題。 - SubRip:針對開頭為位元組順序標記的 UTF-16 檔案新增支援。
- 修正在字幕檔案不含提示的情況下,
- 中繼資料:
- 依據 ID3 v2.4 的許可,從 ID3 影格剖析多個以空值分隔的值。
- 新增
MediaMetadata.mediaType
,來表示內容類型或中繼資料說明的資料夾類型。 - 新增
MediaMetadata.isBrowsable
以取代MediaMetadata.folderType
。資料夾類型會在下一個版本中被淘汰。
- DASH:
- 為圖片調整集新增完整剖析功能,包括圖塊數量。(#3752)。
- UI:
- 工作階段:
- 新增抽象
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 的其他音軌。(#8944)。
- 下載內容:
- 影片:
- 如果螢幕不支援 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:
- 我是:
- 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)。
- 確認透過
- 擷取工具:
- DASH:
- 從資訊清單中清除 ClearKey 授權網址 (#10246)。
- UI:
- 確保 TalkBack 會在播放控制項選單中公告目前使用中的速度選項 (#10298)。
- RTSP:
- 新增 VP8 片段化封包處理 (#110)。
- Leanback 擴充功能:
- 監聽
LeanbackAdapter
中的playWhenReady
變更 (10420)。
- 監聽
- 投放:
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 內部字幕格式使用。
- 將
- 擷取工具:
- 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
的執行個體。
- 從 DTS
- 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)。
- 將 CMake 版本更新至
- 移除已淘汰的符號:
- 移除
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 解碼器。
- 音訊:
- 擷取工具:
- 文字:
- DRM:
- 從
DrmSessionManager.(pre)acquireSession
中playbackLooper
移除。當自訂MediaSource
中的應用程式使用DrmSessionManager
時,必須改將playbackLooper
傳遞至DrmSessionManager.setPlayer
。
- 從
- 廣告播放 / IMA:
- 新增 IMA 動態廣告插播 (DAI) 支援 (#8213)。
- 將方法新增至
AdPlaybackState
以允許重設廣告群組,以便系統再次播放廣告群組 (#9615)。 - 在廣告播放期間強制執行 1.0 的播放速度 (#9018)。
- 修正廣告群組載入失敗,並導致播放立即重設的問題 (#9929)。
- UI:
- DASH:
- HLS:
- RTSP:
- 轉換程式:
- 將最低 API 版提升至 21。
TransformationException
現已用於描述轉換期間發生的錯誤。- 新增
TransformationRequest
來指定轉換選項。 - 允許註冊多個事件監聽器。
- 修正轉換程式在部分轉碼器輸出讀取後卡住的問題。
- 修正釋出多工器時,
Transformer.getProgress
中可能擲回的 NPE。 - 新增用於套用轉換的試用版應用程式。
- MediaSession 擴充功能:
- 根據預設,
MediaSessionConnector
現在會在停止時清除播放清單。 如果希望應用程式保留播放清單,可在連接器上呼叫setClearMediaItemsOnStop(false)
。
- 根據預設,
- Cast 擴充功能:
- 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)。
- 升級 Cast 擴充功能,使其仰賴
- 移除已淘汰的符號:
- 移除
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
模組取代)。如此一來,不需使用轉接器/連接器類別,就能直接整合播放器及媒體工作階段。