Mulai Android 13, kontrol media di UI Sistem berisi update 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 di seluruh perangkat.
Pembaruan pada kontrol media
Bagian ini menjelaskan update yang dilakukan pada kontrol media di Android 13 untuk tombol tindakan dan pemutaran jarak jauh.
Perubahan tombol tindakan
Untuk memastikan pengguna dapat mengakses kumpulan kontrol media yang beragam untuk aplikasi yang memutar
media, tombol tindakan pada kontrol media untuk Android 13
berasal dari status tindakan
PlaybackState
.
Dengan perubahan ini, fungsi MediaDataManager#createActionsFromState
akan menghasilkan informasi tombol tindakan berdasarkan status tindakan PlaybackState
.
Hal ini selaras dengan cara kontrol media dirender di platform Android lain seperti
Auto, Asisten, 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 update tombol tindakan, lihat
StatusBarManager
.
API pemutaran jarak jauh
Untuk memberikan pengalaman media yang kohesif di berbagai platform, mulai
Android 13, API sistem baru Notification#setRemotePlaybackInfo
ditambahkan untuk menandai notifikasi media di UI Sistem kontrol media untuk pemutaran
jarak jauh. API ini memungkinkan aplikasi sistem yang memposting notifikasi melakukan
hal berikut:
- Berikan informasi dan fungsi untuk media yang berasal dari perangkat jarak jauh ke pengalih output default di kontrol media.
- Ganti kemampuan pengalih output jika perlu.
Aplikasi sistem yang menggunakan notifikasi ini harus memiliki izin
MEDIA_CONTENT_CONTROL
.
Notification#setRemotePlaybackInfo
API juga menambahkan
extras
berikut untuk menentukan nama, ikon, dan intent 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 mengganti informasi perangkat chip pengalih output default dan menambahkan kontrol media untuk pemutaran jarak jauh ke akhir daftar kontrol media lokal.
Implementasi kontrol media
OEM harus mengetahui perubahan ini pada perilaku default, karena hal ini memengaruhi cara kontrol media untuk aplikasi dibuat. OEM juga harus memastikan bahwa API sistem baru berfungsi sebagaimana mestinya dalam kemampuan pengalih output mereka.
OEM tidak diwajibkan untuk melakukan perubahan apa pun dan dapat menggunakan penerapan default di AOSP.
Penyesuaian pemutaran jarak jauh
Jika OEM memiliki aplikasi sistem yang memposting notifikasi pemutaran media jarak jauh, aplikasi dapat secara opsional memanggil setRemotePlaybackInfo
untuk
notifikasi selama aplikasi telah diberi izin
MEDIA_CONTENT_CONTROL
. Namun, ini bukan persyaratan dan partner dapat memilih untuk tidak
menyesuaikan.
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 aplikasi.
- Pengalih output menampilkan informasi perangkat yang benar.
Gunakan pengujian berikut untuk memvalidasi API pemutaran jarak jauh:
- Pengujian CTS di
NotificationManagerTest
, sepertitestMediaStyleRemotePlayback_noPermission
dantestMediaStyleRemotePlayback_hasPermission
. - Pengujian unit di bagian
com.android.systemui.media
.
Lihat persyaratan CDD baru [3.8.3.1/H-1-SR] untuk mengetahui rekomendasi.