Kontrol media di UI Sistem

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:

Lihat persyaratan CDD baru [3.8.3.1/H-1-SR] untuk mengetahui rekomendasi.