Intent integrati per Azioni app

Gli intent integrati consentono all'app di esprimere le sue funzionalità di fulfillment a Google. dichiarando le funzionalità nel file scorciatoie.xml e mappare i parametri di intent al fulfillment, si rende possibile all'Assistente Google di avviare l'app su una schermata specifica in risposta a un per consentire all'utente di completare un'attività.

Gli intent integrati vengono raggruppati in base alle categorie di app. Ogni categoria rappresenta un insieme di attività comuni che gli utenti spesso desiderano eseguire sul proprio app. L'elenco completo degli intent integrati disponibili, i relativi parametri e un esempio utilizzabili per i test è nel riferimento per intent integrato.

Molti intent integrati hanno requisiti di deployment specifici personalizzati. Questi requisiti e consigli aiutano la tua app a fornire la migliore esperienza possibile agli utenti.

Figura 1. Richiama l'intent integrato START_EXERCISE con una voce all'assistente.
Figura 2. Avvia l'app su una schermata specifica per iniziare l'attività START_EXERCISE.
Figura 3. Visualizzare un widget in risposta a una query.

​

Implementare gli intent integrati e gestire i parametri di intent

Per le Azioni app, dichiari le funzionalità e gestisci i parametri degli intent integrati nel file scorciatoie.xml. Per implementare un intent integrato e gestirne segui questi passaggi:

  1. Dichiara capability con l'intent integrato scelto.
  2. Aggiungi elementi parameter nidificati per ogni campo intent integrato che vuoi aggiungere.
    1. Se utilizzi targetClass o targetPackage, mappali su Android l'intent extras con un nome a tua scelta.
    2. Se utilizzi l'URL di un link diretto, utilizza i parametri denominati nella query stringa del modello di URL.

Per gestire un parametro dell'intent integrato, mappa il parametro dell'intent integrato al parametro corrispondente di un intent Android esplicito in capability. Poi potrai utilizzare il suo valore nella tua app. L'app non è tenuta a gestire Parametri degli intent integrati. Tuttavia, prova a gestire i campi di dati contrassegnati come "Consigliati" nel riferimento all'intent integrato.

Puoi definire più completamenti di intent, ognuno con il proprio insieme di i parametri consigliati. Google seleziona l'evasione degli ordini appropriata in base ai i parametri di capacità che identifica dalla query dell'utente e da quelle dichiarate in un'intenzione.

Ad esempio, la proprietà actions.intent.START_EXERCISE intent consiglia alla tua app di gestire il parametro dell'intent integrato exercise.name, ma puoi implementare l'intent integrato nella tua app senza parametri. Potresti farlo se vuoi gestire le query degli utenti senza lo specifico nome dell'allenamento, ad esempio "Chiedi all'app Esempio di iniziare il monitoraggio dell'allenamento".

La il seguente snippet ha un fallback a un fulfillment senza parametri obbligatori Se i parametri non sono inclusi nella query dell'utente:

<?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>

L'Assistente Google fa del suo meglio per fornire le informazioni più pertinenti l'utente quando restituisce i valori dei parametri nella tua app. Ad esempio, le query degli utenti per ordinare una pizza dall'app per dispositivi mobili di Esempio non include sempre in ogni località. Per offrire un servizio migliore all'utente, l'assistente potrebbe fornire la latitudine e longitudine del ristorante di esempio più vicino all'app.

Come requisito aggiuntivo, non vuoi che la tua app esegua direttamente azione che modifica lo stato reale di un utente (ad esempio, il trasferimento denaro, effettuare un ordine o inviare un messaggio) senza prima aver confermato un'azione specifica con l'utente.

Disambiguazione

Gli argomenti trasmessi alla tua app tramite <url-parameter> o gli extra per intent potrebbero non Identificare in modo univoco l'articolo che vuoi mostrare all'utente. In questo caso, utilizzare il valore di argomento come argomento di ricerca e portare l'utente alla pagina dell'app. Possono distinguerli e scegliere l'elemento giusto.

Ad esempio, se la query di un utente è "Ordina da Ristorante di esempio" per BII ORDER_MENU_ITEM, puoi presentare all'utente un elenco di ristoranti i cui nomi corrispondono al termine "Example Restaurant".

Supporto di lingue e impostazioni internazionali

Le impostazioni internazionali supportate per sviluppo e test da ogni intent integrato di azione app sono elencate nel riferimento all'intent integrato. Alcuni intent integrati hanno diverse supporto delle impostazioni internazionali per test degli sviluppatori e per l'attivazione da parte degli utenti dall'assistente.