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 lancar 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 diperoleh dari status tindakan PlaybackState. Dengan perubahan ini, fungsi MediaDataManager#createActionsFromState membuat 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 dari 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:

  • Menyediakan informasi dan fungsi untuk media yang berasal dari perangkat jarak jauh ke pengalih output default pada kontrol media.
  • Ganti afordans 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 chip pengalih output default dengan informasi perangkat dan menambahkan kontrol media untuk pemutaran jarak jauh ke akhir daftar kontrol media lokal.

Penerapan 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 dalam keunggulan pengalih output mereka.

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

Penyesuaian pemutaran jarak jauh

Dalam kasus ketika OEM memiliki aplikasi sistem yang memposting notifikasi pemutaran media jarak jauh, aplikasi 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 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 mendapatkan rekomendasi.