Extension Google Home pour VS Code

SDK de l'appareil

Google Home Extension for Visual Studio Code est conçu et créé pour les développeurs de la plate-forme Google Home. Cette extension vous donne accès à Google Assistant Simulator, Google Cloud Logging, à la visionneuse de graphiques Home, ainsi qu'à d'autres outils pour simplifier les processus de développement de Matter et de maison connectée.

Extension Google Home pour VS Code

Fonctionnalités de l'extension Google Home

Simulateur de l'Assistant Google

Pour tester si vos appareils connectés fonctionnent correctement avec l'écosystème Google Home, vous pouvez interagir avec Assistant Simulator à tout moment sans quitter VS Code.

Semblable au Simulateur existant fourni dans la console Actions, Assistant Simulator vous permet de contrôler facilement vos appareils en saisissant vos requêtes, par exemple "Allume la lumière". Dans VS Code, Assistant Simulator répond par SMS en fonction de vos commandes, par exemple "Très bien, allumer la lumière". Pour en savoir plus, consultez Utiliser le simulateur de l'Assistant Google.

Énoncés par lot

Pour tester votre intégration de Google Home comme un automatisé, vous pouvez envoyer des énoncés par lot au simulateur de l'Assistant Google en exécutant un script d'énoncé. Pour en savoir plus, consultez la page Exécuter des énoncés par lot.

Outils de journalisation Matter

Les outils de journalisation Matter peuvent collecter tous les journaux liés au débogage Matter, y compris les journaux Google Home app (GHA) et les journaux des services Google Play (GMS Core). Les journaux peuvent être consultés dans VS Code grâce aux recherches de filtres et de mots clés. Les journaux peuvent être téléchargés avec des informations de débogage supplémentaires, telles que Android et la version de l'application, et envoyés à Google pour les problèmes de signalement.

Journalisation Matter des extensions Google Home

Cloud Logging

Cloud Logging fournit des informations de débogage et des métriques clés pour vous fournir des insights sur l'utilisation de votre action. Pour simplifier le développement, Google Home Extension affiche des messages Google Cloud Logging en temps réel juste à côté de votre code lors du dépannage. Pour en savoir plus, consultez Afficher Cloud Logging.

Lecteur Home Graph

La visionneuse Home Graph est désormais disponible directement dans Google Home Extension pour vous permettre de vérifier l'état de l'appareil dans votre Home Graph dans VS Code. Pour en savoir plus, consultez Afficher le graphique d'accueil et exécuter des tests.

Installer l'extension Google Home pour VS Code

Pour installer Google Home Extension, procédez comme suit à partir de VS Code:

  1. Cliquez sur l'icône Extensions dans la barre d'activité.
  2. Recherchez google home, puis cliquez sur Installer.

    Place de marché des extensions Google Home

Vous pouvez également télécharger Google Home Extension directement depuis VS Marketplace.

Télécharger Google Home Extension

Configurer l'extension Google Home pour VS Code

Après avoir installé Google Home Extension et rechargé VS Code, vous devez vous connecter et sélectionner un projet avant de pouvoir utiliser Assistant Simulator et afficher Cloud Logging.

Se connecter avec Google et sélectionner un projet cloud

Vous pouvez vous connecter à votre compte de développeur depuis Google Home Extension en autorisant VS Code à communiquer en votre nom avec les services Google.

  1. Cliquez sur l'icône Google Home dans la barre d'activité pour ouvrir Google Home Extension.

    Icône d'extension Google Home
  2. Cliquez sur Se connecter avec Google pour ouvrir la vue de connexion dans votre navigateur.

    VS Code Google Sign-In
  3. Sélectionnez le compte associé à vos appareils connectés.

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

  5. Un onglet de navigateur s'ouvre, et une boîte de dialogue Ouvrir Visual Studio Code s'affiche. Cliquez sur Ouvrir Visual Studio Code pour continuer.

    Ouvrir la boîte de dialogue VS Code
  6. Vous serez redirigé vers VS Code, où votre autorisation est requise pour permettre à l'extension Google Home d'ouvrir un URI. Cliquez sur Ouvrir pour terminer le processus.

    Autoriser l'extension Google Home à ouvrir un URI
  7. Une fois connecté, Google Home Extension chargera vos projets. Lorsque vous avez terminé, cliquez sur Sélectionner un projet.

    Sélectionner un projet
  8. Dans la fenêtre déroulante Rechercher et sélectionner un projet qui s'affiche, sélectionnez votre projet de maison connectée.

Installer l'outil Android Debug Bridge (ADB)

Pour afficher les journaux Matter sur un téléphone Android, vous devez installer ADB:

  1. Installez ADB sur votre ordinateur.
  2. Activez les options pour les développeurs et le débogage USB sur votre téléphone Android.

Installer les outils SoC de l'appareil Matter

Pour afficher les journaux de débogage à partir de Matter appareils:

  1. La plupart des SoC d'appareil exportent les ports série tels que /dev/ttyUSBx sous Linux, ou /dev/tty.SLAB_USBtoUART ou /dev/tty.usbserial sous macOS. La visionneuse de journaux peut lire le journal directement sur l'appareil.
  2. Certains types de SoC tels que NXP ou Silicon Labs peuvent nécessiter l'installation d'outils externes (par exemple, JLink). Pour en savoir plus, consultez Appareils compatibles.

Utiliser l'extension Google Home pour VS Code

Afficher les ressources pour les développeurs

Sous AIDE ET COMMENTAIRES, cliquez sur Premiers pas et ressources pour ouvrir la page Ressources, qui contient des informations utiles pour votre développement dans l'écosystème Google Home.

Ressources sur l'écosystème Google Home

Utiliser le simulateur de l'Assistant Google

Pour ouvrir Assistant Simulator dans VS Code, cliquez sur GOOGLE ASSISTANT SIMULATOR dans la barre latérale. Dans la zone Message, saisissez votre requête et appuyez sur Enter.

Vous pouvez afficher Assistant Simulator réponses et cliquer sur le bouton après votre requête pour la renvoyer.

Utiliser le simulateur de l'Assistant Google

Exécuter des énoncés par lot

Passez la souris sur la barre de menu GOOGLE ASSISTANT SIMULATOR et choisissez l'une des options suivantes pour configurer les scripts:

  • Cliquez sur pour ouvrir les scripts d'énoncé existants.

  • Cliquez sur pour enregistrer l'historique dans un script *.utterance.

    Icônes du menu "Expressions par lot"

Pour commencer à envoyer des énoncés par lot, choisissez l'une des options suivantes:

  • Cliquez sur pour sélectionner un script d'énoncé dans la fenêtre déroulante.
  • Ouvrez directement un fichier *.utterance, puis cliquez sur .

    Icône d'exécution d'énoncés par lot

Afficher Cloud Logging

Sous ACCÈS RAPIDE, cliquez sur Journaux Cloud pour ouvrir la page Journaux Cloud, où vous trouverez les journaux du projet sélectionné.

Utiliser Cloud Logging

Les utilisateurs peuvent filtrer les journaux en fonction de la gravité et de la période.

Filtrer les journaux par gravité et heure

Par défaut, les journaux sont limités à 50 lignes. Si l'utilisateur souhaite afficher plus de journaux, faites défiler la page jusqu'en bas et cliquez sur More (Plus) pour afficher plus de journaux.

Afficher plus de journaux

Afficher Home Graph et exécuter des tests

Sous ACCÈS RAPIDE, cliquez sur Lecteur de graphique d'accueil pour ouvrir le panneau Lecteur de graphique d'accueil, qui vous permet de trouver les appareils appartenant au projet sélectionné. Vous pouvez également cliquer sur Run Test (Exécuter le test) pour exécuter les tests de l'appareil.

Lecteur Home Graph

La suite de tests s'ouvre dans votre navigateur, votre appareil est sélectionné et prêt à être testé. Cliquez sur Démarrer et attendez les résultats du test.

Suite Google Home Test

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

Résultats du test

Utiliser l'extension Google Home pour le débogage Matter

Journalisation Android

Sous MATTER LOGGING OUTILS, cliquez sur Android Logs (Journaux Android) pour ouvrir la page Android Logs (Journaux Android), sélectionnez le téléphone Android auquel vous souhaitez vous connecter et commencez à afficher les journaux.

Journalisation Android

Une fois le téléphone Android connecté, les journaux s'affichent ligne par ligne. Notez que les journaux sont filtrés, ce qui signifie que seuls les journaux liés au GHA et au module Google Play services Matter sont affichés. Vous pouvez également définir le niveau de gravité (Gravity) pour filtrer les journaux ou rechercher le mot clé dans les journaux.

Journalisation Android filtrée

Journalisation des appareils Matter

Sous MATTER LOGGING TOOLS, cliquez sur Journaux de l'appareil pour ouvrir la page Ressources, puis sélectionnez Type de SoC:

Journalisation de l'appareil Matter

Sélectionnez ensuite l'appareil Matter:

Journalisation de l'appareil Matter

Vous pouvez ensuite obtenir tous les journaux de l'appareil et utiliser des filtres tels que Gravité et Recherche pour trouver les informations qui vous intéressent.

Journalisation filtrée de l'appareil Matter

Télécharger tous les journaux Matter

Sous ACCÈS RAPIDE, cliquez sur Télécharger les journaux pour ouvrir la boîte de dialogue Télécharger les journaux, sélectionnez les journaux à télécharger, puis appuyez sur OK.

Télécharger les journaux Matter

Sélectionnez le dossier dans lequel télécharger les journaux, puis cliquez sur Save (Enregistrer) :

Enregistrement du journal Matter

Les journaux sont ensuite enregistrés dans le dossier de destination:

Dossier de destination des journaux Matter

Extrayez le fichier ZIP enregistré. Il affichera des informations sur l'appareil et les fichiers journaux.

Fichier ZIP du journal Matter

Le fichier d'informations sur l'appareil inclut toutes les informations de version nécessaires pour déboguer les problèmes.

Débogage du journal Matter

Envoyer des commentaires

Pour nous faire part de vos commentaires et de vos suggestions d'amélioration du développement avec Google Home Extension, choisissez l'une des options suivantes:

  • Dans le panneau AIDE ET COMMENTAIRES, cliquez sur Envoyer des commentaires pour nous faire part de suggestions.
  • Dans le panneau AIDE ET COMMENTAIRES, cliquez sur Signaler un problème pour signaler tout problème rencontré avec Google Home Extension.
Icône Envoyer des commentaires
  • Nous avons également ajouté une icône de commentaires sur la page Ressources.