Apps de mídia no modo carro do Google Assistente

O Google Assistente ajuda os motoristas a realizar tarefas que eles já estão fazendo enquanto dirigem. Ele reduz a distração fornecendo experiências multimodais de visualização rápida e voltada para a voz. O modo carro ajuda a tornar cada viagem mais segura, mais informada, conectada e agradável.

Usar o modo carro

Um dispositivo entra automaticamente no modo carro quando você inicia o trajeto no Google Maps.

Para desativar o modo carro:

1. Acesse Configurações do Google Maps > Configurações de navegação > Configurações do Google Assistente > Gerenciar modo carro.
2. Desative a configuração Modo carro.

Pré-requisitos do app

Para que o modo carro funcione corretamente com seu app de música, ele precisa atender a estes requisitos:

• Siga todas as instruções no Google Assistente e em apps de mídia.
• Seu app precisa declarar que oferece suporte a mídia para o Android Auto. Siga as instruções em Declarar suporte de mídia para o Android Auto.
• Processar seleção de áudio
• Use PlaybackState para informar erros.
• Implemente um MediaBrowserService e uma MediaSession
• Sua MediaSession precisa implementar estes callbacks:
  • onPlay()
  • onPlayFromSearch()
  • onPlayFromUri()
  • onSkipToNext()
  • onSkipToPrevious()
  • onPause()
  • onStop()
• Mantenha os metadados de MediaSession atualizados chamando setMetadata().

Modo carro e controles de mídia

Cada app determina os controles de transporte que aparecem na tela. Para fazer isso, conecte o MediaSession a TransportControls. Por exemplo, um player de música geralmente mostra estes controles:

Outras ações compatíveis são invocadas usando comandos de voz.

Recomendações de mídia no modo carro

O Modo carro mostra recomendações em dois lugares: na página "Para você" e na página de navegação do app. As telas são semelhantes:

Para você

Navegação em apps

O Google Assistente chama MediaBrowserService.onGetRoot() com a dica EXTRA_SUGGESTED para extrair recomendações. Você vai retornar uma lista simples de objetos MediaItem reproduzíveis. A tela de navegação do app mostra todos os itens da lista. Não há garantia de que a tela "para você" vai mostrar as recomendações se houver menos de 15 itens na lista.

Cada MediaItem precisa ter arte de mídia. Você pode fornecer o tipo de MediaItem adicionando um par de chave-valor CONTENT_TYPE ao Bundle na MediaDescription de cada MediaItem. Isso ajuda a melhorar a classificação do item na página "Para você".

Os valores possíveis para CONTENT_TYPE são:

• ÁLBUM
• ARTISTA
• PLAYLIST
• TV_SHOW_EPISÓDIO
• PODCAST_EPISÓDIO
• MÚSICA
• ÁUDIO_LIVRO
• ESTAÇÃO DE RADIOFAÇÃO
• VÍDEO
• NOTÍCIAS

Testes

Use o app de teste de controle de mídia para verificar seu app.

Problemas conhecidos

É importante evitar abrir um app de música em primeiro plano enquanto estiver no modo carro. Por exemplo, quando o Google Assistente chama MediaBrowserService.onGetRoot() para extrair recomendações, seu app precisa garantir que o estado da PlaybackState seja STATE_NONE. Isso impede que o app seja colocado em primeiro plano. No momento, não há como um app detectar se está no modo carro ou não.