Integre comandos de voz ao seu app de mídia para aumentar a segurança e
conveniência dos motoristas, minimizando as distrações. Quando o Android Auto ou o Android Automotive
OS (AAOS) detecta e interpreta uma ação por voz, ele envia a ação ao seu
app pelo callback onPlayFromSearch.
Ao receber o callback, o app encontra conteúdo que corresponde à string de consulta e inicia a reprodução. O app precisa considerar várias categorias de consultas, como gênero, artista, álbum, nome da música, estação de rádio ou playlist. Além disso, o app precisa processar uma string de consulta vazia, que indica uma solicitação geral de música.
Se o app estiver reproduzindo um item de mídia, o usuário poderá dizer "Tocar [título da música]" para pedir ao app a reprodução de um item diferente sem olhar ou tocar na tela do carro. Os usuários podem iniciar consultas clicando nos botões correspondentes no volante ou falando as hotwords "Ok Google".
Quando o Android Auto ou o AAOS detecta e interpreta uma ação por voz, ele a envia ao app pelo onPlayFromSearch. Ao
receber esse callback, o app encontra conteúdo correspondente à string query e
inicia a reprodução.
O usuário pode especificar diferentes categorias de termos nas consultas, como gênero, artista,
álbum, nome da música, estação de rádio ou playlist, entre outros. Ao desenvolver o
suporte à pesquisa, considere todas as categorias que fazem sentido para o app.
Se o Android Auto ou o AAOS detectar que uma consulta se encaixa em uma
categoria específica, os extras serão anexados ao parâmetro extras. Você pode enviar estes
extras:
Considere uma string query vazia, que pode ser enviada pelo Android Auto ou pelo AAOS
se o usuário não especificar termos de pesquisa. Por exemplo, se o usuário disser
"Tocar música". Nesse caso, o app pode iniciar uma faixa
reproduzida recentemente ou uma nova.
Se o app não conseguir processar uma pesquisa rapidamente, não bloqueie onPlayFromSearch.
Em vez disso, defina o estado de reprodução como STATE_CONNECTING e faça a
pesquisa em uma linha de execução assíncrona.
Quando a reprodução começar, considere preencher a fila da sessão de mídia com conteúdos relacionados. Por exemplo, se o usuário solicitar a reprodução de um álbum, o app pode preencher a fila com a lista de faixas do álbum.
Além de consultas de "Tocar", o Android Auto e o AAOS reconhecem consultas de voz para
controlar a reprodução, como "pausar música" e "próxima música", e usam esses comandos com
os callbacks de sessão de mídia adequados, como onPause e onSkipToNext.
Para saber mais sobre como implementar a pesquisa por voz para tocar conteúdo de áudio, consulte Google Assistente e apps de música.