Kontrol media di UI Sistem

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 di seluruh perangkat.

Pembaruan pada kontrol media

Bagian ini menjelaskan pembaruan yang dilakukan pada kontrol media di Android 13 untuk tombol tindakan dan pemutaran jarak jauh.

Perubahan tombol tindakan

Untuk memastikan pengguna dapat mengakses serangkaian kontrol media yang lengkap untuk aplikasi yang memutar media, tombol tindakan pada kontrol media untuk Android 13 berasal dari PlaybackState status tindakan. Dengan perubahan ini, fungsi MediaDataManager#createActionsFromState akan membuat 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 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:

  • Memberikan informasi dan fungsi untuk media yang berasal dari perangkat jarak jauh ke pengalih output default pada kontrol media.
  • Mengganti affordance pengalih output jika diperlukan.

Aplikasi sistem yang menggunakan notifikasi ini harus memiliki izin MEDIA_CONTENT_CONTROL.

API Notification#setRemotePlaybackInfo 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 pada perilaku default ini, karena memengaruhi cara kontrol media untuk aplikasi dibuat. OEM juga harus memastikan bahwa API sistem baru berfungsi sebagaimana mestinya di affordance pengalih output.

OEM tidak diwajibkan untuk melakukan perubahan apa pun dan dapat menggunakan implementasi default di AOSP.

Penyesuaian pemutaran jarak jauh

Jika OEM memiliki aplikasi sistem yang memposting notifikasi pemutaran media jarak jauh, aplikasi tersebut dapat secara opsional memanggil setRemotePlaybackInfo untuk notifikasi selama aplikasi tersebut telah diberi izin MEDIA_CONTENT_CONTROL. Namun, hal ini bukan persyaratan dan partner 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 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 rekomendasi.