As intents integradas (BIIs) permitem que o app expresse os recursos de fulfillment para o Google. Declarando recursos no arquivo Shortcuts.xml e mapear parâmetros de intent para o fulfillment, é possível Google Assistente para iniciar seu app em uma tela específica em resposta a uma para que o usuário possa concluir uma tarefa.
As intents integradas são agrupadas de acordo com as categorias do app. Cada categoria representa um conjunto de tarefas comuns que os usuários querem realizar nos apps. A lista completa de BIIs disponíveis, os parâmetros delas e exemplos as consultas utilizáveis para teste estão na referência de intents integradas.
Muitas BIIs têm requisitos de implantação específicos e recomendações. Esses requisitos e recomendações ajudam seu app a entregar a melhor experiência possível para seus usuários.
![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness1.png?authuser=0000&hl=pt)
START_EXERCISE
com uma voz
consulta ao Google Assistente.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness3.png?authuser=0000&hl=pt)
START_EXERCISE
.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness4-widget.png?authuser=0000&hl=pt)
Implementar BIIs e processar parâmetros de intent
Em Ações no app, você declara recursos e processa parâmetros de BII no arquivo atalhos.xml. Implementar e processar uma BII , siga estas etapas:
- Declare
capability
com a BII escolhida. - Adicione elementos
parameter
aninhados para cada campo de BII que você quiser adicionar.- Se você usa
targetClass
outargetPackage
, mapeie-os para o Androidextras
usando o nome escolhido. - Se você usar um URL de link direto, use os parâmetros nomeados na consulta string do modelo de URL.
- Se você usa
Para processar um parâmetro de BII, mapeie esse parâmetro para a
parâmetro correspondente de uma intent explícita do Android na sua capability
.
Em seguida, você pode usar o valor dele no seu app. O app não precisa processar
Parâmetros de BII. No entanto, tente processar os campos de dados marcados como "Recomendado".
na referência de intents integradas.
É possível definir vários fulfillments de intent, cada um com o próprio conjunto de parâmetros recomendados. O Google seleciona o atendimento do pedido adequado parâmetros de capacidade identificados a partir da consulta do usuário e os que foram declarados em uma intent.
Por exemplo, o actions.intent.START_EXERCISE
recomenda que seu app processe o parâmetro de BII exercise.name
, mas você
pode implementar a BII no app sem parâmetros.
Você pode fazer isso se quiser lidar com as consultas do usuário sem a necessidade
Nome do exercício, como "Peça ao App de Exemplo para começar a monitorar seu exercício".
A O snippet a seguir tem um substituto para um fulfillment sem parâmetros obrigatórios se os parâmetros não estiverem incluídos na consulta do usuário:
<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<capability android:name="actions.intent.START_EXERCISE">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity1"
android:targetPackage="com.example.myapplication">
<parameter
android:name="exercise.name"
android:key="exerciseType"
android:required="true"
/>
</intent>
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity2">
</intent>
</capability>
</shortcuts>
O Google Assistente faz o possível para fornecer as informações mais relevantes às pessoas o usuário ao retornar valores de parâmetros para seu aplicativo. Por exemplo, as consultas do usuário para pedir pizza no aplicativo para celular do Restaurante Exemplo nem sempre inclua um o local. Para atender melhor o usuário, o Google Assistente pode fornecer a latitude valores de longitude do Restaurante Exemplo mais próximo desse aplicativo.
Como requisito adicional, você não quer que seu aplicativo execute diretamente uma ação que modifica o estado real de um usuário (por exemplo, transferir dinheiro, fazer um pedido ou enviar uma mensagem) sem primeiro confirmar o com o usuário.
Desambiguação
Os argumentos transmitidos ao app via <url-parameter>
ou os extras de intent podem não
identifique exclusivamente o item que você quer mostrar ao usuário. Nesse caso,
usar o valor do argumento como um argumento de pesquisa e levar o usuário ao campo
do app. Ele pode eliminar a ambiguidade e escolher o item certo.
Por exemplo, se a consulta de um usuário for “Pedido do restaurante de exemplo” para o
a BII ORDER_MENU_ITEM
, você pode apresentar ao usuário uma lista de
restaurantes com nomes que correspondem ao termo "Example Restaurant"
.
Suporte a idiomas e localidades
As localidades com suporte para desenvolvimento e testes em cada BII das Ações no app estão listados na referência de intents integradas. Algumas BIIs têm diferentes suporte à localidade para testes de desenvolvedores e acionamento de usuários pelo Google Assistente.