Présentation des actions dans l'application avec Actions.xml (obsolète)

Les actions dans l'application permettent aux utilisateurs de lancer des fonctionnalités spécifiques dans votre application à l'aide de l'Assistant Google. Si vous activez cette fonctionnalité pour étendre votre application, les utilisateurs peuvent facilement accéder à votre application via des liens profonds en énonçant une simple requête à l'Assistant. Si l'utilisateur a déjà installé votre application, l'Assistant déclenche un lien profond lorsque l'utilisateur prononce une expression d'appel qui inclut le nom de votre application, par exemple Hey Google, commande une pizza chez SuperPizzeria.

Pour activer les actions dans l'application, vous devez ajouter à votre projet d'application Android un fichier actions.xml qui indique à Google les intents intégrés compatibles avec votre application. Pour certains cas d'utilisation, vous pouvez également créer des segments d'application Android et les associer à votre fichier actions.xml.

Les actions dans l'application sont compatibles avec Android 5 (niveau d'API 21) ou version ultérieure. Les utilisateurs ne peuvent accéder aux actions dans l'application que sur les téléphones Android. L'Assistant sur Android Go n'est pas compatible avec cette fonctionnalité.

Cas d'utilisation

Les actions dans l'application sont idéales pour étendre les fonctionnalités de votre application Android via l'Assistant Google :

  • Lien profond vers une fonctionnalité de l'application via l'Assistant : connectez les liens profonds existants aux requêtes utilisateur sur la base de schémas prédéfinis.
  • Affichage des informations de votre application directement dans l'Assistant : fournissez aux utilisateurs des réponses intégrées et des confirmations simples sans qu'ils aient à changer de contexte.

Fonctionnement des actions dans l'application

Du point de vue de l'utilisateur, les actions dans l'application se comportent comme des raccourcis vers certaines parties de votre application Android. Lorsqu'un utilisateur appelle une action dans l'application, l'Assistant associe sa requête à un intent intégré enregistré et au traitement correspondant. Cette correspondance est basée sur les informations que vous avez fournies dans le fichier actions.xml de l'application.

Lorsque la requête d'un utilisateur correspond au schéma prédéfini d'un intent intégré, l'Assistant extrait les paramètres de requête dans les entités schema.org et génère un lien profond Android avec les mappages trouvés dans actions.xml.

Actions on Google utilise ensuite l'URL du lien profond, préremplie avec les paramètres fournis par l'utilisateur, pour rediriger l'utilisateur directement vers un contenu spécifique de votre application Android, sans boîte de dialogue supplémentaire. Pour les intents intégrés utilisant un traitement de segment d'application Android, l'Assistant répond directement à l'utilisateur avec les informations demandées.

Lorsqu'un utilisateur envoie une requête à l'Assistant Google, la réponse est renvoyée sous la forme d'un lien profond dans l'application ou d'un segment d'application Android.
Figure 3. Exemple de flux de requêtes utilisateur dans les actions dans l'application

Par exemple, un utilisateur appelle une action dans l'application en disant "Hey Google, demande un taxi pour l'aéroport de Nantes avec l'appli SuperTaxi". L'Assistant associe la requête utilisateur à l'intent intégré actions.intent.CREATE_TAXI_RESERVATION et extrait "aéroport de Nantes" en tant que paramètre d'intent correspondant à une entité schema.org spécifiée dans actions.xml. L'Assistant transmet le paramètre d'intent au traitement défini pour cet intent intégré, puis redirige l'utilisateur vers l'application via un lien profond avec le champ "aéroport de Nantes" prérempli.

Les actions dans l'application utilisent des liens profonds Android que vous avez déjà implémentés dans votre application pour rediriger les utilisateurs vers celle-ci à partir de l'Assistant. Nous vous recommandons également de prendre en charge les liens vers une application, qui associent numériquement des URL HTTP/HTTPS à vos applications et sites Web.

Créer des actions dans l'application

Les actions dans l'application s'appuient sur les fonctionnalités existantes de votre application Android, et le processus est similaire pour chaque action dans l'application que vous implémentez. Elles redirigent les utilisateurs directement vers un contenu spécifique de votre application à l'aide d'un lien profond Android, que vous spécifiez à l'aide de filtres d'intent dans le fichier manifeste de l'application Android.

Lorsque vous créez une action dans l'application, la première étape consiste à identifier l'activité à laquelle les utilisateurs peuvent accéder depuis l'Assistant. Ensuite, à l'aide de ces informations, recherchez l'intent intégré le plus proche à partir de la documentation de référence sur les intents intégrés pour les actions dans l'application.

Les intents intégrés permettent de modéliser certaines des requêtes les plus courantes formulées par les utilisateurs quand ils veulent effectuer des tâches ou obtenir des informations. Par exemple, les intents intégrés permettent d'effectuer des actions telles que commander un repas, réserver un trajet et consulter le solde d'un compte.

Une fois que vous avez identifié la fonctionnalité et l'intent intégré à mettre en œuvre, vous pouvez créer une ressource actions.xml dans votre application Android qui mappera cet intent à la fonctionnalité correspondante dans votre application. Les actions dans l'application définies dans actions.xml décrivent comment chaque intent intégré résout son traitement, ainsi que les paramètres extraits et fournis à votre application.

Une partie importante du développement d'actions dans l'application consiste à mapper les paramètres d'intent intégrés aux paramètres du traitement que vous avez défini. Ce processus prend généralement la forme d'entités schema.org liées à la fonctionnalité de votre application. Vous pouvez aussi créer un inventaire d'identifiants pour votre intent intégré.

Tester les actions dans l'application

Au cours du développement et des tests, vous utiliserez l'outil de test des actions dans l'application pour créer un aperçu des actions dans votre application avec l'Assistant (pour votre compte Google). L'outil de test des actions dans l'application est un plug-in Android Studio qui vous aide à tester la manière dont l'action dans votre application gère différents paramètres avant de l'envoyer pour le déploiement. Une fois que vous avez généré un aperçu de l'action dans votre application dans l'outil de test, vous pouvez déclencher une action sur votre appareil de test directement depuis la fenêtre de l'outil de test.

Étapes suivantes

Suivez l'atelier de programmation Intégrer l'Assistant Google dans une application Android grâce aux actions dans l'application pour essayer de créer une action dans l'application à l'aide de notre exemple d'application Android.

Vous pouvez ensuite consulter nos guides pour créer des actions pour votre propre application. Vous pouvez également explorer ces ressources supplémentaires pour créer des actions dans l'application :