Mulai Android 13, kontrol media di UI Sistem berisi pembaruan untuk tombol tindakan dan pemutaran jarak jauh. Perubahan ini mendukung pengalaman kontrol media yang lebih halus di ponsel dan tablet, serta menawarkan transfer media yang lancar di seluruh perangkat.
Pembaruan untuk 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 bahwa pengguna dapat mengakses sekumpulan 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 . Ini selaras dengan cara kontrol media dirender di platform Android lainnya seperti Otomatis, 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 pembaruan tombol tindakan, lihat StatusBarManager .
API pemutaran jarak jauh
Untuk memberikan pengalaman media yang kohesif di berbagai platform, mulai Android 13, API Notification#setRemotePlaybackInfo sistem baru 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:
- Berikan informasi dan fungsionalitas untuk media yang berasal dari perangkat jarak jauh ke pengalih output default pada kontrol media.
- Ganti kemampuan pengalih keluaran 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 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 mengganti informasi perangkat chip pengalih keluaran default dan menambahkan kontrol media untuk pemutaran jarak jauh ke akhir daftar kontrol media lokal.
Implementasi kontrol media
OEM harus mengetahui perubahan perilaku default ini, karena ini memengaruhi cara kontrol media untuk aplikasi dibuat. OEM juga harus memastikan bahwa API sistem baru berfungsi sebagaimana berlaku dalam kemampuan pengalih output 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 notifikasi pemutaran media jarak jauh, aplikasi dapat secara opsional memanggil setRemotePlaybackInfo untuk notifikasi selama telah diberikan izin MEDIA_CONTENT_CONTROL . Namun, ini bukan persyaratan dan partner dapat memilih untuk tidak menyesuaikan.
Validasi kontrol media
Untuk menguji kontrol media di System UI, jalankan pengujian manual untuk memvalidasi berikut ini:
- Tombol berfungsi sebagaimana mestinya saat memutar media dari aplikasi.
- Pengalih keluaran menampilkan informasi perangkat yang benar.
Gunakan pengujian berikut untuk memvalidasi API pemutaran jarak jauh:
- Pengujian CTS di
NotificationManagerTest, sepertitestMediaStyleRemotePlayback_noPermissiondantestMediaStyleRemotePlayback_hasPermission. - Tes unit di bawah
com.android.systemui.media.
Lihat persyaratan CDD baru [3.8.3.1/H-1-SR] untuk rekomendasi.