Intents integradas para Ações no app

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.

Figura 1. Invocar a BII START_EXERCISE com uma voz consulta ao Google Assistente.

Figura 2. Iniciar o app em uma tela específica para iniciar a tarefa START_EXERCISE.

Figura 3. Mostrar um widget em resposta a uma consulta.

​

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:

1. Declare capability com a BII escolhida.
2. Adicione elementos parameter aninhados para cada campo de BII que você quiser adicionar.
   1. Se você usa targetClass ou targetPackage, mapeie-os para o Android extras usando o nome escolhido.
   2. Se você usar um URL de link direto, use os parâmetros nomeados na consulta string do modelo de URL.

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.

Observação: Ações no app, assim como todas as ações que oferecem suporte a intents integradas, são acionadas com base em uma série de fatores, incluindo qualidade e relevância para a solicitação do usuário. Com base nesses fatores, o Google pode decidir mostrar ou não a ação em resposta a solicitações de usuários.

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.