Matter Cloud-to-Cloud Local Home SDK Geräte-SDK
Google Home Extension for Visual Studio Code wurde für Google Home Platform-Entwickler entwickelt. Mit dieser Erweiterung erhalten Sie Zugriff auf Google Assistant Simulator, Google Cloud Logging, den Home Graph Viewer und andere Tools, um die Entwicklung von Matter und Smart Homes zu vereinfachen.
Funktionen der Google Home-Erweiterung
Google Assistant-Simulator
Sie können jederzeit mit Assistant Simulator interagieren, ohne VS Code zu verlassen, um zu testen, ob Ihre Smart-Home-Geräte ordnungsgemäß mit der Google Home-Umgebung funktionieren.
Ähnlich wie mit dem vorhandenen Simulator, der in der Actions Console bereitgestellt wird, können Sie mit Assistant Simulator Ihre Geräte ganz einfach steuern, indem Sie Ihre Abfragen eingeben, z. B. „Schalte das Licht ein“. In VS Code antwortet Assistant Simulator mit Textnachrichten, die auf Ihren Befehlen basieren, z. B. „Alles klar, das Licht wird eingeschaltet.“ Weitere Informationen finden Sie unter Google Assistant-Simulator verwenden.
Batch-Äußerungen
Wenn Sie die Google Home-Integration wie eine Automatisierung testen möchten, können Sie Batchäußerungen an den Google Assistant Simulator senden. Dazu führen Sie ein Skript für Äußerungen aus. Weitere Informationen finden Sie unter Batch-Äußerungen ausführen.
Matter-Logging-Tools
Mit Matter-Logging-Tools können alle Logs im Zusammenhang mit der Matter-Fehlerbehebung erfasst werden, einschließlich der Google Home app (GHA)-Logs und Logs der Google Play-Dienste (GMS Core). Die Logs können in VS Code mit Filter- und Stichwortsuchen angezeigt werden. Die Protokolle können mit zusätzlichen Debug-Informationen wie Android und App-Version heruntergeladen und zum Melden von Problemen an Google gesendet werden.
Cloud Logging
Cloud Logging bietet Informationen zur Fehlerbehebung und wichtige Messwerte, um dir einen Einblick in die Nutzung deiner Aktion zu geben. Um die Entwicklung zu vereinfachen, zeigt Google Home Extension bei der Fehlerbehebung Echtzeitmeldungen von Google Cloud Logging direkt neben dem Code an. Weitere Informationen finden Sie unter Cloud Logging ansehen.
Home Graph-Betrachter
Der Home Graph Viewer ist jetzt direkt in der Google Home Extension verfügbar, sodass Sie den Status des Geräts in Home Graph in VS Code überprüfen können. Weitere Informationen finden Sie unter Home Graph ansehen und Tests ausführen.
Google Home-Erweiterung für VS Code installieren
Führen Sie die folgenden Schritte in VS Code aus, um Google Home Extension zu installieren:
- Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
Suchen Sie nach
google homeund klicken Sie dann auf Installieren.
Sie können das Google Home Extension auch direkt aus dem VS Code Marketplace herunterladen.
Laden Sie Google Home Extension herunter.
Google Home-Erweiterung für VS Code einrichten
Nachdem Sie Google Home Extension installiert und VS Code neu geladen haben, müssen Sie sich anmelden und ein Projekt auswählen, bevor Sie Assistant Simulator verwenden und Cloud Logging aufrufen können.
Über Google anmelden und ein Cloud-Projekt auswählen
Sie können sich über Google Home Extension in Ihrem Entwicklerkonto anmelden und VS Code autorisieren, in Ihrem Namen mit Google-Diensten zu kommunizieren.
Klicken Sie in der Aktivitätsleiste auf das Symbol für Google Home, um Google Home Extension zu öffnen.
Klicken Sie auf Über Google anmelden, um die Anmeldeansicht im Browser zu öffnen.
Wählen Sie das Konto aus, das mit Ihren Smart-Home-Geräten verknüpft ist.
Klicken Sie auf der Autorisierungsseite Über Google anmelden auf Zulassen.
Ein Browsertab wird geöffnet und das Dialogfeld Open Visual Studio Code wird angezeigt. Klicken Sie auf Open Visual Studio Code (Visual Studio-Code öffnen), um fortzufahren.
Sie werden zu VS Code weitergeleitet. Dort ist Ihre Berechtigung erforderlich, damit die Google Home-Erweiterung einen URI öffnen kann. Klicken Sie auf Öffnen, um den Anmeldevorgang abzuschließen.
Nach der Anmeldung lädt Google Home Extension Ihre Projekte. Wenn Sie fertig sind, klicken Sie auf Projekt auswählen.
Wählen Sie im Drop-down-Fenster Projekt suchen und auswählen Ihr Smart-Home-Projekt aus.
Android Debug Bridge-Tool (ADB) installieren
Sie müssen ADB installieren, um die Matter-Logs auf einem Android-Smartphone anzusehen:
- Installieren Sie ADB auf Ihrem Computer.
- Aktivieren Sie die Entwickleroptionen und USB-Debugging auf Ihrem Android-Smartphone.
SoC-Tools für Matter-Geräte installieren
So rufen Sie die Fehlerbehebungsprotokolle von Matter-Geräten auf:
- Die meisten SoC-Geräte exportieren serielle Ports wie
/dev/ttyUSBxunter Linux oder/dev/tty.SLAB_USBtoUARToder/dev/tty.usbserialunter macOS. Die Loganzeige kann das Protokoll direkt vom Gerät aus lesen. - Für einige SoC-Typen wie NXP oder Silicon Labs müssen möglicherweise externe Tools (z. B. JLink) installiert werden. Weitere Informationen findest du unter Unterstützte Geräte.
Google Home-Erweiterung für VS Code verwenden
Entwicklerressourcen ansehen
Klicken Sie unter HILFE UND FEEDBACK auf Erste Schritte und Ressourcen, um die Seite Ressourcen zu öffnen. Dort finden Sie hilfreiche Informationen für die Entwicklung mit Google Home.
Google Assistant-Simulator verwenden
Klicken Sie in der Seitenleiste auf GOOGLE ASSISTANT SIMULATOR, um Assistant Simulator in VS Code zu öffnen. Geben Sie Ihre Abfrage im Feld Nachricht ein und drücken Sie Enter.
Sie können sich Assistant Simulator-Antworten ansehen und nach Ihrer Abfrage auf die Schaltfläche klicken, um sie noch einmal zu senden.
Batch-Äußerungen ausführen
Bewegen Sie den Mauszeiger auf die Menüleiste GOOGLE ASSISTANT SIMULATOR und wählen Sie eine der folgenden Optionen aus, um Skripts einzurichten:
Klicken Sie auf , um vorhandene Äußerungsskripts zu öffnen.
Klicken Sie auf , um den Verlauf in einem
*.utterance-Skript zu speichern.
Wählen Sie eine der folgenden Optionen aus, um mit dem Senden von Batchäußerungen zu beginnen:
- Klicken Sie auf , um ein Äußerungsskript aus dem Drop-down-Fenster auszuwählen.
Öffnen Sie direkt eine
*.utterance-Datei und klicken Sie auf .
Cloud Logging ansehen
Klicken Sie unter SCHNELLER ZUGRIFF auf Cloud Logs, um die Seite Cloud Logs zu öffnen. Dort finden Sie die Logs, die zum ausgewählten Projekt gehören.
Nutzer können Logs nach Schweregrad und Zeitraum filtern.
Standardmäßig sind die Logs auf 50 Zeilen beschränkt. Wenn der Nutzer weitere Logs aufrufen möchte, scrollen Sie nach unten und klicken Sie auf More (Mehr).
Home Graph anzeigen und Tests durchführen
Klicken Sie unter SCHNELLER ZUGRIFF auf Home Graph Viewer, um den Bereich Home Graph Viewer zu öffnen. Dort finden Sie die Geräte, die zum ausgewählten Projekt gehören. Sie können auch auf Test ausführen klicken, um Tests für das Gerät auszuführen.
Dadurch wird die Testsuite in Ihrem Browser gestartet, wobei Ihr Gerät ausgewählt und zum Testen bereit ist. Klicken Sie auf Starten und warten Sie auf die Testergebnisse.
Sie können sich die Testdetails und die Logs ansehen, nachdem alle Tests abgeschlossen sind.
Google Home-Erweiterung für die Matter-Fehlerbehebung verwenden
Android-Protokollierung
Klicken Sie unter MATTER-LOGGINGTOOLS auf Android Logs, um die Seite Android Logs zu öffnen. Wählen Sie das Android-Telefon aus, mit dem Sie eine Verbindung herstellen möchten, und starten Sie die Anzeige von Logs.
Nachdem das Android-Telefon verbunden ist, können Sie die Protokolle Zeile für Zeile sehen. Beachten Sie, dass die Logs gefiltert werden. Das bedeutet, dass nur Logs angezeigt werden, die sich auf das GHA- und das Google Play services Matter-Modul beziehen. Sie können auch den Schweregrad festlegen, um Logs zu filtern, oder den Suchbegriff in Logs mit Search (Suchen) eingeben.
Matter-Geräteprotokollierung
Klicken Sie unter MATTER-LOGGINGTOOLS auf Gerätelogs, um die Seite Ressourcen zu öffnen, und wählen Sie zuerst SoC-Typ aus:
Wählen Sie als Nächstes das Matter-Gerät aus:
Dann können Sie alle Geräteprotokolle vom Gerät abrufen und Filter wie Schweregrad und Suche verwenden, um die gewünschten Informationen zu finden.
Alle Matter-Logs herunterladen
Klicken Sie unter SCHNELLER ZUGRIFF auf Logs herunterladen, um das Dialogfeld Logs herunterladen zu öffnen. Wählen Sie die herunterzuladenden Logs aus und klicken Sie auf OK.
Wählen Sie den Ordner aus, in dem Sie die Protokolle herunterladen möchten, und klicken Sie auf Speichern:
Anschließend werden die Protokolle im Zielordner gespeichert:
Extrahieren Sie die gespeicherte ZIP-Datei. Die Geräteinformationen und Protokolldateien werden angezeigt.
Die Datei mit den Geräteinformationen enthält alle Versionsinformationen, die zum Beheben von Problemen erforderlich sind.
Feedback geben
Wenn Sie uns Feedback dazu geben möchten, wie wir die Entwicklung mit Google Home Extension verbessern können, wählen Sie eine der folgenden Optionen aus:
- Klicken Sie im Bereich HILFE UND FEEDBACK auf Feedback geben, um uns Vorschläge zu machen.
- Klicken Sie im Bereich HILFE UND FEEDBACK auf Problem melden, um Probleme mit Google Home Extension zu melden.
- Auf der Seite Ressourcen finden Sie jetzt ein Feedbacksymbol.