O Google Assistente ativa o controle de encaminhamento de voz de apps Android. Usando Google Assistente, os usuários podem iniciar apps, realizar tarefas, acessar conteúdo e muito mais usando a voz para dizer coisas como "Ok Google, comece uma corrida App de exemplo."
Como desenvolvedor Android, você pode usar o framework de desenvolvimento do Google Assistente e ferramentas de teste para ativar facilmente o controle de voz profundo de seus aplicativos em Superfícies com tecnologia Android, como dispositivos móveis, carros e wearables.
Ações no app
As Ações no app do Google Assistente permitem que os usuários iniciem e controlem apps Android com a voz delas.
As Ações no app têm um controle de voz mais detalhado, permitindo que os usuários iniciem seus apps e realizar tarefas como:
- Iniciar recursos do Google Assistente: conecte os recursos do seu app a consultas de usuários que correspondem a padrões semânticos predefinidos ou intents integradas.
- Exibir informações do app nas plataformas do Google: forneça Widgets do Android para o Google Assistente mostrar, oferecendo respostas inline, confirmações e breves interações com usuários sem mudar o contexto.
- Sugerir atalhos de voz no Google Assistente: use o Google Assistente para proativamente sugerir tarefas no contexto certo para os usuários descobrirem ou reproduzirem.
As Ações no app usam intents integradas (BIIs, na sigla em inglês) para viabilizar essas e muitas outras formas casos em categorias de tarefas populares. Consulte as Ações no app. nesta página, você encontra detalhes sobre como oferecer suporte a BIIs nos seus apps.
Desenvolvimento para vários dispositivos
Você pode usar as Ações no app para fornecer controle de encaminhamento de voz nas superfícies do dispositivo além dos dispositivos móveis. Por exemplo, com BIIs otimizadas para casos de uso do Android Auto, os motoristas pode realizar as seguintes tarefas usando a voz:
- Navegar até o restaurante mais próximo no trajeto de carro
- Encontrar o estacionamento mais próximo
- Encontrar estações de recarga de VEs próximas
Visão geral de Ações no app
As Ações no app são usadas para oferecer um controle de voz mais detalhado dos seus aplicativos aos usuários, permitindo que eles usem a voz para realizar tarefas específicas no seu aplicativo. Se um O usuário tem seu app instalado, ele pode simplesmente declarar a intenção dele usando uma frase que inclua o nome do app, como "Ok Google, iniciar um exercício no App de exemplo." As Ações no app oferecem suporte a BIIs que modelam as formas comuns usadas pelos usuários expressar tarefas que querem realizar ou informações que procuram, como:
- Iniciar um exercício, enviar mensagens e outras ações específicas de uma categoria.
- Abrindo um recurso do app.
- Consultar produtos ou conteúdo usando a pesquisa no app.
Com Ações no app, o Assistente pode sugerir proativamente recursos de voz como atalhos para os usuários, com base no contexto. Essa função permite que os usuários descubram e reproduzam Ações no app com facilidade. Você também pode sugerir atalhos no seu app com o SDK de promoção no app das Ações no app.
Declare as tags <capability>
em
shortcuts.xml
para ativar o suporte a Ações no app. Os recursos informam ao Google como a funcionalidade no aplicativo pode ser
serão acessados semanticamente usando BII e ativar o suporte por voz para seus recursos.
O Google Assistente inicia o app para
o conteúdo ou a ação especificada pelo pedido do usuário. Em alguns casos de uso, é possível especificar um widget
do Android que o Google Assistente mostra para atender à consulta do usuário.
As Ações no app tem suporte no Android 5 (nível 21 da API) e versões mais recentes. Os usuários só podem acessar Ações no app em smartphones Android. O Google Assistente no Android Go não tem suporte a elas.
Como as Ações no app funcionam
As Ações no app estendem os recursos do app ao Google Assistente, permitindo que os usuários
acessem os recursos usando a voz. Quando um usuário invoca uma ação do app,
o Google Assistente associa a consulta a uma BII declarada no recurso shortcuts.xml
e
abre o app na tela solicitada ou mostra um widget do Android.
Você declara BIIs no seu app usando elementos de recurso do Android. Quando você enviar seu app usando o Google Play Console, o Google registra o declarados no app e os disponibiliza para os usuários acessarem usando o Google Assistente.
Por exemplo, você pode oferecer um recurso para iniciar exercícios no aplicativo. Quando um usuário disser Ok Google, iniciar uma corrida no app de exemplo, faça o seguinte: etapas ocorrem:
- O Google Assistente executa a análise de linguagem natural na consulta, associando a
semântica da solicitação ao padrão predefinido de uma BII. Nesse caso,
a BII
actions.intent.START_EXERCISE
corresponde à consulta. - O Google Assistente verifica se a BII já foi registrada para seu app e usa essa configuração para determinar como iniciá-la.
- O Google Assistente gera uma intent do Android para iniciar o destino no app do
solicitação, usando as informações que você fornecer no
<capability>
. O Google Assistente extrai os parâmetros da consulta e os transmite como extras em uma intent do Android gerada. - O Google Assistente atende à solicitação do usuário iniciando a intent
do Android gerada. Você configura a
intent
para iniciar uma tela no app ou para mostrar um widget no Google Assistente.
![Quando um usuário faz uma consulta no Google Assistente, o Assistente
o leva para um destino de app.](https://android-dot-devsite-v2-prod.appspot.com/static/guide/app-actions/images/assistant-flow.png?hl=pt-br)
Depois que um usuário concluir uma tarefa, use a Biblioteca Google Shortcuts Integration para enviar um atalho dinâmico da ação e os parâmetros dela ao Google. Isso fará com que o Google Assistente sugira o atalho para o usuário quando relevante.
Ao usar esta biblioteca, você qualifica os atalhos para descoberta e repetição em Plataformas do Google, como o Google Assistente. Por exemplo, você pode enviar um atalho para O Google para cada destino solicitado por um usuário no seu app de transporte por aplicativo de novo mais tarde como uma sugestão de atalho.
Criar Ações no app
As Ações no app são criadas com base em funcionalidades existentes no seu app Android.
O processo é semelhante para cada ação implementada. As Ações no app direcionam usuários
a conteúdos ou recursos específicos no app usando os elementos capability
especificados em shortcuts.xml
.
Ao criar uma Ação no app, a primeira etapa é identificar a atividade que você quer permitir que os usuários acessem pelo Google Assistente. Em seguida, usando essas informações, consulte a referência da BII de Ações no app para encontrar a BII mais próxima a ação que quer implementar.
As BIIs são modelos das formas mais comuns com que os usuários expressam tarefas que querem fazer usando um app ou das informações que procuram. Por exemplo, as BIIs existem ações como iniciar um exercício, enviar uma mensagem, pesquisar em um Aplic. As BIIs são a melhor maneira de começar com Ações no app, porque elas modelam as práticas variações de consultas de usuários em vários idiomas, facilitando ativar seu app com rapidez por voz.
Depois de identificar o recurso do app e a BII, adicione ou
atualize o arquivo de recurso shortcuts.xml
do app Android que mapeia a BII
para essa função. Ações no app definidas como elementos capability
em
shortcuts.xml
descrevem como cada BII resolve o fulfillment e quais
parâmetros são extraídos e fornecidos ao app.
Uma parte significativa do desenvolvimento de Ações no app é o mapeamento dos parâmetros de BII no fulfillment definido. Esse processo geralmente envolve mapear as entradas esperadas do recurso do app para os parâmetros semânticos da BII.
Testar Ações no app
Durante o desenvolvimento e os testes, você usa o plug-in do Google Assistente no Android Studio para criar prévias de Ações no app para sua Conta do Google. Esse plug-in ajuda você a testar como as Ações no app processam vários parâmetros antes de as implantar. Depois de gerar uma prévia da Ação no app na ferramenta de teste, você pode acionar uma ação no dispositivo de teste diretamente na janela da ferramenta.
Apps de música
O Google Assistente também oferece recursos integrados para entender comandos de apps de mídia, como "Ok Google, toque algo da Beyoncé" e oferece suporte a controles de mídia, como pausar, pular, avançar e gostei.
Próximas etapas
Siga o Programa de treinamentos para Ações no app para criar uma Ação no app usando nosso exemplo App Android. Em seguida, prossiga para nosso guia para criar Ações no app. Você também pode explorar estes recursos extras para criar Ações no app:
- Faça o download e explore o exemplo de app Android de condicionamento físico no GitHub (em inglês).
- r/GoogleAssistantDev (em inglês): comunidade oficial do Reddit para desenvolvedores que trabalham com o Google Assistente.
- Se você tiver alguma dúvida de programação sobre Ações no app, envie uma postagem para o Stack Overflow (em inglês) usando as tags "android" e "app-actions". Antes de postar, verifique se a dúvida está de acordo com o tema e se você leu as orientações sobre como fazer uma boa pergunta.
- Informe bugs e problemas gerais com os recursos de Ações no app no nosso Issue Tracker público.