Le Google Home Plugin for Android Studio est conçu et créé pour les développeurs de la plate-forme Google Home. Il vous donne accès à Google Assistant Simulator, à Cloud Logging et à d'autres outils pour simplifier le processus de développement de votre maison connectée.
Avis de sécurité
Pour empêcher Android Studio de stocker des secrets et des mots de passe, procédez comme suit :
- Cliquez sur File (Fichier), puis sur Settings... (Paramètres...).
- Dans Appearance & Behavior (Apparence et comportement), développez System Settings (Paramètres système), puis cliquez sur Passwords (Mots de passe).
- Sélectionnez Do not save, forget passwords after restart (Ne pas enregistrer, oublier les mots de passe après le redémarrage).
Fonctionnalités
Simulateur de l'Assistant
Pour vérifier que vos appareils connectés fonctionnent correctement avec l'écosystème Google Home, vous pouvez interagir avec Assistant Simulator à tout moment sans quitter Android Studio.
Le Assistant Simulator vous permet de contrôler facilement vos appareils en saisissant vos requêtes, par exemple, "Allume la lumière" Dans Android Studio, Assistant Simulator répond par des messages texte en fonction de vos commandes, par exemple "OK, j'allume la lumière"
Afficher Cloud Logging
Google Cloud Logging fournit des informations de débogage et des métriques clés pour vous donner des insights sur l'utilisation de votre action. Pour simplifier le développement, le Google Home Plugin affiche les messages Cloud Logging en temps réel juste à côté de votre code lors du dépannage.
Vous pouvez afficher les journaux en temps réel ou sélectionner une période.
Énoncés par lot
Assistant Simulator réponses à un seul énoncé ne sont pas déterministes. Par exemple, une réponse peut être l'une des phrases suivantes :
- OK, j'allume deux lumières.
- Bien sûr, j'allume deux lumières.
- OK, j'allume deux lumières.
- OK, j'allume deux lumières.
Pour exécuter des tests automatisés et vérifier le fonctionnement de vos intégrations Google avec ces différentes réponses, vous pouvez envoyer des énoncés par lot au Assistant Simulator en exécutant des scripts d'énoncés. Une fois un script enregistré, vous pouvez collecter des réponses et exécuter plusieurs tests sur vos requêtes.
Lecteur de graphiques Home
Le lecteur de graphiques Home vous permet d' afficher l'état de vos appareils et de lancer la suite de tests Google Home dans votre navigateur.
Visionneuse de journaux Android Debug Bridge (adb)
La visionneuse de journaux adb est un outil permettant d'afficher et d'analyser des fichiers journaux, par exemple Matter fichiers journaux d'appareils, journaux Google Home et Android journaux.
Installer
Pour installer le Google Home Plugin dans Android Studio, procédez comme suit :
- Téléchargez ou mettez à jour Android Studio. Télécharger Android Studio
- Accédez à File > Settings (Fichier > Paramètres), ou à Android Studio > Preferences (Android Studio > Préférences) sous macOS.
- Dans la section Plugins (Plug-ins), accédez à Marketplace et recherchez
google home. - Installez l'outil, puis redémarrez Android Studio.
Vous pouvez également télécharger le plug-in directement depuis le JetBrains Marketplace.
Configuration
Une fois le plug-in installé, vous devez suivre les étapes ci-dessous pour pouvoir utiliser Assistant Simulator et afficher Cloud Logging :
Se connecter avec Google
Vous pouvez vous connecter à votre compte développeur depuis le panneau Google Home, en autorisant Android Studio à communiquer avec les services Google en votre nom.
Cliquez sur l'onglet Google Home dans la colonne d'onglets verticaux située à gauche de la fenêtre Android Studio.
Pour Sign in with (Se connecter avec), cliquez sur Google pour lancer votre navigateur.
Choisissez le compte associé à vos appareils connectés.
Sur la page d'autorisation Sign in with Google (Se connecter avec Google), cliquez sur Allow (Autoriser).
Fermez la fenêtre du navigateur, puis revenez à Android Studio.
Vous devriez maintenant être connecté et avoir la possibilité de cliquer sur Sign Out (Se déconnecter).
Sélectionner un projet Cloud
Après vous être connecté, sélectionnez un Project (Projet) dans le menu déroulant. Pour filtrer la liste de vos projets, saisissez une expression de Filter (Filtre), par exemple matter, puis appuyez sur Enter (Entrée).
Le menu déroulant Project (Projet) charge les 100 premiers projets en fonction de votre Filter (Filtre). Vos sélections sont conservées lorsque vous quittez Android Studio.
Pour obtenir de l'aide sur les filtres de projet, consultez la section Paramètres de requête dans la documentation de référence Google Cloud.
Utiliser le simulateur de l'Assistant
Pour ouvrir le Assistant Simulator dans Android Studio, cliquez sur Utterances Panel dans le panneau Google Home Plugin.
Il existe plusieurs façons d'envoyer des requêtes au Assistant Simulator. Nous allons maintenant examiner chaque option.
Saisir des requêtes et collecter des réponses
Pour interagir avec le Assistant Simulator, saisissez votre requête et appuyez sur Entrée.
Vous pouvez renvoyer une requête en cliquant sur l' icône de renvoi à la fin de votre requête.
Après avoir envoyé une ou plusieurs requêtes, cliquez sur Replay pour réexécuter vos requêtes et vérifier vos réponses. Le panneau Utterances (Énoncés) suit vos requêtes et vos réponses dans un cache stocké. Replay (Rejouer) n'ajoute que de nouvelles réponses à ce cache interne et ne duplique pas vos requêtes chaque fois que vous cliquez sur le bouton.
Cliquez sur Save (Enregistrer) pour enregistrer les requêtes et les réponses que vous avez saisies dans le panneau Utterances (Énoncés). Vos interactions sont converties au format JSON comme suit :
ask: votre requête.answers: un tableau de réponses possibles Assistant Simulator.
Vous pouvez modifier ce fichier JSON dans Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Collecter des réponses par lot
Dans le panneau Google Home Plugin, cliquez sur Utterances File pour ouvrir
vos fichiers JSON enregistrés dans un nouvel onglet. Pour Select Path (Sélectionner un chemin), vous pouvez choisir un
fichier ou un dossier. Si vous choisissez un dossier, Collect (Collecter) et Test (Tester) fonctionneront sur tous les fichiers .json d'énoncés de ce dossier.
Vous pouvez ouvrir plusieurs onglets pour le même fichier ou pour différents fichiers, par exemple
lights, lights(1) et plug.
La Status Bar (Barre d'état) affiche le résultat de votre dernier test (le cas échéant), un point jaune ou vert indiquant si le fichier a été collecté, ainsi que le chemin d'accès au fichier .json de l'énoncé. Après avoir cliqué sur
Collect,
le Assistant Simulator exécute vos requêtes.
Vous recevrez une notification lorsqu'une nouvelle réponse sera collectée, et la Status Bar (Barre d'état) affichera un compteur pendant le traitement de vos requêtes.
Une fois la Collect (Collecte) terminée, la Status Bar (Barre d'état) affiche une coche verte devant votre chemin .json, et vos fichiers d'énoncés sont remplis avec les réponses possibles.
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Si vous Stop (Arrêtez) la collecte plus tôt, votre chemin .json ne sera pas marqué comme collecté.
Tester des énoncés par lot
Une fois vos réponses collectées, cliquez sur Test pour rejouer vos requêtes et vérifier vos réponses et vos journaux. Lorsque vous testez des énoncés par lot, le Assistant Simulator s'attend aux réponses enregistrées dans votre fichier JSON. Si votre test renvoie une réponse qui n'a pas été collectée, vous recevrez une notification semblable à la réponse suivante :
Expected one of: "Got it, turning on
2 lights."
Ce scénario indique un test infructueux. Sinon, le Assistant Simulator exécutera chacune de vos requêtes et renverra une réponse. Une coche s'affiche dans la Status Bar (Barre d'état) si le test a réussi.
Afficher Cloud Logging
Pour ouvrir un onglet de projet dans la fenêtre de l'outil Cloud Logs, cliquez sur Cloud Logs dans le panneau Google Home Plugin. Vous pouvez ouvrir des onglets Cloud Log distincts pour chacun de vos projets.
Termes de requête
Pour le projet sélectionné, vous pouvez également filtrer les journaux à l'aide du champ Query (Requête).
Par exemple, pour filtrer les journaux d'un mot clé light :
Sélectionnez Use QL (Utiliser QL) pour utiliser le langage de requête Logging.
Voici quelques exemples de requêtes QL pour vous aider à démarrer :
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Requêtes de date et d'heure
L'interrogation des journaux par date est également facultative et peut être activée en cliquant sur After (Après) et Before (Avant). Vous pouvez saisir votre format de date et d'heure dans le champ de texte
fourni, par exemple 5/11/22, 12:37 PM, ou utiliser les sélecteurs de date
pour sélectionner votre date, puis saisir l'heure dans le champ de texte.
- Pour sélectionner une date après le
5/1/22, sélectionnez After (Après) et cliquez sur l'icône de date . - Pour sélectionner une date avant le
5/1/22, sélectionnez Before (Avant) et cliquez sur l'icône de date . - Pour sélectionner une date comprise entre
5/1/22et6/30/22, sélectionnez Before (Avant) et After (Après), puis choisissez vos dates à partir de l'icône de date .
Sélectionnez Real time (Temps réel) pour récupérer les journaux de projet en direct. Cliquez sur Stop (Arrêter) pour mettre fin à un flux en temps réel.
Niveau de gravité
Vous pouvez également sélectionner une Minimal Severity (Gravité minimale) dans le menu déroulant.
Résultats de la requête
Cliquez sur Fetch pour envoyer vos paramètres de requête.
Une fois les journaux chargés, cliquez sur n'importe quel enregistrement pour développer la charge utile JSON complète. Cliquez à nouveau sur pour afficher le message complet.
Vous pouvez également saisir un mot clé dans la zone Filter (Filtre) pour affiner les résultats de votre journal. Cliquez sur le x pour supprimer votre filtre et revenir aux résultats de récupération d'origine.
Afficher le graphique Home et exécuter des tests
Pour afficher la liste de vos appareils, sélectionnez Home Graph dans le panneau Google Home Plugin.
Cliquez sur Refresh (Actualiser) mis en cache pour afficher le Device name (Nom de l'appareil), l'Device id (ID de l'appareil) et le Device type (Type d'appareil) pour vos appareils associés au projet sélectionné. Vous pouvez ouvrir plusieurs Google Home Graph panneaux pour différents projets.
Une fois vos appareils chargés, cliquez sur n'importe quel enregistrement pour développer la charge utile JSON complète.
Vous pouvez également utiliser Expand (Développer) et Collapse (Réduire) pour afficher et masquer les charges utiles JSON de vos appareils.
Pour lancer la suite de tests d'un appareil spécifique, cliquez sur Test. La suite de tests s'ouvre alors dans votre navigateur avec votre appareil sélectionné et prêt à être testé. Cliquez sur Start (Démarrer) et attendez les résultats du test.
Vous pouvez consulter les détails du test et afficher les journaux une fois les tests terminés.
Visionneuse de journaux Android Debug Bridge (adb)
Pour ouvrir un onglet de projet dans la fenêtre de l'outil Adb Log, cliquez sur la commande Adb Log dans la barre d'outils du plug-in Google Home (à gauche). Vous pouvez ouvrir des onglets Adb Log distincts pour chacun de vos fichiers journaux. Pour supprimer un onglet, cliquez sur l' icône.
Utilisez le champ Select (Sélectionner) pour sélectionner un composant de journalisation spécifique à afficher, et le menu déroulant Severity (Gravité) pour n'afficher que les entrées dont la gravité du journal correspond.
Pour le journal adb sélectionné, vous pouvez filtrer les entrées de journal à l'aide du champ Filter (Filtre) avec les modificateurs facultatifs Case-sensitive (Sensible à la casse) ou Regex (Expression régulière).
Vous pouvez en outre :
- Rechercher des entrées spécifiques à l'aide du champ Find et des commandes Find Next (icône ) et Find Previous (icône ).
- Utiliser les modificateurs facultatifs Case-sensitive (Sensible à la casse) ou Regex (Expression régulière).
- Jump to line (Accéder à la ligne) pour accéder à une ligne spécifiée (par numéro) dans le journal.
Sélectionnez Numbered (Numéroté) pour afficher les lignes de journal avec des numéros de ligne ajoutés. Sélectionnez Raw (Brut) pour afficher les entrées de journal brutes.
Ressources et commentaires
Cliquez sur Resources (Ressources) pour obtenir la liste des outils et ressources pour les développeurs.
Pour nous faire part de vos réflexions ou de vos commentaires sur la façon dont nous pouvons améliorer l'expérience de développement avec le Google Home Plugin, cliquez sur Feedback (Commentaires).
