App multimediali in modalità Auto dell'Assistente Google

L'Assistente Google aiuta i conducenti a svolgere le attività che già svolgono durante la guida. Riduce le distrazioni fornendo esperienze multimodali suggeribili tramite comandi vocali. La modalità Auto contribuisce a rendere ogni guida più sicura, più informata, connessa e piacevole.

Utilizzare la modalità Auto

Un dispositivo entra automaticamente in modalità Auto quando inizi a navigare in Google Maps.

Per disattivare la modalità Auto:

1. Vai a Impostazioni di Google Maps > Impostazioni di navigazione > Impostazioni Assistente Google > Gestisci modalità Auto.
2. Disattiva l'impostazione Modalità Auto.

Prerequisiti dell'app

Affinché la modalità Auto funzioni correttamente con la tua app multimediale, l'app deve soddisfare i seguenti requisiti:

• Segui tutte le indicazioni fornite nell'articolo Assistente Google e nelle app multimediali
• L'app deve dichiarare che supporta i contenuti multimediali per Android Auto. Segui le istruzioni riportate nella pagina relativa alla dichiarazione del supporto dei contenuti multimediali per Android Auto.
• Gestire la messa a fuoco audio
• Utilizza PlaybackState per segnalare gli errori
• Implementa MediaBrowserService e MediaSession
• La MediaSession deve implementare i seguenti callback:
  • onPlay()
  • onPlayFromSearch()
  • onPlayFromUri()
  • onSkipToNext()
  • onSkipToPrevious()
  • onPause()
  • onStop()
• Mantieni aggiornati i metadati MediaSession chiamando setMetadata().

Modalità Auto e controlli di riproduzione

Ogni app determina i controlli di trasporto che vengono visualizzati sullo schermo. Per farlo, collega il suo MediaSession a TransportControls. Ad esempio, in genere un lettore musicale mostra i seguenti controlli:

Eventuali altre azioni supportate vengono richiamate tramite comandi vocali.

Consigli di contenuti multimediali in modalità Auto

La modalità Auto mostra i consigli in due posizioni: la pagina "Per te" e la pagina delle categorie dell'app. Le schermate sono simili:

Per te

Navigazione di app

L'assistente chiama MediaBrowserService.onGetRoot() con il suggerimento EXTRA_SUGGESTED per recuperare i consigli. Dovresti restituire un elenco semplice di oggetti MediaItem riproducibili. La schermata di esplorazione dell'app mostra tutti gli elementi nell'elenco. Se l'elenco contiene meno di 15 elementi, non è garantito che i consigli vengano visualizzati nella schermata "per te".

Ogni MediaItem deve includere un'immagine multimediale. Puoi fornire il tipo di MediaItem aggiungendo una coppia chiave-valore CONTENT_TYPE al Bundle nel MediaDescription di ogni MediaItem. Ciò consente di migliorare il ranking dell'articolo nella pagina "per te".

I valori possibili per CONTENT_TYPE sono:

• ALBUM
• ARTISTA
• PLAYLIST
• PROGRAMMA_TV_EPISODIO
• PODCAST_EPISODE
• MUSICA:
• LIBRO_AUDIO
• STAZIONE_Radio
• VIDEO
• ORA

Test

Utilizza l'app di test Media Control per verificare l'app.

Problemi noti

È importante evitare di aprire un'app multimediale in primo piano mentre è in modalità Auto. Ad esempio, quando l'assistente chiama MediaBrowserService.onGetRoot() per recuperare consigli, la tua app deve garantire che lo stato della tua PlaybackState sia STATE_NONE. In questo modo la tua app non viene messa in primo piano. Al momento non è possibile per un'app rilevare se è in modalità Auto.