Radio UI diimplementasikan sebagai aplikasi independen. Petunjuk tentang cara mengintegrasikan UI Radio ke perangkat keras radio dapat ditemukan di Radio Implementing .
Bagian berikut menjelaskan cara mengintegrasikan Radio UI dengan Media untuk memberikan pengalaman mulus kepada pengguna yang memungkinkan pengguna berinteraksi dengan sumber media dan radio seolah-olah mereka adalah satu aplikasi.
Aliran pengguna beralih sumber media
Diagram berikut menggambarkan bagaimana implementasi referensi Radio dan Media mengimplementasikan alur pengguna switching aplikasi.
Gambar 1. Aliran pengguna pengalihan sumber media
Untuk memberikan transisi yang mulus antara Radio dan aplikasi lain di Media, pustaka car-media-common
mendefinisikan maksud Android yang dapat digunakan untuk meluncurkan pemilih sumber media. Di AOSP, pemilih ini diimplementasikan di Peluncur Aplikasi, menghadirkan UI yang sama untuk meluncurkan aplikasi tetapi difilter untuk hanya menampilkan sumber media.
OEM dapat memilih untuk mengambil implementasi Peluncur Aplikasi saat ini apa adanya, atau menerapkan pemilih sumber media yang disesuaikan.
Pemilih dapat bertindak dalam dua mode:
- Aliran biasa. Setelah menggunakan pemilih, sumber yang dipilih akan ditampilkan di Media sehingga pengguna dapat menelusuri kontennya.
- Sebagai saklar. Sebuah pemilih digunakan untuk mengganti sumber, tetapi media tidak ditampilkan kepada pengguna. Ini berlaku untuk ikon Pemilih di Halaman Beranda. Setelah memilih sumber, layar sebelumnya yang terbaru ditampilkan kepada pengguna (dalam hal ini, halaman Beranda).
Maksud yang digunakan untuk beralih di antara sumber media dapat diperoleh dari metode MediaSource#getSourceSelectorIntent()
, yang menerima Boolean popup
yang mengembalikan maksud untuk meluncurkan setiap alur yang dijelaskan di atas.
Maksud sebenarnya ditentukan di packages/apps/Car/libs/car-media-common/res/values/config.xml
. Untuk menyesuaikan konfigurasi ini, gunakan overlay waktu build.
Mengganti aplikasi Radio
Mengingat bahwa aplikasi Radio mengimplementasikan Jelajah Media dan Sesi Media, Radio ditampilkan di peluncur Aplikasi. Untuk mencegah peluncuran Media saat pengguna mengklik ikon, diperlukan dua elemen. Radio harus :
- Memiliki aktivitas peluncur .
- Dideklarasikan sebagai sumber khusus . Untuk melakukannya, tambahkan nama komponen ke kunci
custom_media_packages
dicar-media-common/res/values/config.xml
.
Pembatasan mengemudi UX
Media harus mematuhi semua batasan gangguan mengemudi UX. Untuk melakukannya, Media harus mendengarkan CarUXRestrictionManager dan menerapkan semua kebijakannya.
- Media harus terhubung ke perpustakaan Mobil dan mendapatkan instance CarUXRestrictionManager .
- Media harus berlangganan pembaruan dalam daftar Pembatasan CarUx dan menerapkannya seperti yang didokumentasikan.
- Terutama penting untuk Media adalah:
-
UX_RESTRICTIONS_NO_SETUP
. Dalam hal ini, alur masuk harus dinonaktifkan. -
UX_RESTRICTIONS_LIMIT_STRING_LENGTH
. Pesan kesalahan dan teks lain yang disediakan oleh aplikasi media harus dibatasi dengan panjang tertentu.
-