Plug-in Google Home pour Android Studio

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.

Plug-in Google Home pour Android Studio

Avis de sécurité

Pour empêcher Android Studio de stocker des secrets et des mots de passe, procédez comme suit:

  1. Cliquez sur File (Fichier), puis sur Settings (Paramètres).
  2. Dans Appearance & Behavior (Apparence et comportement), développez System Settings (Paramètres système), puis cliquez sur Passwords (Mots de passe).
  3. Sélectionnez Ne pas enregistrer, oublier les mots de passe après le redémarrage.
Plug-in Google Home pour Android Studio

Fonctionnalités

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 existant 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 basés sur vos commandes (par exemple, "Très bien, j'allume la lumière").

Tester avec le simulateur de l'Assistant

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, Google Home Plugin affiche des messages Cloud Logging en temps réel juste à côté de votre code lors du dépannage.

Vous pouvez afficher des journaux en temps réel ou sélectionner une plage de dates.

Vue Cloud Logging

Déclarations par lots

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.
  • D'accord, j'allume les deux lumières.
  • OK, j'allume les deux lumières.
  • D'accord, j'allume les 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 à Assistant Simulator en exécutant des scripts d'énoncé. Une fois un script 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.

Lecteur 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 des appareils Matter, les journaux Google Home et les journaux Android.

Installer

Pour installer Google Home Plugin dans Android Studio, procédez comme suit:

  1. Téléchargez ou mettez à jour Android Studio. Télécharger Android Studio
  2. Accédez à File > Settings (Fichier > Paramètres), ou à Android Studio > Preferences (Préférences) sous macOS.
  3. Dans la section Plugins (Plug-ins), accédez à Marketplace et recherchez google home.
  4. Installez l'outil et redémarrez Android Studio.

Vous pouvez également télécharger le plug-in directement depuis JetBrains Marketplace.

Prérequis

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 Google Home et autoriser Android Studio à communiquer avec les services Google en votre nom.

  1. Cliquez sur l'onglet Google Home dans la colonne d'onglets verticale à gauche de la fenêtre Android Studio.

  2. Sous Se connecter avec, cliquez sur Google pour lancer votre navigateur.

    Google Sign-In pour Android Studio
  3. Sélectionnez le compte associé à vos appareils connectés.

  4. Sur la page d'autorisation Sign in with Google (Se connecter avec Google), cliquez sur Allow (Autoriser).

  5. Fermez la fenêtre du navigateur et revenez à Android Studio.

Vous devriez maintenant être connecté et l'option Se déconnecter s'affiche.

Sélectionner un projet Cloud

Une fois connecté, sélectionnez un projet dans le menu déroulant. Pour filtrer la liste des 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.

Sélectionner un projet

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 Assistant Simulator dans Android Studio, cliquez sur Panneau des énoncés dans le panneau Google Home Plugin.

Ouvrir le panneau des déclarations

Il existe plusieurs façons d'envoyer des requêtes à Assistant Simulator. Ensuite, nous allons passer 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 Relancer pour réexécuter vos requêtes et vérifier vos réponses. Le panneau Utterances effectue le suivi de vos requêtes et de vos réponses dans un cache stocké. La fonctionnalité Replay 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.

Relire les énoncés avec le simulateur de l'Assistant

Cliquez sur 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'écritures) 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, les options Collect et Test fonctionnent sur tous les fichiers d'énoncés .json 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é, ainsi que le chemin d'accès au fichier .json de l'énoncé. Une fois que vous avez cliqué sur Collecter, Assistant Simulator exécute vos requêtes. Vous êtes averti lorsqu'une nouvelle réponse est collectée, et la barre d'état affiche un compteur pendant le traitement de vos requêtes.

Recueillez des énoncés avec le simulateur de l'Assistant

Une fois la collecte terminée, la barre d'état se met à jour avec une coche verte devant votre chemin .json, et vos fichiers d'énoncés contiennent les réponses possibles.

Recueillez des énoncés avec le simulateur de l'Assistant
{
  "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 de manière anticipée, votre chemin .json ne sera pas marqué comme collecté.

Tester les énoncés par lot

Une fois les réponses collectées, cliquez sur Test (Tester) pour revoir vos requêtes et vérifier vos réponses et vos journaux. Lorsque vous testez les énoncés par lot, Assistant Simulator attend des réponses enregistrées dans votre fichier JSON. Si votre test renvoie une réponse qui n'a pas été collectée, vous recevez une notification semblable à la réponse suivante:

Expected one of: "Got it, turning on 2 lights."

Faites des énoncés avec le simulateur de l'Assistant

Ce scénario indique un échec de 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.

Faites des énoncés avec le simulateur de l'Assistant

Afficher Cloud Logging

Pour ouvrir un onglet de projet dans la fenêtre de l'outil Cloud Logs, cliquez sur Cloud Logging dans le panneau Google Home Plugin. Vous pouvez ouvrir des onglets Cloud Log distincts pour chacun de vos projets.

Onglets Cloud Logging

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 pour le mot clé light:

Requête Cloud Logging

Sélectionnez Use QL (Utiliser QL) pour utiliser le langage de requête Logging.

Langage de requête Cloud Logging

Voici quelques exemples de requêtes de 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 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 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 Before (Avant le) et cliquez sur l'icône de date .
  • Pour sélectionner une date comprise entre le 5/1/22 et le 6/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 du projet en direct. Cliquez sur Arrêter pour mettre fin à un flux en temps réel.

Niveau de gravité

Vous pouvez également sélectionner une Gravité minimale 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 n'importe quel enregistrement pour développer la charge utile JSON complète. Cliquez de nouveau sur pour afficher le message complet.

Vous pouvez éventuellement saisir un mot clé dans la zone Filtre pour affiner les résultats du journal. Cliquez sur x pour supprimer le filtre et revenir aux résultats de récupération d'origine.

Afficher Cloud Logging

Afficher le graphique d'accueil et exécuter les tests

Pour répertorier vos appareils, sélectionnez Home Graph (Graphique de la maison) dans le panneau Google Home Plugin.

Cliquez sur Actualiser pour afficher le nom de l'appareil, l'ID de l'appareil et le type d'appareil pour les appareils associés au projet sélectionné. Vous pouvez ouvrir plusieurs panneaux Google Home Graph pour des projets distincts.

Une fois vos appareils chargés, cliquez sur n'importe quel enregistrement pour développer la charge utile JSON complète.

Charge utile JSON pour graphique de maison

Vous pouvez également utiliser les options Développer et Réduire pour afficher et masquer les charges utiles JSON pour vos appareils.

Développer et réduire le fichier JSON du graphique d'accueil

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 Start (Démarrer) et attendez les résultats du test.

Tests d'exécution du graphique à domicile

Vous pouvez consulter les détails du test et consulter les journaux une fois les tests terminés.

Tests terminés du graphique de la page d'accueil

Lecteur 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 la liste déroulante Severity (Gravité) pour n'afficher que les entrées présentant le niveau de gravité de journal correspondant.

Pour le journal adb sélectionné, vous pouvez filtrer les entrées de journal à l'aide du champ Filtre avec les modificateurs Sensible à la casse ou Regex facultatifs.

Vous pouvez en outre effectuer l'opération suivante :

  • Recherchez des entrées spécifiques à l'aide du champ Rechercher, ainsi que des commandes Rechercher l'élément suivant (icône ) et Rechercher un élément précédent (icône ).
  • Utilisez des modificateurs facultatifs sensible à la casse ou Regex.
  • Passer à la ligne pour accéder directement à une ligne spécifique (par numéro) dans le journal.

Sélectionnez Numéroté pour afficher les lignes de journal dans lesquelles les numéros ont été ajoutés. Sélectionnez Raw (Brut) pour afficher les entrées de journal brutes.

Lecteur de journaux Adb

Ressources et commentaires

Cliquez sur Ressources pour obtenir une liste d'outils et de ressources pour les développeurs.

Pour nous faire part de vos commentaires sur la façon dont nous pourrions améliorer l'expérience de développement avec Google Home Plugin, cliquez sur Commentaires.

Envoyer des commentaires