Intents intégrés pour les actions dans les applications

Les intents intégrés permettent à votre application d'exprimer ses capacités de traitement à Google. En déclarant les fonctionnalités dans votre fichier shortcuts.xml et en mappant les paramètres d'intent au traitement, vous permettez l'Assistant Google pour lancer votre application sur un écran spécifique en réponse à une requête, afin que l’utilisateur puisse effectuer une tâche.

Les intents intégrés sont regroupés par catégories d'applications. Chaque catégorie représente un ensemble de tâches courantes que les utilisateurs souhaitent souvent effectuer dans leurs applications. La liste complète des intents intégrés disponibles, leurs paramètres et des exemples utilisables à des fins de test, consultez la documentation de référence sur les intents intégrés.

De nombreux intents intégrés ont des exigences de déploiement spécifiques recommandations. Ces exigences et recommandations aident votre application la meilleure expérience possible pour vos utilisateurs.

Figure 1. Appeler l'intent intégré START_EXERCISE par commande vocale à l'Assistant.
Figure 2. Lancer l'application sur un écran spécifique pour commencer la tâche START_EXERCISE.
Figure 3. afficher un widget en réponse à une requête ;

​

Implémenter des intents intégrés et gérer les paramètres d'intent

Pour les actions dans les applications, vous déclarez des capacités et gérez les paramètres d'intent intégré dans le fichier shortcuts.xml. Pour implémenter un intent intégré et gérer ses , procédez comme suit:

  1. Déclarez capability avec l'intent intégré choisi.
  2. Ajoutez des éléments parameter imbriqués pour chaque champ d'intent intégré que vous souhaitez ajouter.
    1. Si vous utilisez targetClass ou targetPackage, mappez-les sur l'Android intent extras avec le nom de votre choix.
    2. Si vous utilisez une URL de lien profond, utilisez les paramètres nommés dans la requête du modèle d'URL.

Pour gérer un paramètre d'intent intégré, mappez le paramètre d'intent intégré au paramètre le paramètre correspondant d'un intent Android explicite dans votre capability. Vous pouvez ensuite utiliser sa valeur dans votre application. Votre application n'a pas besoin de gérer Paramètres d'intent intégré. Essayez toutefois de gérer les champs de données marqués comme recommandés. consultez la documentation de référence sur les intents intégrés.

Vous pouvez définir plusieurs traitements d'intent, chacun avec son propre ensemble de paramètres recommandés. Google sélectionne le traitement approprié en fonction du les paramètres de capacité qu'il identifie à partir de la requête de l'utilisateur et de ceux déclarés dans un intent.

Par exemple, actions.intent.START_EXERCISE recommande que votre application gère le paramètre d'intent intégré exercise.name, mais peut implémenter l'intent intégré dans votre application sans aucun paramètre. Cela peut vous être utile si vous souhaitez gérer les requêtes des utilisateurs sans nom de l'exercice, par exemple "Demandez à l'appli XXX de démarrer le suivi des entraînements".

La L'extrait de code suivant correspond à un traitement sans paramètre requis Si les paramètres ne sont pas inclus dans la requête de l'utilisateur:

<?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'Assistant Google s'efforce de fournir les informations les plus pertinentes à l'utilisateur lorsqu'il renvoie des valeurs de paramètre à votre application. Par exemple, les requêtes des utilisateurs pour commander une pizza dans l'application mobile d'un restaurant Exemple n'incluent pas toujours un l'emplacement. Pour mieux répondre aux besoins de l'utilisateur, l'Assistant peut fournir la latitude et la longitude du restaurant "Exemple" le plus proche de cette application.

Autre exigence supplémentaire : vous ne voulez pas que votre application effectue directement qui modifie l'état réel d'un utilisateur (par exemple, le transfert d'argent, de commande ou d'envoi d'un message) sans avoir préalablement confirmé l’action avec l’utilisateur.

Clarification

Il est possible que les arguments transmis à votre application via <url-parameter> ou les extras d'intent ne soient pas identifier de manière unique l'élément que vous souhaitez présenter à l'utilisateur. Dans ce cas, utiliser la valeur d'argument comme argument de recherche et rediriger l'utilisateur vers la page de l'application. Ils peuvent faire la distinction et choisir l'élément approprié.

Par exemple, si la requête d'un utilisateur est "Commander chez Le restaurant Exemple" pour la l'intent intégré ORDER_MENU_ITEM, vous pouvez présenter à l'utilisateur une liste restaurants dont le nom correspond au terme "Example Restaurant".

Prise en charge des langues et paramètres régionaux

Paramètres régionaux pris en charge pour le développement et les tests par chaque intent intégré d'action dans l'application sont répertoriés dans la documentation de référence sur les intents intégrés. Certains intents intégrés ont des valeurs la prise en charge des paramètres régionaux pour les tests par les développeurs et pour le déclenchement par l'utilisateur depuis l'Assistant.