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.
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:
- Dichiara l'oggetto
capability
con il BII scelto. - Aggiungi elementi
parameter
nidificati per ogni campo BII che vuoi aggiungere.- Se utilizzi
targetClass
otargetPackage
, mappale all'intent Androidextras
utilizzando un nome a tua scelta. - Se utilizzi l'URL di un link diretto, utilizza i parametri denominati nella stringa di query del modello di URL.
- Se utilizzi
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.