Plug-in Google Home pour Android Studio

L'Google Home Plugin for Android Studio est conçue et créée pour Google Développeurs de la plate-forme Home. Ce plug-in vous donne accès à Google Assistant Simulator, Cloud Logging et d'autres outils pour simplifier de développement de la maison connectée.

Plug-in Google Home pour Android Studio

Avis de sécurité

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

  1. Cliquez sur Fichier, puis sur Paramètres.
  2. Dans Apparence et Comportement, développez Paramètres système, puis cliquez sur Mots de passe :
  3. Sélectionnez Ne pas enregistrer, oublier les mots de passe après 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 Google Home écosystème, vous pouvez interagir avec Assistant Simulator à tout moment, sans quittant Android Studio.

Semblable à l'Assistant existant Simulateur fourni dans la console Actions on Google Console, Assistant Simulator vous permet pour contrôler facilement vos appareils en saisissant vos requêtes, par exemple "Allume la lumière" Dans Android Studio, Assistant Simulator répond par SMS en fonction des telles que "Très bien, allume la lumière".

Tester avec le simulateur de l'Assistant

Consulter Cloud Logging

Google Cloud Logging fournit des informations de débogage et des métriques clés pour vous aider à mieux comprendre Utilisation de l'action. Pour simplifier le développement, Google Home Plugin affiche des messages Cloud Logging en temps réel juste à côté de votre code pendant le dépannage.

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

Vue Cloud Logging

Énoncés par lot

Les réponses Assistant Simulator à un seul énoncé ne sont pas déterministe. 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 ces différentes réponses, vous pouvez envoyer des énoncés par lot Assistant Simulator en exécutant des scripts d'énoncés. 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 de : afficher l'état de vos appareils et lancer le Google Home Test Suite 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 Matter fichiers journaux d'appareil, journaux Google Home et Android journaux.

Installer

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

  1. Téléchargez ou mettez à jour Android Studio. <ph type="x-smartling-placeholder"> Télécharger Android Studio
  2. Accédez à Fichier > Paramètres (Android Studio > 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 à partir de JetBrains Marketplace.

Configuration

Une fois le plug-in installé, vous devez effectuez les étapes suivantes avant de pouvoir utiliser Assistant Simulator et affichez Cloud Logging:

Se connecter avec Google

Vous pouvez vous connecter à votre compte de développeur depuis l'écran de contrôle de la maison Google, autorisant Android Studio à communiquer avec Google en votre nom.

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

  2. Sous Sign in with (Se connecter avec), cliquez sur Google pour lancer votre navigateur.

    Connexion à Google dans Android Studio
  3. Sélectionnez le compte associé à vos appareils connectés.

  4. Sur la page d'autorisation Se connecter avec Google, cliquez sur Autoriser.

  5. 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 vos liste de projets, saisissez une expression de filtre, par exemple matter, puis appuyez sur Enter

La liste déroulante Projet charge les 100 premiers projets en fonction de votre Filtrer : 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 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 Utterances Panel (Panneau des expressions) dans le panneau Google Home Plugin.

Ouvrir le panneau des énoncés

Il existe plusieurs façons d'envoyer des requêtes au Assistant Simulator. Ensuite, nous examinerons 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 Icône de renvoi à la fin de votre requête.

Après avoir soumis une ou plusieurs requêtes, cliquez sur Rejouer pour relancer votre requêtes et vérifier vos réponses. Le panneau Énoncés vous permet de suivre vos des requêtes et des réponses dans un cache stocké. L'option Revoir permet uniquement d'ajouter de nouvelles réponses aux ce cache interne, et ne duplique pas vos requêtes chaque fois que vous cliquez .

Rejouer les énoncés avec le simulateur de l&#39;Assistant

Cliquez sur Enregistrer pour enregistrer les requêtes et les réponses que vous avez saisies dans Panneau Utterances Vos interactions sont converties au format JSON dans les format:

  • ask: votre requête.
  • answers: tableau de 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 Fichier d'expressions pour l'ouvrir. vos fichiers JSON enregistrés dans un nouvel onglet. Pour Select Path (Sélectionner un trajet), vous pouvez choisir une un fichier ou un dossier. Si vous choisissez un dossier, les commandes Collecter et Tester travailler sur tous les fichiers .json d'énoncés 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 chemin d'accès au fichier .json de l'énoncé. Après avoir cliqué sur Collections 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.

Recueillez des énoncés avec le simulateur de l&#39;Assistant

Une fois l'opération Collecte terminée, la barre d'état est mise à jour et une coche verte s'affiche. devant votre chemin d'accès .json, et vos fichiers d'énoncés sont renseignés avec réponses possibles.

<ph type="x-smartling-placeholder">
</ph> Recueillez des énoncés avec le simulateur de l&#39;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 plus tôt que prévu, votre chemin .json ne sera pas marqué comme collectées.

Tester les énoncés par lot

Une fois que vous avez collecté vos réponses, cliquez sur Testez pour répéter vos requêtes et vérifierez vos réponses et vos journaux. Lorsque vous testez des é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 recevrez une notification semblable à la réponse suivante:

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

Exécuter des énoncés avec le simulateur de l&#39;Assistant

Ce scénario indique l'échec du test. Dans le cas contraire, Assistant Simulator exécutera chacune de vos requêtes et renverra une réponse. Une coche s'affiche dans Barre d'état si le test a réussi.

<ph type="x-smartling-placeholder">
</ph> Exécuter des énoncés avec le simulateur de l&#39;Assistant

Consulter Cloud Logging

Pour ouvrir un onglet de projet dans la fenêtre de l'outil Cloud Logs, cliquez sur Cloud Logs. à partir du panneau Google Home Plugin. Vous pouvez ouvrir des onglets Cloud Logging 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 en fonction du mot clé light:

Requête Cloud Logging

Sélectionnez Utiliser QL pour utiliser Langage de requête Logging

Langage de requête Cloud 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. Pour l'activer, cliquez sur Après et Avant. Vous pouvez saisir le format de la date et de l'heure champ fourni (par exemple, 5/11/22, 12:37 PM), ou vous pouvez utiliser les sélecteurs de date pour sélectionner la date, puis saisissez l'heure dans le champ de texte.

  • Pour choisir une date postérieure au 5/1/22, sélectionnez Après et cliquez sur l'icône de date
  • Pour sélectionner une date antérieure au 5/1/22, sélectionnez Avant, puis cliquez sur la date l'icône .
  • Pour sélectionner une date comprise entre le 5/1/22 et le 6/30/22, sélectionnez Avant et Après, puis sélectionnez 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 Arrêter pour mettre fin à 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 Récupérer pour envoyer. vos paramètres de requête.

Une fois les journaux chargés, cliquez sur n'importe quel enregistrement pour développer JSON. Cliquez à nouveau sur pour afficher l'intégralité du message.

Si vous le souhaitez, vous pouvez saisir un mot clé dans la zone Filtrer pour affiner les résultats du journal. résultats. Cliquez sur x pour supprimer le filtre et revenir au filtre d'origine. récupérer les résultats.

Consulter Cloud Logging

Afficher le graphique de la page d'accueil et exécuter des tests

Pour répertorier vos appareils, sélectionnez Home Graph dans le menu Panneau Google Home Plugin.

Cliquez sur Actualiser pour afficher Nom de l'appareil, ID de l'appareil et Type d'appareil pour vos appareils. associées au projet sélectionné. Vous pouvez avoir plusieurs Les panneaux Google Home Graph s'ouvrent pour des projets distincts.

Une fois vos appareils chargés, cliquez sur un enregistrement pour développer JSON.

Charge utile JSON Home Graph

Vous pouvez également utiliser les boutons Développer et Réduire pour afficher et masquer le fichier JSON pour vos appareils.

Développer et réduire les données JSON du graphique de la page d&#39;accueil

Pour lancer la suite de tests sur un appareil spécifique, procédez comme suit : cliquez sur Tester. 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 le test. résultats.

Home Graph : tests d&#39;exécution

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

Tests du graphique de la page d&#39;accueil 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 un journal Adb distinct pour chacun de vos fichiers journaux. Pour supprimer un onglet, cliquez sur le Icône .

Utilisez le champ Sélectionner pour sélectionner un composant de journalisation spécifique à afficher. Gravité pour n'afficher que les entrées dont le niveau de gravité correspond au journal

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

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 Brut. pour afficher les entrées de journal brutes.

Lecteur de journaux Adb

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 pourrions améliorer le développement Google Home Plugin, cliquez sur Commentaires.

<ph type="x-smartling-placeholder">
</ph> Envoyer des commentaires