Mulai Android 13, kontrol media di UI Sistem berisi pembaruan pada tombol tindakan dan pemutaran jarak jauh. Perubahan ini mendukung pengalaman kontrol media yang lebih baik di ponsel dan tablet, serta menawarkan transfer media yang lancar antar perangkat.
Pembaruan pada kontrol media
Bagian ini menjelaskan pembaruan yang dilakukan pada kontrol media di Android 13 untuk tombol tindakan dan pemutaran jarak jauh.
Tombol tindakan berubah
Untuk memastikan bahwa pengguna dapat mengakses beragam kontrol media untuk aplikasi yang memutar media, tombol tindakan pada kontrol media untuk Android 13 berasal dari status tindakan PlaybackState
. Dengan perubahan ini, fungsi MediaDataManager#createActionsFromState
menghasilkan informasi tombol tindakan berdasarkan status tindakan PlaybackState
. Hal ini selaras dengan cara kontrol media dirender di platform Android lainnya seperti Auto, Assistant, dan Wear.
Sebaliknya, di Android 12, tombol tindakan pada kontrol media ditentukan oleh tindakan notifikasi yang ditambahkan ke notifikasi MediaStyle
.
Untuk ringkasan perubahan yang kompatibel dengan aplikasi untuk pembaruan tombol tindakan, lihat StatusBarManager
.
API pemutaran jarak jauh
Untuk menghadirkan pengalaman media yang kohesif di berbagai platform, dimulai dengan Android 13, API sistem baru Notification#setRemotePlaybackInfo
ditambahkan untuk menandai notifikasi media pada UI Sistem kontrol media untuk pemutaran jarak jauh. API ini memungkinkan aplikasi sistem yang memposting notifikasi melakukan hal berikut:
- Menyediakan informasi dan fungsionalitas untuk media yang berasal dari perangkat jarak jauh ke pengalih keluaran default pada kontrol media.
- Ganti keterjangkauan pengalih keluaran jika perlu.
Aplikasi sistem yang menggunakan notifikasi ini harus memiliki izin MEDIA_CONTENT_CONTROL
.
API Notification#setRemotePlaybackInfo
juga menambahkan extras
berikut untuk menentukan nama, ikon, dan maksud perangkat pemutaran jarak jauh:
-
Notification#EXTRA_MEDIA_REMOTE_DEVICE
-
Notification#EXTRA_MEDIA_REMOTE_ICON
-
Notification#EXTRA_MEDIA_REMOTE_INTENT
Dengan informasi ini, UI Sistem dapat menggantikan informasi perangkat chip pengalih keluaran default dan menambahkan kontrol media untuk pemutaran jarak jauh ke akhir daftar kontrol media lokal.
Penerapan pengendalian media
OEM harus menyadari perubahan pada perilaku default ini, karena ini memengaruhi cara kontrol media untuk aplikasi dibuat. OEM juga harus memastikan bahwa API sistem baru berfungsi sesuai dengan kemampuan pengalih keluaran mereka.
OEM tidak diharuskan melakukan perubahan apa pun dan dapat menggunakan implementasi default di AOSP.
Kustomisasi pemutaran jarak jauh
Jika OEM memiliki aplikasi sistem yang mengeposkan pemberitahuan pemutaran media jarak jauh, aplikasi tersebut secara opsional dapat memanggil setRemotePlaybackInfo
untuk pemberitahuan selama aplikasi tersebut telah diberikan izin MEDIA_CONTENT_CONTROL
. Namun, ini bukan keharusan dan mitra dapat memilih untuk tidak melakukan penyesuaian.
Validasi kontrol media
Untuk menguji kontrol media di UI Sistem, jalankan pengujian manual untuk memvalidasi hal berikut:
- Tombol berfungsi sebagaimana mestinya saat memutar media dari suatu aplikasi.
- Pengalih keluaran menampilkan informasi perangkat yang benar.
Gunakan pengujian berikut untuk memvalidasi API pemutaran jarak jauh:
- Tes CTS di
NotificationManagerTest
, sepertitestMediaStyleRemotePlayback_noPermission
dantestMediaStyleRemotePlayback_hasPermission
. - Tes unit di bawah
com.android.systemui.media
.
Lihat persyaratan CDD baru [3.8.3.1/H-1-SR] untuk mendapatkan rekomendasi.