Aplikasi media di mode mengemudi Asisten Google

Asisten Google membantu pengemudi melakukan tugas yang sudah mereka lakukan saat mengemudi. Mengurangi distraksi dengan menyediakan pengalaman multimodal yang mudah dilihat dan voice-forward. Mode mengemudi membantu membuat setiap perjalanan lebih aman, lebih banyak informasi, terhubung, dan menyenangkan.

Menggunakan mode mengemudi

Perangkat secara otomatis memasuki mode mengemudi saat Anda memulai navigasi di Google Maps.

Untuk menonaktifkan mode mengemudi:

1. Buka Setelan Google Maps > Setelan Navigasi > Setelan Asisten Google > Kelola Mode Mengemudi.
2. Nonaktifkan setelan Mode Mengemudi.

Prasyarat aplikasi

Agar mode mengemudi berfungsi dengan benar dengan aplikasi media Anda, aplikasi harus memenuhi persyaratan berikut:

• Ikuti semua petunjuk di Asisten Google dan aplikasi media
• Aplikasi Anda harus mendeklarasikan bahwa aplikasi mendukung media untuk Android Auto. Ikuti petunjuk di mendeklarasikan dukungan media untuk Android Auto.
• Menangani fokus audio
• Menggunakan PlaybackState untuk melaporkan error
• Mengimplementasikan MediaBrowserService dan MediaSession
• MediaSession Anda harus menerapkan callback ini:
  • onPlay()
  • onPlayFromSearch()
  • onPlayFromUri()
  • onSkipToNext()
  • onSkipToPrevious()
  • onPause()
  • onStop()
• Pertahankan metadata MediaSession dengan memanggil setMetadata().

Mode mengemudi dan kontrol pemutaran

Setiap aplikasi menentukan kontrol transport yang muncul di layar. Lakukan hal ini dengan menghubungkan MediaSession ke TransportControls. Misalnya, pemutar musik biasanya menampilkan kontrol berikut:

Tindakan lain yang didukung dipanggil melalui perintah suara.

Rekomendasi media dalam mode mengemudi

Mode mengemudi menampilkan rekomendasi di dua tempat, halaman "Untuk Anda" dan halaman penjelajahan aplikasi. Layarnya akan terlihat mirip:

Untuk Anda

Jelajah aplikasi

Asisten memanggil MediaBrowserService.onGetRoot() dengan petunjuk EXTRA_SUGGESTED untuk mengambil rekomendasi. Anda harus menampilkan daftar tetap objek MediaItem yang dapat diputar. Layar penjelajahan aplikasi menampilkan semua item dalam daftar. Layar "untuk Anda" tidak dijamin akan menampilkan rekomendasi sama sekali jika ada kurang dari 15 item dalam daftar.

Setiap MediaItem harus memiliki gambar media. Anda dapat menyediakan jenis MediaItem dengan menambahkan pasangan nilai kunci CONTENT_TYPE ke Bundle di MediaDescription untuk setiap MediaItem. Hal ini membantu meningkatkan peringkat item di halaman "untuk Anda".

Kemungkinan nilai untuk CONTENT_TYPE adalah:

• ALBUM
• ARTIS
• PLAYLIST
• TV_SHOW_EPISODE
• PODCAST_EPISODE
• MUSIK
• BUKU_AUDIO
• Stasiun Radio
• VIDEO
• TERBARU

Pengujian

Gunakan aplikasi pengujian Media Control untuk memverifikasi aplikasi Anda.

Masalah umum

Sebaiknya jangan buka aplikasi media di latar depan saat dalam mode mengemudi. Misalnya, saat Asisten memanggil MediaBrowserService.onGetRoot() untuk mengambil rekomendasi, aplikasi Anda harus memastikan bahwa status PlaybackState adalah STATE_NONE. Tindakan ini akan mencegah aplikasi Anda dibawa ke latar depan. Saat ini tidak ada cara bagi aplikasi untuk mendeteksi apakah aplikasi berada dalam mode mengemudi atau tidak.