Le Google Home Plugin for Android Studio est conçu et créé pour les développeurs de la plate-forme Google Home. Ce plug-in 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 les secrets et les mots de passe, procédez comme suit:
- Cliquez sur Fichier, puis sur Paramètres.
- Dans la section Appearance & Behavior (Apparence et comportement), développez System Settings (Paramètres système), puis cliquez sur Passwords (Mots de passe).
- Sélectionnez Ne pas enregistrer, oublier les mots de passe après redémarrage.
Caractéristiques
Simulateur de l'Assistant
Pour vérifier si vos appareils connectés fonctionnent correctement avec l'écosystème Google Home, vous pouvez interagir avec Assistant Simulator à tout moment sans quitter Android Studio.
Semblable au simulateur de l'Assistant fourni dans la console Actions on Google Console, 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 en fonction de vos commandes, par exemple "Très bien, j'allume la lumière".
Consulter 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, Google Home Plugin affiche des messages Cloud Logging en temps réel à côté de votre code lors du dépannage.
Vous pouvez afficher les journaux en temps réel ou sélectionner une plage de dates.
Énoncés par lot
Les réponses Assistant Simulator à un seul énoncé ne sont pas déterministes. Par exemple, une réponse peut être l'une des expressions suivantes:
- OK, j'allume les deux lumières.
- OK, j'allume les deux lumières.
- OK, j'allume les deux lumières.
- D'accord, 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é. Une fois qu'un script est enregistré, vous pouvez collecter des réponses et exécuter plusieurs tests sur vos requêtes.
Lecteur Home Graph
La visionneuse Home Graph vous permet d'afficher l'état de vos appareils et de lancer la suite Google Home Test dans votre navigateur.
Visionneuse de journaux Android Debug Bridge (adb)
La visionneuse de journaux Adb est un outil permettant d'afficher et d'analyser les fichiers journaux, par exemple les fichiers journaux d'appareil Matter, les journaux Google Home et les journaux Android.
Installer
Pour installer 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) (Android Studio > Preferences (Préférences) sous macOS).
- Dans la section Plugins (Plug-ins), accédez à Marketplace et recherchez
google home
. - Installez l'outil et redémarrez Android Studio.
Vous pouvez également télécharger le plug-in directement à partir de JetBrains Marketplace.
Préparation
Une fois le plug-in installé, vous devez effectuer les étapes suivantes pour pouvoir utiliser Assistant Simulator et afficher Cloud Logging:
Se connecter avec Google
Vous pouvez vous connecter à votre compte de développeur à partir de l'écran de contrôle Google Home et autoriser Android Studio à communiquer avec les services Google en votre nom.
Cliquez sur l'onglet Google Home dans la colonne d'onglet verticale à gauche de la fenêtre Android Studio.
Sous Sign in with (Se connecter avec), cliquez sur Google pour lancer votre navigateur.
Sélectionnez le compte associé à vos appareils connectés.
Sur la page d'autorisation Se connecter avec Google, cliquez sur Autoriser.
Fermez la fenêtre du navigateur et revenez à Android Studio.
Vous devriez maintenant être connecté, avec l'option Déconnexion.
Sélectionner un projet Cloud
Une fois connecté, sélectionnez un projet dans le menu déroulant. Pour filtrer la liste de vos projets, saisissez une expression Filter (Filtre), par exemple matter
, puis appuyez sur Enter
.
La liste déroulante Project (Projet) charge les 100 premiers projets en fonction de votre filtre. Vos sélections sont conservées lorsque vous quittez Android Studio.
Pour obtenir de l'aide sur les filtres de projet, consultez la page 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 (Panneau des expressions) dans le panneau Google Home Plugin.
Il existe plusieurs façons d'envoyer des requêtes au Assistant Simulator. Ensuite, nous passerons en revue chaque option.
Saisissez des requêtes et collectez les réponses
Pour interagir avec 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
Rejouer pour réexécuter vos requêtes et vérifier vos réponses. Le panneau Utterances effectue le suivi de vos requêtes et réponses dans un cache stocké. L'option Relecture 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. Vos interactions sont converties au format JSON au format suivant:ask
: votre requête.answers
: tableau des réponses Assistant Simulator possibles.
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 (Fichier d'expressions) pour ouvrir les fichiers JSON enregistrés dans un nouvel onglet. Sous Select Path (Sélectionner un chemin d'accès), vous pouvez choisir un fichier ou un dossier. Si vous choisissez un dossier, Collect (Collecter) et Test fonctionnent sur tous les énoncés .json
fichiers de ce dossier.
Vous pouvez ouvrir plusieurs onglets pour le même fichier ou pour des fichiers différents, par exemple lights
, lights(1)
et plug
.
La barre d'état affiche le résultat de votre dernier test (le cas échéant), un point jaune ou vert pour indiquer si le fichier a été collecté, et le chemin d'accès au fichier d'énoncé .json
. Une fois que vous avez cliqué sur Collecter, Assistant Simulator exécute vos requêtes.
Vous recevez une notification lorsqu'une nouvelle réponse est collectée, et la barre d'état affiche un compteur pendant le traitement de vos requêtes.
Une fois l'opération Collect terminée, la barre d'état est mise à jour avec une coche verte devant votre chemin .json
, et vos fichiers d'énoncés sont renseignés 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 arrêtez la collecte plus tôt que prévu, votre chemin d'accès .json
ne sera pas marqué comme collecté.
Tester les énoncés par lot
Une fois que vous avez collecté vos réponses, cliquez sur Assistant Simulator attend les 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:
Test (Tester) pour relancer vos requêtes, et vérifier vos réponses et vos journaux. Lorsque vous testez des énoncés par lot,Expected one of: "Got it, turning on
2 lights."
Ce scénario indique l'échec du test. Sinon, Assistant Simulator exécutera chacune de vos requêtes et renverra une réponse. Une vérification s'affiche dans la barre d'état si le test a réussi.
Consulter 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 Requête.
Par exemple, pour filtrer les journaux en fonction du mot clé light
:
Sélectionnez 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. Vous pouvez l'activer en cliquant sur Après et Avant. Vous pouvez saisir le 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 la date, puis saisir l'heure dans le champ de texte.
- Pour choisir une date postérieure au
5/1/22
, sélectionnez Après, puis cliquez sur l'icône de date . - Pour sélectionner une date antérieure au
5/1/22
, sélectionnez Avant, puis cliquez sur l'icône de date . - Pour choisir une date comprise entre le
5/1/22
et le6/30/22
, sélectionnez Avant et Après, puis choisissez vos dates à l'aide de l'icône de date .
Sélectionnez Temps réel pour récupérer les journaux de projet en direct. Cliquez sur Stop (Arrêter) pour arrêter un flux en temps réel.
Niveau de gravité
Vous pouvez également sélectionner un niveau de gravité minimal dans le menu déroulant.
Résultats de la requête
Cliquez sur
Extraire pour envoyer vos paramètres de requête.Une fois les journaux chargés, cliquez sur un enregistrement
pour développer la charge utile JSON complète. Cliquez à nouveau sur pour afficher le message complet.Vous pouvez éventuellement saisir un mot clé dans la zone Filtrer pour affiner les résultats du journal. Cliquez sur x
pour supprimer le filtre et revenir aux résultats d'extraction d'origine.
Afficher le graphique de la page d'accueil et exécuter des tests
Pour répertorier vos appareils, sélectionnez Home Graph dans le panneau Google Home Plugin.
Cliquez sur Google Home Graph pour des projets distincts.
Actualiser pour afficher le nom de l'appareil, l'ID de l'appareil et le type d'appareil pour vos appareils associés au projet sélectionné. Vous pouvez ouvrir plusieurs panneauxUne fois vos appareils chargés, cliquez sur un enregistrement
pour développer la charge utile JSON complète.Vous pouvez également utiliser les options Développer et Réduire pour afficher et masquer les charges utiles JSON pour vos appareils.
Pour lancer la suite de tests pour un appareil spécifique, cliquez sur Test. La suite de tests est alors lancée dans votre navigateur, avec votre appareil sélectionné et prêt à être testé. Cliquez sur 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 de journal Adb, cliquez sur la commande Adb Log dans la barre d'outils du plug-in Google Home (à gauche). Vous pouvez ouvrir des onglets de journal Adb distincts pour chacun de vos fichiers journaux. Pour supprimer un onglet, cliquez sur l'icône
.Utilisez le champ Sélectionner pour sélectionner un composant de journalisation spécifique à afficher et la liste déroulante Gravité pour n'afficher que les entrées dont le niveau de gravité de journal correspond.
Pour le journal adb sélectionné, vous pouvez filtrer les entrées de journal à l'aide du champ Filter (Filtre) avec des modificateurs facultatifs sensibles à la casse ou Regex.
Vous pouvez en outre :
- Recherchez des entrées spécifiques à l'aide du champ Rechercher, et des commandes Rechercher suivant (icône ) et Rechercher le précédent (icône ).
- Utilisez les modificateurs sensibles à la casse ou Regex facultatifs.
- Aller à la ligne pour accéder directement à une ligne donnée (par numéro) dans le journal
Sélectionnez Numérotés pour afficher les lignes de journal sur lesquelles des numéros de ligne ont été ajoutés. Sélectionnez Raw pour afficher les entrées de journal brutes.
Ressources et commentaires
Cliquez sur Resources (Ressources) pour afficher la liste des outils et des ressources pour les développeurs.
Pour nous envoyer vos idées ou commentaires sur la façon dont nous pouvons améliorer l'expérience de développement avec Google Home Plugin, cliquez sur Commentaires.