Integrasikan voice action ke dalam aplikasi media Anda untuk meningkatkan keselamatan dan kenyamanan pengemudi dengan meminimalkan gangguan. Saat Android Auto atau Android Automotive
OS (AAOS) mendeteksi dan menafsirkan voice action, keduanya akan mengirimkan tindakan tersebut ke aplikasi Anda melalui callback onPlayFromSearch
.
Setelah menerima callback, aplikasi Anda akan menemukan konten yang cocok dengan string kueri, lalu memulai pemutaran. Aplikasi Anda harus memperhitungkan berbagai kategori kueri, seperti genre, artis, album, nama lagu, stasiun radio, atau playlist. Selain itu, aplikasi Anda harus menangani string kueri kosong, yang menunjukkan permintaan umum untuk musik.
Jika aplikasi Anda sedang memutar satu item media, pengguna dapat mengucapkan "Putar [judul lagu]" untuk meminta aplikasi tersebut memutar lagu lain tanpa melihat atau menyentuh layar mobil. Pengguna dapat memulai kueri dengan mengklik tombol yang sesuai di setir atau mengucapkan frasa pengaktif "OK Google".
Saat mendeteksi dan menafsirkan voice action, Android Auto atau AAOS akan mengirimkan voice action tersebut ke aplikasi melalui onPlayFromSearch
. Setelah
menerima callback ini, aplikasi akan menemukan konten yang cocok dengan string query
dan
kemudian memulai pemutaran.
Pengguna dapat menentukan kategori istilah yang berbeda dalam kuerinya, di antaranya genre, artis,
album, nama lagu, stasiun radio, atau playlist. Saat membuat
dukungan untuk penelusuran, pertimbangkan semua kategori yang sesuai untuk aplikasi Anda.
Jika Android Auto atau AAOS mendeteksi bahwa kueri tertentu cocok dengan
kategori tertentu, tambahan akan ditambahkan di parameter extras
. Anda dapat mengirimkan
ekstra berikut:
Akun untuk string query
kosong, yang dapat dikirim oleh Android Auto atau AAOS
jika pengguna tidak menentukan istilah penelusuran. Misalnya, jika pengguna mengucapkan
"Putar musik". Dalam hal ini, aplikasi Anda dapat memulai trek yang baru diputar atau baru.
Jika aplikasi Anda tidak dapat memproses penelusuran dengan cepat, jangan lakukan pemblokiran di onPlayFromSearch
.
Sebagai gantinya, tetapkan status pemutaran ke STATE_CONNECTING
dan lakukan
penelusuran pada thread asinkron.
Saat pemutaran dimulai, pertimbangkan untuk mengisi antrean sesi media dengan konten terkait. Misalnya, jika pengguna meminta agar album diputar, aplikasi Anda dapat mengisi antrean dengan daftar lagu album.
Selain kueri "Putar", Android Auto dan AAOS mengenali kueri suara untuk
mengontrol pemutaran seperti "jeda musik" dan "lagu berikutnya", serta mencocokkan perintah ini dengan
callback sesi media yang sesuai, seperti onPause
dan onSkipToNext
.
Untuk mempelajari lebih lanjut cara menerapkan tindakan pemutaran yang diaktifkan dengan suara, lihat Asisten Google dan aplikasi media.