Le Azioni app consentono agli utenti di avviare funzionalità nella tua app per Android chiedendo all'Assistente Google o usando le scorciatoie Android suggerite dall'assistente. Di seguito sono riportati i passaggi principali per estendere la tua app per Android con Azioni app:
- Identifica la funzionalità in-app da attivare e il relativo intent integrato corrispondente.
- Fornisci i dettagli di completamento per l'intent integrato.
- Trasferisci le scorciatoie per la tua Azione app all'assistente.
- Visualizza l'anteprima delle Azioni app su un dispositivo di test.
- Crea una release di test della tua app.
- Richiedi la revisione e il deployment delle Azioni app.
Se vuoi, puoi definire scorciatoie dinamiche da fornire all'assistente in modo che possa suggerirle agli utenti. Crea un'Azione app con un'app di esempio seguendo il codelab sulle Azioni app.
Requisiti
Prima di iniziare a sviluppare Azioni app, assicurati che tu e la tua app soddisfiate i seguenti requisiti:
- Devi disporre di un Account Google con accesso a Google Play Console
- L'app deve essere pubblicata nel Google Play Store, perché le Azioni app sono disponibili solo per le app pubblicate su questo servizio. Assicurati inoltre che la tua app sia Non è previsto l'utilizzo in un profilo di lavoro, poiché le Azioni app non sono supportate dalla versione gestita di Google Play.
- È necessario un dispositivo fisico o virtuale su cui testare le Azioni app.
- Devi avere l'ultima versione di Android Studio.
- Devi usare lo stesso Account Google per accedere ad Android Studio, l'app Google sul dispositivo di test e Google Play Console.
- Devi configurare l'assistente sul tuo dispositivo di test e testarlo toccando e tenendo premuto sul pulsante Home.
Abbinare gli intent integrati alle funzionalità dell'app
Identifica la funzionalità della tua app per Android a cui gli utenti potrebbero voler passare con una richiesta vocale ed esamina il riferimento dell'intent integrato per trovare gli intent integrati appropriati per i tuoi casi d'uso. Gli intent integrati eseguono query degli utenti per le attività che vogliono eseguire, quindi cerca quelli che corrispondono ai flussi di funzionalità chiave e ai flussi utente nella tua app.
Esistono BII comuni che quasi tutte le app per Android, come l'estensione
la ricerca in-app all'assistente tramite il actions.intent.GET_THING
BII o consentire agli utenti di avviare funzionalità dell'app specifiche con i comandi vocali
che implementa l'intent integrato actions.intent.OPEN_APP_FEATURE
.
Esistono anche intent integrati che abilitano casi d'uso di tipo verticale o specifici per categoria. Per
Ad esempio, un'app di allenamento potrebbe usare actions.intent.START_EXERCISE
intent integrato.
Per garantire un'esperienza utente ottimale ed evitare possibili ritardi nelle approvazioni, assicurati che ogni intent integrato implementato sia pertinente alla funzionalità in-app.
Le Azioni app avviano gli intent Android dall'app dell'assistente per indirizzare
gli utenti direttamente a contenuti specifici della tua app. Puoi definire gli intent per
avviare un'attività in modo esplicito specificando i campi targetClass
e
targetPackage
. Se la tua app implementa già gli URL dei link diretti Android,
puoi configurare l'intent in modo da utilizzare un link diretto per
il completamento. Per maggiori dettagli, consulta la sezione Testare i link diretti
della tua attività.
Fornire i dettagli di completamento per gli intent integrati
La maggior parte della creazione di un'Azione app consiste nel dichiarare una funzionalità nel
file di risorse shortcuts.xml
dell'app per Android, in cui specifichi
l'intent integrato selezionato e il relativo completamento. Un intent integrato modella la
query dell'utente per un'attività e un intent di completamento fornisce all'assistente
informazioni su come eseguire l'attività.
Nel file shortcuts.xml
, gli intent di completamento sono rappresentati come elementi
<capability>
e ogni completamento è rappresentato come un elemento <intent>
:
<shortcuts>
<capability android:name="actions.intent.START_EXERCISE">
<intent
android:action="android.intent.action.VIEW"
android:targetPackage="com.example.app"
android:targetClass="com.example.app.browse">
<parameter
android:name="exercise.name"
android:key="exercise_name">
</parameter>
</intent>
</capability>
Per la maggior parte degli intent integrati, i parametri di intent vengono estratti dalla query dell'utente
in base alle entità schema.org. L'app utilizza questi intent integrati
per indirizzare gli utenti alla funzionalità selezionata. Ad esempio,
precedente
il codice mappa il parametro dell'intent integrato exercise.name
all'Android exercise_name
intent
.
Se completi azioni utilizzando i link diretti, utilizza il campo urlTemplate
per definire l'URL dei link diretti generati dall'assistente:
<shortcuts>
<capability android:name="actions.intent.START_EXERCISE">
<intent android:action="android.intent.action.VIEW">
<url-template android:value="myexerciseapp://start{?exercise_name}" />
<parameter android:name="exercise.name"
android:key="exercise_name"
android:mimeType="text/*">
</parameter>
</intent>
</capability>
</shortcuts>
Per dettagli importanti sull'aggiunta di Azioni app al file shortcuts.xml
,
fai riferimento a Creare shortcuts.xml
. La pagina descrive
anche come specificare i valori parametro previsti dalla tua app.
Implementare l'intent integrato GET_THING
Se l'app ha una funzione di ricerca, devi implementare l'intent integrato
actions.intent.GET_THING
per quella funzionalità. L'assistente potrà quindi inoltrare
gli utenti alla funzione di ricerca della tua app per i risultati in-app quando effettuano query
come "Hey Google, cerca Esempio nell'app Esempio".
Nel file shortcuts.xml
, implementa <capability>
per
l'intent integrato actions.intent.GET_THING
mentre
implementi qualsiasi altro intent integrato. Puoi utilizzare più completamenti per GET_THING
,
purché tu ne fornisca almeno uno che trasmette la query
dell'utente alla funzione di ricerca dell'app.
Ecco un esempio di aggiunta dell'intent integrato actions.intent.GET_THING
in
shortcuts.xml
:
<capability android:name="actions.intent.GET_THING">
<intent
android:targetPackage="com.example.myapp"
android:targetClass="com.example.myapp.MySearchActivity">
<parameter android:name="thing.name" android:key="query" />
</intent>
</capability>
Nella ricerca Activity
, estrai la query di ricerca dai dati aggiuntivi di
intent
e trasmettila alla funzione di ricerca della tua app. Nel codice precedente, la
query di ricerca, passata come chiave query
, viene mappata al parametro dell'intent integrato
"thing.name"
. Poi, esegui una ricerca con la query e visualizza i risultati
nell'interfaccia utente.
(Facoltativo) Trasferire le scorciatoie per la tua Azione app all'assistente
Dopo aver definito una funzionalità per l'azione, gli utenti possono avviare l'azione dicendo ad esempio "Hey Google, ordina una pizza sull'app Esempio". L'assistente può suggerire scorciatoie Android per le tue azioni agli utenti al momento giusto, consentendo loro di scoprire e riprodurre le tue azioni. L'assistente può suggerire scorciatoie sia dinamiche sia statiche.
Per trasferire le scorciatoie dinamiche all'assistente, utilizza la libreria Google Shortcuts Integration. Questa libreria Jetpack consente all'assistente di acquisire le tue scorciatoie e suggerirle agli utenti al momento opportuno.
Per maggiori dettagli, vedi Trasferire le scorciatoie dinamiche all'assistente.
Visualizzare l'anteprima delle Azioni app
Durante lo sviluppo e il test, utilizza plug-in dell'Assistente Google per Android Studio per testarlo Le Azioni app funzionano per la tua app. Il plug-in crea un'anteprima delle Azioni app nell'assistente per il tuo Account Google. Utilizzando lo strumento di test, puoi testare i tuoi completamenti su un emulatore o un dispositivo di test fisico fornendo agli intent integrati i parametri di input che ti aspetti di ricevere dagli utenti.
Mentre visualizzi l'anteprima delle Azioni app, puoi attivare le query tramite comandi vocali sul dispositivo. Questa funzionalità è disponibile solo per le query elencate nel riferimento degli intent integrati per le Azioni app. Utilizza l'attivazione vocale solo a scopo dimostrativo, non per test regolari.
Testa la tua app in modalità bozza utilizzando gli strumenti per sviluppatori di Google Play Console prima di inviarla per la revisione. Per maggiori informazioni sull'utilizzo di Google Play Console per il deployment di una bozza dell'app, consulta l'articolo Preparare e avviare un di IA generativa.
Creare una release di test
Quando è tutto pronto per testare le Azioni app con altri tester, crea una release di test interno o chiuso dell'app. Per impostazione predefinita, i tester delle release dei test interni e chiusi possono accedere ad Azioni app che sono già state esaminate e approvate.
Per concedere l'accesso ai test per tutte le Azioni app, incluse quelle non approvate, chiedi ai tester di partecipare al gruppo Google App Actions Development Program. I membri di questo gruppo hanno accesso a tutte le Azioni app nelle release di test chiusi e interni senza dover creare anteprime con lo strumento di test delle Azioni app. Potrebbero essere necessarie fino a 3 ore dall'iscrizione al gruppo prima che l'accesso diventi disponibile.
Richiedere la revisione e il deployment delle Azioni app
Le Azioni app non sono disponibili per gli utenti delle app pubblicate o del test aperto
fino a quando non vengono esaminate e approvate. La revisione delle Azioni app non
influiscono sullo stato di revisione e implementazione della tua app per Android in Google Play. Anche se l'app inviata viene approvata e pubblicata sul Play Store, shortcuts.xml
potrebbe essere in corso di revisione da parte di Google. Le Azioni app non funzionano per
fino all'approvazione della revisione.
Quando esegui il deployment dell'app, le Azioni app rimangono attive. Tuttavia, le versioni di cui è stato eseguito nuovamente il deployment sono soggette a revisione da parte di Google. Se la nuova versione è non funziona correttamente o contiene violazioni delle norme, Google ha il diritto di disattivare le Azioni app per l'app.
Per inviare le Azioni app per la revisione, procedi nel seguente modo:
Accetta i Termini di servizio di App Actions in Google Play Console (Impostazioni avanzate > App Actions):
Carica la tua app, contenente
shortcuts.xml
, in Google Play Console come di consueto per la pubblicazione.Dopo aver caricato la tua app in Play Console, Google ti contatta all'indirizzo email del tuo account Play Console per fornirti ulteriori informazioni sullo stato della revisione delle Azioni app. Puoi anche contattare l'assistenza per gli sviluppatori dell'assistente con domande sullo stato di revisione delle Azioni app. Nel modulo di contatto, fornisci l'ID pacchetto dell'app e scegli Revisione Azioni app nella casella di selezione Come possiamo aiutarti?.
(Facoltativo) Testare i link diretti delle attività
Per utilizzare un link diretto per avviare Activity
con un'Azione app il valore Activity
deve essere configurato con URL di link diretto e avere un filtro per intent corrispondente nel
file manifest dell'app per Android.
Per verificare che le attività siano accessibili e possano essere attivate utilizzando
le Azioni app mediante link diretti, esegui questo comando adb
:
$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"
Ad esempio:
$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"
Se l'attività non viene avviata correttamente con il comando adb
,
verifica quanto segue:
- Nel file manifest dell'app, l'attività ha
android:exported=true
, quindi può essere avviata utilizzando gli intent dell'Assistente Google. - Se utilizzi gli URL dei link alle app, segui tutti i passaggi descritti in Gestire Link per app Android.
Norme relative alle Azioni app
Le Azioni app devono rispettare norme specifiche per garantire che gli utenti che le attivano ricevano l'esperienza prevista. Leggi queste norme prima di inviare le tue app per offrire la migliore esperienza utente ed evitare ritardi o rifiuti nella revisione del Play Store.
Indirizzare gli utenti a contenuti pensati per loro
Gli intent integrati e/o i parametri delle Azioni app devono indirizzare gli utenti solo all'azione pertinente e pensata per loro. Questi contenuti possono includere contenuti in-app, contenuti di siti web o informazioni mostrate in sezioni o widget, purché l'esperienza sia dedicata all'utente.
Ad esempio, le implementazioni dell'intent integrato
START_EXERCISE
aiutano gli utenti avviano un determinato tipo di allenamento, come la corsa o il nuoto. L'unica eccezione a questa norma è quando l'intent integratoOPEN_APP_FEATURE
indirizza gli utenti alla schermata Home dell'app.Implementare intent integrati di Azioni app pertinenti
Gli intent integrati implementati devono essere direttamente correlati ai contenuti dell'app e funzionalità.
Ad esempio, se l'app è nella categoria Comunicazioni del Play Store, non implementano l'intent integrato
START_EXERCISE
, che consigliato per le app nella categoria Heath e Fitness.Implementare intent personalizzati pertinenti
Le query definite per gli intent personalizzati riguardano i contenuti dell'app e funzionalità. Un esempio di potenziale violazione di questa norma è la creazione dell'intent
custom.action.intent.GET_RECIPE
con il pattern di query associato "Mostrami ricette per burrito" per un'app nella categoria Trasporti del Play Store.