系統 UI 中的媒體控制項

從 Android 13 開始，系統 UI 中的媒體控制項包含動作按鈕和遠端播放功能的更新。這些變更可支援在手機和平板電腦上提供更精緻的媒體控制體驗，並提供跨裝置的流暢媒體傳輸功能。

媒體控制選項更新

本節說明 Android 13 媒體控制項針對動作按鈕和遠端播放功能所做的更新。

動作按鈕變更

為確保使用者可以存取播放媒體的應用程式提供的豐富媒體控制選項，Android 13 媒體控制項的動作按鈕會衍生自 PlaybackState 動作狀態。在這個變更後，MediaDataManager#createActionsFromState 函式會根據 PlaybackState 動作狀態產生動作按鈕資訊。這與其他 Android 平台 (例如 Auto、Assistant 和 Wear) 中媒體控制項的顯示方式一致。

相較之下，在 Android 12 中，媒體控制項上的動作按鈕是由新增至 MediaStyle 通知的通知動作決定。

如要瞭解行動按鈕更新的應用程式相容性變更摘要，請參閱 StatusBarManager。

Remote Playback API

為在各種介面上提供一致的媒體體驗，從 Android 13 開始，我們新增了系統 API Notification#setRemotePlaybackInfo，可在媒體控制系統 UI 上標示媒體通知，以便遠端播放。這個 API 可讓發布通知的系統應用程式執行以下操作：

  • 將遠端裝置來源媒體的資訊和功能提供給媒體控制項的預設輸出切換器。
  • 視需要取代輸出切換器操作元素。

使用這項通知的系統應用程式必須具備 MEDIA_CONTENT_CONTROL 權限。

Notification#setRemotePlaybackInfo API 也新增了以下 extras，用於判斷遠端播放裝置的名稱、圖示和意圖：

  • Notification#EXTRA_MEDIA_REMOTE_DEVICE
  • Notification#EXTRA_MEDIA_REMOTE_ICON
  • Notification#EXTRA_MEDIA_REMOTE_INTENT

有了這項資訊，系統 UI 就能取代預設的輸出切換器晶片裝置資訊，並將用於遠端播放的媒體控制項新增至本機媒體控制項清單的結尾。

實作媒體控制

原始設備製造商 (OEM) 必須瞭解這項預設行為的變更，因為這會影響應用程式媒體控制項的產生方式。原始設備製造商 (OEM) 也必須確保新系統 API 可在輸出切換器可用性中正常運作。

OEM 不必進行任何變更，而且可以使用 AOSP 中的預設實作項目。

自訂遠端播放功能

如果原始設備製造商 (OEM) 有發布遠端媒體播放通知的系統應用程式，只要應用程式已取得 MEDIA_CONTENT_CONTROL 權限，即可選擇呼叫 setRemotePlaybackInfo 以傳送通知。不過，這並非必要條件，合作夥伴可以選擇不進行自訂。

驗證媒體控制選項

如要測試系統 UI 中的媒體控制項，請執行手動測試，驗證下列項目：

  • 在應用程式播放媒體時，按鈕會正常運作。
  • 輸出切換器會顯示正確的裝置資訊。

請使用下列測試驗證遠端播放 API：

如需最佳化建議，請參閱新的 CDD 規定 [3.8.3.1/H-1-SR]。