Intent integrati per Azioni app

Gli intent integrati (BII) consentono alla tua app di esprimere le sue funzionalità di fulfillment a Google. Dichiarando le funzionalità nel file shortcuts.xml e mappando i parametri degli intent al fulfillment, consenti all'Assistente Google di avviare l'app in una schermata specifica in risposta a una query, in modo che l'utente possa 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 desiderano spesso eseguire nelle proprie app. L'elenco completo dei BII disponibili, dei relativi parametri e delle query di esempio utilizzabili per i test è disponibile nel riferimento per intent integrato.

Molti BII hanno requisiti e suggerimenti di deployment specifici. Questi requisiti e consigli aiutano la tua app a offrire la migliore esperienza possibile agli utenti.

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

Implementa BII e gestisci i parametri di intent

Per Azioni app, devi dichiarare le funzionalità e gestire i parametri BII nel file shortcuts.xml. Per implementare uno BII e gestirne i parametri, segui questi passaggi:

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

Per gestire un parametro BII, mappa il parametro BII al parametro corrispondente di un intent Android esplicito in capability. Successivamente, puoi utilizzare il relativo valore nella tua app. L'app non è tenuta a gestire i parametri BII. Tuttavia, prova a gestire i campi di dati contrassegnati come "Consigliato" nel riferimento per l'intent integrato.

Puoi definire più fulfillment di intent, ciascuno con il proprio set di parametri consigliati. Google seleziona il fulfillment appropriato in base ai parametri di capacità identificati nella query dell'utente e a quelli dichiarati in un intent.

Ad esempio, l'intent actions.intent.START_EXERCISE consiglia alla tua app di gestire il parametro BII exercise.name, ma puoi implementare BII nell'app senza parametri. Puoi farlo se vuoi gestire le query degli utenti senza il nome specifico dell'allenamento, ad esempio "Chiedi all'app di esempio di iniziare a monitorare l'allenamento".

Lo snippet seguente ha un fallback per 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 all'utente le informazioni più pertinenti quando restituisce i valori parametro alla tua app. Ad esempio, le query degli utenti relative a ordinare una pizza dall'app per dispositivi mobili di ristorante di esempio non sempre includono una località. Per offrire un servizio migliore all'utente, l'assistente potrebbe fornire i valori di latitudine e longitudine del ristorante Esempio più vicino all'app.

Come requisito aggiuntivo, è opportuno impedire all'app di eseguire direttamente un'azione che modifichi lo stato reale di un utente (ad esempio trasferimento di denaro, effettuare un ordine o inviare un messaggio) senza prima aver confermato l'azione con l'utente.

Disambiguazione

Gli argomenti trasmessi alla tua app tramite <url-parameter> o extra intent potrebbero non identificare in modo univoco l'elemento che vuoi mostrare all'utente. In questo caso, utilizza il valore dell'argomento come argomento di ricerca e indirizza l'utente alla pagina di ricerca dell'app. Può effettuare una distinzione 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 lo sviluppo e i test da ogni BII di un'azione app sono elencate nel riferimento per l'intent integrato. Alcune BII supportano diverse aree geografiche per i test degli sviluppatori e per l'attivazione da parte dell'utente dall'assistente.