O Google Assistente permite o controle de voz em apps Android. Com o Google Assistente, os usuários podem iniciar apps, realizar tarefas, acessar conteúdo e muito mais usando a voz para dizer algo como "Ok Google, iniciar uma corrida no app de exemplo".
Como desenvolvedor Android, você pode usar o framework de desenvolvimento e as ferramentas de teste do Google Assistente para ativar facilmente o controle de voz profundo dos seus apps em plataformas 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.
As Ações no app permitem um controle de voz mais profundo, permitindo que os usuários iniciem seus apps e realizem tarefas como:
- Como iniciar recursos do Google Assistente: conecte os recursos do seu app a consultas do usuário que correspondem a padrões semânticos predefinidos ou intents integradas.
- Exibição de informações do app nas plataformas do Google: forneça widgets do Android para o Google Assistente mostrar, oferecendo respostas inline, confirmações simples e interações breves aos usuários sem mudar o contexto.
- Sugestão de atalhos de voz do Google Assistente: use o Google Assistente para sugerir tarefas no contexto certo para os usuários descobrirem ou repetirem.
As Ações no app usam intents integradas (BIIs, na sigla em inglês) para permitir esses e muitos outros casos de uso em categorias de tarefas conhecidas. Consulte a visão geral das Ações no app nesta página para saber como oferecer suporte a BIIs nos seus apps.
Desenvolvimento compatível com vários dispositivos
Você pode usar Ações no app para fornecer controle de encaminhamento de voz em superfícies de dispositivos além do dispositivo móvel. Por exemplo, com BIIs otimizadas para casos de uso para automóveis, os motoristas podem executar as seguintes tarefas usando a voz:
- Iniciar trajeto até o restaurante mais próximo no trajeto
- Encontrar o estacionamento mais próximo
- Localizar estações de recarga de VEs próximas
Visão geral de Ações no app
Você usa Ações no app para oferecer controle de voz mais detalhado aos seus apps, permitindo que eles usem a voz para realizar tarefas específicas no app. Se um usuário tiver seu app instalado, ele poderá simplesmente declarar a intent usando uma frase que inclua o nome do app, como "Ok Google, peça uma pizza no app de exemplo". As Ações no app oferecem suporte a BIIs que modelam as maneiras comuns como os usuários expressam as tarefas que querem realizar ou as informações que procuram, por exemplo:
- Pedir comida, reservar viagens e outras ações específicas da categoria.
- Abrindo um recurso do seu 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 esses atalhos no app com o SDK da promoção no app de 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 app pode ser
acessada semanticamente usando BII e ativam o suporte por voz para os 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.
Declare BIIs no app usando elementos de recurso do Android. Quando você faz upload do seu app usando o Google Play Console, o Google registra os recursos declarados e os disponibiliza para os usuários acessarem pelo Google Assistente.
Por exemplo, você pode oferecer o recurso de pedir comida no seu app. Quando um usuário diz "Ok Google, peça uma pizza no app de exemplo", as seguintes 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.ORDER_MENU_ITEM
corresponde à consulta. - O Google Assistente verifica se a BII foi registrada anteriormente para o app e usa essa configuração para determinar como iniciar.
- O Google Assistente gera uma intent do Android para iniciar o destino no app da
solicitação usando as informações fornecidas 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 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://developer.android.google.cn/static/guide/app-actions/images/assistant-flow.png?authuser=5&hl=pt)
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.
O uso dessa biblioteca torna seus atalhos qualificados para descoberta e repetição nas plataformas do Google, como o Google Assistente. Por exemplo, você pode enviar um atalho ao Google para cada destino que um usuário solicitar no app de compartilhamento de viagem para uma repetição rápida 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, BIIs existem para ações como pedir comida, reservar uma viagem e conferir o saldo da conta. As BIIs são a melhor maneira de começar a usar as Ações no app, porque elas modelam variações comuns de consultas do usuário em vários idiomas, facilitando a ativação do app 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 os comandos de apps de música, 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 das Ações no app para criar uma Ação no app usando nosso app Android de exemplo. Em seguida, prossiga para nosso guia para criar Ações no app para seu app. Você também pode explorar estes outros recursos 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.