UI Radio diterapkan sebagai aplikasi independen. Petunjuk tentang cara mengintegrasikan UI Radio ke hardware radio dapat ditemukan di Menerapkan radio.
Bagian berikut menjelaskan cara mengintegrasikan UI Radio dengan Media untuk memberikan pengalaman yang lancar kepada pengguna sehingga mereka dapat berinteraksi dengan sumber media dan radio seolah-olah itu adalah satu aplikasi.
Alur penggunaan pengalihan sumber media
Diagram berikut mengilustrasikan cara penerapan referensi Radio dan Media menerapkan alur penggunaan pengalihan aplikasi.
Gambar 1. Alur pengguna peralihan sumber media
Untuk menyediakan transisi yang lancar antara Radio dan aplikasi lain di Media, library
car-media-common
menentukan intent Android yang dapat digunakan untuk meluncurkan pemilih
sumber media. Di AOSP, pemilih ini diterapkan di Peluncur Aplikasi, yang menampilkan UI yang sama
untuk meluncurkan aplikasi, tetapi difilter untuk hanya menampilkan sumber media.
OEM dapat memilih untuk menggunakan implementasi Peluncur Aplikasi saat ini apa adanya, atau menerapkan pemilih sumber media yang disesuaikan.
Pemilih dapat bertindak dalam dua mode:
- Alur normal. Setelah menggunakan pemilih, sumber yang dipilih akan ditampilkan di Media sehingga pengguna dapat menjelajahi kontennya.
- Sebagai tombol. Pemilih digunakan untuk beralih sumber, tetapi media tidak ditampilkan kepada pengguna. Hal ini berlaku untuk ikon Pemilih di Halaman Beranda. Setelah memilih sumber, layar sebelumnya yang terbaru akan ditampilkan kepada pengguna (dalam hal ini, Halaman beranda).
Intent yang digunakan untuk beralih antarsumber media dapat diperoleh dari
metode MediaSource#getSourceSelectorIntent()
, yang menerima Boolean
popup
yang menampilkan intent untuk meluncurkan setiap alur yang dijelaskan di atas.
Intent 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 aplikasi Radio menerapkan Penjelajahan 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 kustom. Untuk melakukannya, tambahkan nama komponen ke kunci
custom_media_packages
dicar-media-common/res/values/config.xml
.
Batasan mengemudi UX
Media harus mematuhi semua batasan gangguan mengemudi UX. Untuk melakukannya, Media harus memproses CarUXRestrictionManager dan menerapkan semua kebijakannya.
- Media harus terhubung ke library Car dan mendapatkan instance CarUXRestrictionManager.
- Media harus berlangganan update dalam daftar CarUxRestrictions dan menerapkannya seperti yang didokumentasikan.
- Hal yang sangat penting untuk Media adalah:
UX_RESTRICTIONS_NO_SETUP
. Dalam hal ini, alur login harus dinonaktifkan.UX_RESTRICTIONS_LIMIT_STRING_LENGTH
. Pesan error dan teks lainnya yang disediakan oleh aplikasi media harus dibatasi hingga panjang yang ditentukan.