Matter Cloud-zu-Cloud Local Home SDK Device SDK
Google Home Extension for Visual Studio Code wurde für Entwickler der Google Home-Plattform entwickelt. Mit dieser Erweiterung erhalten Sie Zugriff auf Google Assistant Simulator, Google Cloud Logging, den Home Graph Viewer und andere Tools, die die Entwicklung von Matter und Smart-Home-Geräten vereinfachen.
Funktionen der Google Home-Erweiterung
Google Assistant-Simulator
Wenn Sie testen möchten, ob Ihre Smart-Home-Geräte ordnungsgemäß mit dem Google Home-System funktionieren, können Sie jederzeit mit Assistant Simulator interagieren, ohne VS Code zu verlassen.
Mit Assistant Simulator können Sie Ihre Geräte ganz einfach per Eingabe steuern, z. B. „Schalte das Licht ein.“ In VS Code antwortet Assistant Simulator auf Ihre Befehle mit Textnachrichten, z. B. „In Ordnung, ich schalte das Licht ein.“ Weitere Informationen finden Sie unter Google Assistant-Simulator verwenden.
Batch-Sätze
Wenn Sie Ihre Google Home-Integration wie einen Automaten testen möchten, können Sie Batch-Sätze an den Google Assistant-Simulator senden, indem Sie ein Skript für die Äußerungen ausführen. Weitere Informationen finden Sie unter Batch-Sätze 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 der Logs der Google Play-Dienste (GMS Core). Die Protokolle können in VS Code mit Filter- und Suchbegriffen angezeigt werden. Protokolle können mit zusätzlichen Informationen zur Fehlerbehebung wie Android und App-Version heruntergeladen und an Google gesendet werden, um Probleme zu melden.
Cloud Logging
Cloud Logging bietet Informationen zur Fehlerbehebung und wichtige Messwerte, die Aufschluss über die Nutzung Ihrer Aktion geben. Zur Vereinfachung der Entwicklung werden in der Google Home Extension während der Fehlerbehebung Google Cloud Logging-Nachrichten in Echtzeit direkt neben dem Code angezeigt. Weitere Informationen finden Sie unter Cloud Logging-Daten ansehen.
Home Graph-Betrachter
Der Home Graph Viewer ist jetzt direkt in derGoogle Home Extension verfügbar, sodass Sie den Gerätestatus in Ihrem Home Graph in VS Code prüfen können. Weitere Informationen finden Sie unter Zuhause-Diagramm ansehen und Tests ausführen.
Google Home-Erweiterung für VS Code installieren
So installieren Sie Google Home Extension in VS Code:
- Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
Suchen Sie nach
google homeund klicken Sie auf Installieren.
Sie können die Google Home Extension auch direkt über den VS Code Marketplace herunterladen.
Google Home Extension herunterladen
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 Google Home Extension verwenden und Cloud Logging aufrufen können.Assistant Simulator
Mit Google anmelden und ein Cloud-Projekt auswählen
Sie können sich ab dem Google Home Extension in Ihrem Entwicklerkonto anmelden und VS Code berechtigen, 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 Anmeldeseite 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 Visual Studio Code öffnen wird angezeigt. Klicken Sie auf Visual Studio Code öffnen, um fortzufahren.
Sie werden zu VS Code weitergeleitet, wo Sie die Berechtigung erteilen müssen, damit die Google Home-Erweiterung einen URI öffnen kann. Klicken Sie auf Öffnen, um den Anmeldevorgang abzuschließen.
Nach der Anmeldung werden Ihre Projekte in Google Home Extension geladen. Klicken Sie dann auf Projekt auswählen.
Wählen Sie im Drop-down-Fenster Projekt suchen und auswählen Ihr Smart-Home-Projekt aus.
Android Debug Bridge (ADB) Tool installieren
Wenn du die Matter-Protokolle auf einem Android-Smartphone aufrufen möchtest, musst du ADB installieren:
- Installieren Sie ADB auf Ihrem Computer.
- Aktivieren Sie die Entwickleroptionen und das USB-Debugging auf Ihrem Android-Smartphone.
Matter Device SoC Tools installieren
So rufen Sie die Debug-Protokolle von Matter Geräten auf:
- Die meisten Geräte-SoCs exportieren serielle Ports wie
/dev/ttyUSBxunter Linux oder/dev/tty.SLAB_USBtoUARToder/dev/tty.usbserialunter macOS. Der LogViewer kann das Protokoll direkt vom Gerät lesen. - Für einige SoC-Typen wie NXP oder Silicon Labs müssen möglicherweise externe Tools wie JLink installiert werden. Weitere Informationen finden Sie unter Unterstützte Geräte.
Google Home-Erweiterung für VS Code verwenden
Ressourcen für Entwickler ansehen
Klicken Sie unter HILFE UND FEEDBACK auf Einstieg und Ressourcen, um die Seite Ressourcen zu öffnen. Dort finden Sie hilfreiche Informationen für Ihre Entwicklung im Google Home-System.
Google Assistant-Simulator verwenden
Wenn Sie Assistant Simulator in VS Code öffnen möchten, klicken Sie in der Seitenleiste auf GOOGLE ASSISTANT-SIMULATOR. Geben Sie Ihre Suchanfrage in das Feld Nachricht ein und drücken Sie die Enter.
Sie können sich Assistant Simulator Antworten ansehen und nach Ihrer Anfrage auf die Schaltfläche Senden klicken, um sie noch einmal zu senden.
Batch-Sätze ausführen
Bewegen Sie den Mauszeiger auf die Menüleiste GOOGLE ASSISTANT SIMULATOR und wählen Sie eine der folgenden Optionen aus, um Scripts einzurichten:
Klicken Sie auf , um vorhandene Skripts für Äußerungen zu öffnen.
Klicken Sie auf , um den Verlauf in einem
*.utterance-Script zu speichern.
Wenn Sie Batch-Sätze senden möchten, haben Sie folgende Möglichkeiten:
- Klicken Sie auf , um im Drop-down-Menü ein Skript für die Äußerung auszuwählen.
Öffnen Sie eine
*.utterance-Datei direkt und klicken Sie auf .
Cloud Logging aufrufen
Klicken Sie unter SCHNELLZUGRIFF auf Cloud Logs, um die Seite Cloud Logs zu öffnen. Dort finden Sie die Logs für das ausgewählte Projekt.
Nutzer können Protokolle nach Schweregrad und Zeitraum filtern.
Standardmäßig sind die Protokolle auf 50 Zeilen begrenzt. Wenn der Nutzer weitere Protokolle aufrufen möchte, scrollt er nach unten und klickt auf Mehr.
Startseite-Grafik aufrufen und Tests ausführen
Klicken Sie unter SCHNELLZUGRIFF auf Home Graph Viewer (Zuhause-Grafikanzeige), um den Bereich Home Graph Viewer (Zuhause-Grafikanzeige) 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.
Dadurch wird die Testsuite in Ihrem Browser gestartet. Ihr Gerät ist ausgewählt und kann getestet werden. Klicken Sie auf Starten und warten Sie auf die Testergebnisse.
Sie können sich die Testdetails und die Protokolle ansehen, nachdem alle Tests abgeschlossen sind.
Google Home-Erweiterung für die Matter-Fehlerbehebung verwenden
Android-Protokollierung
Klicken Sie unter MATTER LOGGING TOOLS (MATTER-LOGGING-TOOLS) auf Android Logs (Android Protokolle), um die Seite Android Logs (Android Protokolle) zu öffnen. Wählen Sie das Android-Smartphone aus, mit dem Sie eine Verbindung herstellen möchten, und lassen Sie sich Protokolle anzeigen.
Nachdem das Android-Smartphone verbunden ist, können Sie die Protokolle zeilenweise aufrufen. Die Protokolle werden gefiltert, sodass nur Protokolle zu GHA und zum Google Play services Matter-Modul angezeigt werden. Sie können auch Schweregrad festlegen, um Protokolle zu filtern, oder Suchen, um nach dem Suchbegriff in Protokollen zu suchen.
Logging von Matter-Geräten
Klicken Sie unter MATTER LOGGING TOOLS (MATTER-LOGGER) auf Device Logs (Geräteprotokolle), um die Seite Resources (Ressourcen) zu öffnen. Wählen Sie zuerst SoC Type (SoC-Typ) aus:
Wählen Sie als Nächstes das Matter-Gerät aus:
Anschließend können Sie alle Geräteprotokolle vom Gerät abrufen und mithilfe von Filtern wie Schweregrad und Suchen die gewünschten Informationen finden.
Alle Matter-Protokolle herunterladen
Klicken Sie unter SCHNELLER ZUGRIFF auf Protokolle herunterladen, um das Dialogfeld Protokolle herunterladen zu öffnen. Wählen Sie die herunterzuladenden Protokolle aus und drücken Sie auf OK.
Wählen Sie den Ordner aus, in den Sie die Protokolle herunterladen möchten, und klicken Sie auf Speichern:
Die Protokolle werden dann im Zielordner gespeichert:
Extrahieren Sie die gespeicherte ZIP-Datei. Sie enthält Geräteinformationen und Protokolldateien.
Die Geräteinfodatei enthält alle Versionsinformationen, die zur Fehlerbehebung erforderlich sind.
Feedback geben
Wenn du uns deine Meinung oder Feedback dazu geben möchtest, wie wir die Entwicklung mit Google Home Extension verbessern können, wähle 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 ein Problem mit Google Home Extension
- Auf der Seite Ressourcen finden Sie außerdem ein Feedbacksymbol.