Matter Cloud zu Cloud Local Home SDK Device SDK
Google Home Extension for Visual Studio Code wurde speziell für Google Home-Entwickler entwickelt. Mit dieser Erweiterung erhältst du Zugriff auf Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer und andere Tools, die den Entwicklungsprozess für Matter und Smart-Home-Geräte vereinfachen.
![Google Home-Erweiterung für VS Code](https://developers.home.google.com/static/tools/images/google-home-extension-overview.png?authuser=3&hl=de)
Funktionen der Google Home-Erweiterung
Google Assistant-Simulator
Wenn du testen möchtest, ob deine Smart-Home-Geräte ordnungsgemäß mit der Google Home-Umgebung funktionieren, kannst du jederzeit mit Assistant Simulator interagieren, ohne VS Code zu verlassen.
Ähnlich wie mit dem vorhandenen Simulator in der Actions Console können Sie mit Assistant Simulator Ihre Geräte ganz einfach durch Eingabe Ihrer Abfragen steuern, z. B. „Schalte das Licht ein“. In VS Code antwortet Assistant Simulator mit Textnachrichten basierend auf Ihren Befehlen, z. B. „Alles klar, das Licht wird eingeschaltet.“ Weitere Informationen finden Sie unter Google Assistant-Simulator verwenden.
Batch-Äußerungen
Wenn Sie die Einbindung von Google Home wie ein automatisiertes System testen möchten, können Sie Batch-Äußerungen an den Google Assistant-Simulator senden. Dazu müssen Sie ein Äußerungsskript ausführen. Weitere Informationen finden Sie unter Batch-Äußerungen ausführen.
Protokollierungstools für Rechtsangelegenheiten
Matter-Protokollierungstools können alle Protokolle im Zusammenhang mit dem Matter-Debugging erfassen, einschließlich der Google Home app (GHA)-Logs und der Protokolle der Google Play-Dienste (GMS Core). Die Logs können in VS Code mit Filter- und Stichwortsuche angezeigt werden. Logs können mit zusätzlichen Fehlerbehebungsinformationen wie Android und App-Version heruntergeladen und zum Melden von Problemen an Google gesendet werden.
![Matter-Protokollierung für Google Home-Erweiterung](https://developers.home.google.com/static/tools/images/google-home-extension-matter-logging.png?authuser=3&hl=de)
Cloud Logging
Cloud Logging bietet Informationen zur Fehlerbehebung und wichtige Messwerte, die dir Einblicke in die Nutzung deiner Aktion geben. Zur Vereinfachung der Entwicklung zeigt Google Home Extension während der Fehlerbehebung Google Cloud Logging-Echtzeitnachrichten direkt neben Ihrem Code an. Weitere Informationen finden Sie unter Cloud Logging ansehen.
Home Graph-Anzeige
Der Home Graph Viewer ist jetzt direkt in Google Home Extension verfügbar. So kannst du den Status des Geräts in Home Graph in VS Code prüfen. Weitere Informationen finden Sie unter Home Graph ansehen und Tests ausführen.
Google Home-Erweiterung für VS Code installieren
Führen Sie zum Installieren von Google Home Extension die folgenden Schritte in VS Code aus:
- Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
Suchen Sie nach
google home
und klicken Sie dann auf Installieren.
Sie können die 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 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 Google Home, um Google Home Extension zu öffnen.
Klicken Sie auf Über Google anmelden, um die Anmeldeansicht in Ihrem 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 (Visual Studio Code öffnen). Klicken Sie auf Open Visual Studio Code, um fortzufahren.
Du wirst zu VS Code weitergeleitet. Dort ist deine Erlaubnis erforderlich, damit die Google Home-Erweiterung einen URI öffnen kann. Klicken Sie auf Open (Ö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 angezeigten 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 dem Computer.
- Aktivieren Sie auf Ihrem Android-Smartphone Entwickleroptionen und USB-Debugging.
SoC-Tools für Matter-Geräte installieren
So rufen Sie die Fehlerbehebungsprotokolle von Matter-Geräten auf:
- Die meisten Geräte-SoCs exportieren serielle Ports wie
/dev/ttyUSBx
unter Linux oder/dev/tty.SLAB_USBtoUART
oder/dev/tty.usbserial
unter macOS. Der LogViewer kann das Protokoll direkt vom Gerät lesen. - Einige SoC-Typen wie NXP oder Silicon Labs erfordern möglicherweise die Installation externer Tools (z. B. JLink). Weitere Informationen finden Sie unter Unterstützte Geräte.
Google Home-Erweiterung für VS Code verwenden
Entwicklerressourcen ansehen
Klicke unter HILFE UND FEEDBACK auf Erste Schritte & Ressourcen, um die Seite Ressourcen zu öffnen. Dort findest du hilfreiche Informationen für die Entwicklung mit der Google Home-Plattform.
![Ressourcen für die Google Home-Plattform](https://developers.home.google.com/static/tools/images/google-home-extension-resources.png?authuser=3&hl=de)
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 Assistant Simulator-Antworten aufrufen und auf die Schaltfläche nach Ihrer Abfrage klicken, um sie erneut zu senden.
![Google Assistant-Simulator verwenden](https://developers.home.google.com/static/tools/images/google-home-extension-assistant-resend.png?authuser=3&hl=de)
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 Batch-Äußerungen zu senden:
- Klicken Sie auf , um aus dem Drop-down-Fenster ein Äußerungsskript auszuwählen.
Öffnen Sie eine
*.utterance
-Datei direkt 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 für das ausgewählte Projekt.
![Cloud Logging verwenden](https://developers.home.google.com/static/tools/images/google-home-extension-cloud-logging.png?authuser=3&hl=de)
Nutzer können Logs nach Schweregrad und Zeitraum filtern.
![Logs nach Schweregrad und Zeit filtern](https://developers.home.google.com/static/tools/images/google-home-extension-filter-logs.png?authuser=3&hl=de)
Standardmäßig sind die Logs auf 50 Zeilen beschränkt. Wenn der Nutzer weitere Logs sehen möchte, scrollen Sie nach unten und klicken Sie auf Mehr.
![Weitere Logs ansehen](https://developers.home.google.com/static/tools/images/google-home-extension-logs-rows.png?authuser=3&hl=de)
Home Graph ansehen und Tests durchführen
Klicken Sie unter SCHNELLER ZUGRIFF auf Home Graph Viewer, um das Steuerfeld Home Graph Viewer zu öffnen. Dort finden Sie 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.
![Home Graph-Anzeige](https://developers.home.google.com/static/tools/images/google-home-extension-home-graph-viewer.png?authuser=3&hl=de)
Dadurch wird die Testsuite in Ihrem Browser mit dem ausgewählten Gerät gestartet und kann getestet werden. 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.
![Testergebnisse](https://developers.home.google.com/static/tools/images/google-home-extension-test-results.png?authuser=3&hl=de)
Google Home-Erweiterung für die Matter-Fehlerbehebung verwenden
Android-Protokollierung
Klicken Sie unter MATTER-PROTOKOLLIERUNGSTOOLS auf Android Logs, um die Seite Android Logs zu öffnen. Wählen Sie das Android-Smartphone aus, mit dem Sie eine Verbindung herstellen möchten, und zeigen Sie Logs an.
![Android-Protokollierung](https://developers.home.google.com/static/tools/images/google-home-extension-android-logging.png?authuser=3&hl=de)
Sobald das Smartphone Android verbunden ist, können Sie die Logs Zeile für Zeile ansehen. Beachten Sie, dass die Logs gefiltert sind. Das bedeutet, dass nur Logs angezeigt werden, die sich auf das GHA-Modul und das Google Play services Matter-Modul beziehen. Sie können auch den Schweregrad zum Filtern von Logs festlegen oder den Suchbegriff in den Logs mit Search durchsuchen.
![Android Logging gefiltert](https://developers.home.google.com/static/tools/images/google-home-extension-android-logging-filtered.png?authuser=3&hl=de)
Protokollierung von Matter-Geräten
Klicken Sie unter MATTER-LOGGING-TOOLS auf Gerätelogs, um die Seite Ressourcen zu öffnen. Wählen Sie zuerst SoC-Typ aus:
![Logging von Matter-Geräten](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging.png?authuser=3&hl=de)
Wählen Sie als Nächstes Matter-Gerät aus:
![Matter-Geräteprotokollierung – Gerät auswählen](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging-select.png?authuser=3&hl=de)
Anschließend können Sie alle Geräteprotokolle vom Gerät abrufen und Filter wie Schweregrad und Suche verwenden, um relevante Informationen zu finden.
![Gefiltertes Logging für Matter-Geräte](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging-filtered.png?authuser=3&hl=de)
Alle Matter-Protokolle 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.
![Matter-Protokolle herunterladen](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs.png?authuser=3&hl=de)
Wählen Sie den Ordner zum Herunterladen von Logs aus und klicken Sie auf Speichern:
![Matter-Protokoll speichern](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-save.png?authuser=3&hl=de)
Die Protokolle werden dann im Zielordner gespeichert:
![Zielordner für das Matter-Protokoll](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-dest.png?authuser=3&hl=de)
Entpacke die gespeicherte ZIP-Datei. Daraufhin werden Geräteinformationen und Protokolldateien angezeigt.
![ZIP-Datei mit Matter-Protokoll](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-zip.png?authuser=3&hl=de)
Die Datei mit den Geräteinformationen enthält alle Versionsinformationen, die zur Fehlerbehebung erforderlich sind.
![Debugging des Matter-Protokolls](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-debug.png?authuser=3&hl=de)
Feedback geben
Wenn Sie uns Feedback geben oder Verbesserungsvorschläge für Google Home Extension senden möchten, wählen Sie eine der folgenden Optionen aus:
- Klicken Sie im Bereich HILFE UND FEEDBACK auf Feedback geben, um Vorschläge zu machen.
- Klicken Sie im Bereich HILFE UND FEEDBACK auf Problem melden, um Probleme mit Google Home Extension zu melden.
![Symbol „Feedback geben“](https://developers.home.google.com/static/tools/images/google-home-extension-feedback.png?authuser=3&hl=de)
- Außerdem haben wir auf der Seite Ressourcen ein Feedbacksymbol hinzugefügt.