Matter Cloud-to-cloud SDK Local Home 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 permet d'accéder à Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer et à d'autres outils pour simplifier le processus de développement de Matter et de maison connectée.
Fonctionnalités des extensions Google Home
Simulateur de l'Assistant Google
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 VS Code.
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 des messages textuels en fonction de vos commandes, par exemple : "OK, j'allume la lumière." Pour en savoir plus, consultez Utiliser le simulateur de l'Assistant Google.
Émissions par lot
Pour tester votre intégration Google Home comme un automate, vous pouvez envoyer des énoncés groupés au simulateur de l'Assistant Google en exécutant un script d'énoncé. Pour en savoir plus, consultez la section 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 avec des filtres et des recherches par mot clé. Vous pouvez télécharger des journaux avec des informations de débogage supplémentaires telles que Android et la version de l'application, puis les envoyer à Google pour signaler les problèmes.
Cloud Logging
Cloud Logging fournit des informations de débogage et des métriques clés pour vous donner un aperçu de l'utilisation de votre action. Pour simplifier le développement, Google Home Extension affiche les 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
Le Visionneuse Home Graph est désormais disponible directement dans Google Home Extension afin que vous puissiez vérifier l'état de l'appareil dans votre Home Graph dans VS Code. Pour en savoir plus, consultez Afficher le graphique de la maison et exécuter des tests.
Installer l'extension Google Home pour VS Code
Pour installer Google Home Extension, procédez comme suit dans VS Code:
- Cliquez sur l'icône Extensions dans la barre des tâches.
Recherchez
google home, puis cliquez sur Installer.
Vous pouvez également télécharger Google Home Extension directement à partir de VS Code Marketplace.
Télécharger Google Home Extension
Configurer l'extension Google Home pour VS Code
Une fois que vous avez installé Google Home Extension et actualisé 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, ce qui autorise VS Code à communiquer avec les services Google en votre nom.
Cliquez sur l'icône Google Home dans la barre des tâches pour ouvrir Google Home Extension.
Cliquez sur Se connecter avec Google pour lancer la vue de connexion dans votre navigateur.
Sélectionnez le compte associé à vos appareils connectés.
Sur la page d'autorisation Se connecter avec Google, cliquez sur Autoriser.
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.
Vous êtes redirigé vers VS Code, où votre autorisation est requise pour autoriser l'extension Google Home à ouvrir un URI. Cliquez sur Ouvrir pour terminer le processus de connexion.
Une fois connecté, Google Home Extension charge vos projets. Une fois terminé, cliquez sur Sélectionner un projet.
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:
- Installez ADB sur votre ordinateur.
- Activez les options pour les développeurs et le débogage USB sur votre téléphone Android.
Installer les outils SoC pour les appareils Matter
Pour afficher les journaux de débogage des appareils Matter:
- La plupart des SoC d'appareils exportent des ports série tels que
/dev/ttyUSBxsur Linux,/dev/tty.SLAB_USBtoUARTou/dev/tty.usbserialsur macOS. LogViewer peut lire le journal directement depuis l'appareil. - 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 la section 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 avec l'écosystème Google Home.
Utiliser le simulateur de l'Assistant Google
Pour ouvrir Assistant Simulator dans VS Code, cliquez sur GOOGLE ASSISTANT SIMULATOR (SIMULATEUR DE GOOGLE ASSISTANT) dans la barre latérale. Dans la zone Message, saisissez votre requête, puis appuyez sur Enter.
Vous pouvez afficher les réponses Assistant Simulator et cliquer sur le bouton après votre requête pour l'envoyer à nouveau.
Exécuter des énoncés par lot
Pointez sur la barre de menu GOOGLE ASSISTANT SIMULATOR (SIMULATEUR DE L'ASSISTANT GOOGLE), puis sélectionnez l'une des options suivantes pour configurer des scripts:
Cliquez sur pour ouvrir les scripts d'énoncés existants.
Cliquez sur pour enregistrer l'historique dans un script
*.utterance.
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 .
Afficher Cloud Logging
Sous ACCÈS RAPIDE, cliquez sur Cloud Logs pour ouvrir la page Cloud Logs, où vous trouverez les journaux appartenant au projet sélectionné.
Les utilisateurs peuvent filtrer les journaux en fonction de leur gravité et de la période.
Par défaut, les journaux sont limités à 50 lignes. Si l'utilisateur souhaite afficher d'autres journaux, il doit faire défiler la page vers le bas et cliquer sur Plus.
Afficher le graphique de la maison et exécuter des tests
Sous ACCÈS RAPIDE, cliquez sur Visionneuse de graphiques de la maison pour ouvrir le panneau Visionneuse de graphiques de la maison, dans lequel vous pouvez trouver les appareils appartenant au projet sélectionné. Vous pouvez également cliquer sur Run Test (Exécuter le test) pour exécuter des tests sur l'appareil.
La suite de tests s'exécute alors dans votre navigateur, votre appareil est 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 des tests et afficher les journaux une fois tous les tests terminés.
Utiliser l'extension Google Home pour le débogage Matter
Journalisation Android
Sous OUTILS DE JOURNALISATION MATTER, cliquez sur Android Journaux pour ouvrir la page Android Journaux, sélectionnez le téléphone Android auquel vous souhaitez vous connecter et commencez à afficher les journaux.
Une fois le téléphone Android connecté, vous pouvez consulter les journaux ligne par ligne. Notez que les journaux sont filtrés, ce qui signifie que seuls les journaux liés à GHA et au module Matter Google Play services sont affichés. Vous pouvez également définir Gravité pour filtrer les journaux ou Rechercher le mot clé dans les journaux.
Journalisation des appareils Matter
Sous OUTILS DE JOURNALISATION MATTER, cliquez sur Journaux de l'appareil pour ouvrir la page Ressources, puis sélectionnez d'abord Type de SoC:
Sélectionnez ensuite Matter Device (Appareil Matter) :
Vous pouvez ensuite récupérer tous les journaux de l'appareil et utiliser des filtres tels que Sévérité et Recherche pour trouver les informations qui vous intéressent.
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.
Sélectionnez le dossier dans lequel télécharger les journaux, puis cliquez sur Enregistrer:
Les journaux sont ensuite enregistrés dans le dossier de destination:
Décompressez le fichier ZIP enregistré. Il affichera des informations sur l'appareil et des fichiers journaux.
Le fichier d'informations sur l'appareil inclut toutes les informations de version nécessaires pour déboguer les problèmes.
Envoyer des commentaires
Pour nous faire part de vos commentaires sur la façon dont nous pouvons améliorer l'expérience de développement avec Google Home Extension, choisissez parmi les options suivantes:
- Dans le panneau AIDE ET COMMENTAIRES, cliquez sur Envoyer des commentaires pour nous faire part de vos suggestions.
- Dans le panneau AIDE ET COMMENTAIRES, cliquez sur Signaler un problème pour signaler tout problème que vous avez rencontré avec Google Home Extension.
- Nous avons également ajouté une icône de commentaires sur la page Ressources.