Matter Cloud-zu-Cloud Local Home SDK Geräte-SDK
Google Home Extension for Visual Studio Code wurde für die Google Home Platform entwickelt und erstellt. Über diese Erweiterung haben Sie Zugriff auf Google Assistant Simulator, Google Cloud Logging, den Home Graph-Viewer und andere Tools, um den Matter- und Smart-Home-Entwicklungsprozess zu vereinfachen.
Funktionen der Google Home-Erweiterung
Google Assistant-Simulator
Wenn Sie testen möchten, ob Ihre Smart-Home-Geräte mit der Google Home-Umgebung kompatibel sind, können Sie jederzeit mit Assistant Simulator interagieren, ohne den VS-Code zu verlassen.
Ähnlich wie beim vorhandenen Simulator in der Actions Console können Sie Ihre Geräte ganz einfach mit Assistant Simulator steuern, z. B. mit „Schalte das Licht ein“. Im VS-Code gibt Assistant Simulator auf der Grundlage deiner Befehle Textnachrichten zurück, z. B. „Alles klar, ich schalte das Licht ein.“ Weitere Informationen finden Sie unter Google Assistant Simulator verwenden.
Batch-Äußerungen
Wenn Sie Ihre Google Home-Integration wie eine Automatisierung testen möchten, können Sie Batch-Äußerungen an den Google Assistant Simulator senden, indem Sie ein Äußerungsskript ausführen. Weitere Informationen finden Sie unter Batch-Äußerungen ausführen.
Tools für die Matter-Protokollierung
Mit den Matter Logging-Tools lassen sich alle Logs für das Matter-Debugging erfassen, einschließlich der Logs Google Home app (GHA) und Google Play Services (GMS Core). Die Logs können in VS Code mit Filter- und Keyword-Suchanfragen angezeigt werden. Logs können mit zusätzlichen Debug-Informationen wie Android und der App-Version heruntergeladen und zur Meldung an Google gesendet werden.
Cloud Logging
Cloud Logging bietet Debugging-Informationen und wichtige Messwerte, die Ihnen Informationen zur Nutzung Ihrer Aktion liefern. Zur Vereinfachung der Entwicklung zeigt Google Google Home Extension während der Fehlerbehebung direkt neben Ihrem Code Google Cloud Logging-Nachrichten in Echtzeit an. Weitere Informationen finden Sie unter Cloud Logging ansehen.
Startseitendiagramm-Betrachter
Die Anzeige des Home Graphs ist jetzt direkt in der Google Home Extension verfügbar. Damit können Sie den Status des Geräts in der Home Graph-Ansicht im VS-Code überprüfen. Weitere Informationen finden Sie unter Home Graph 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.
Suche nach
google homeund klicke dann auf Installieren.
Sie können 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 den VS-Code neu geladen haben, müssen Sie sich anmelden und ein Projekt auswählen, damit Sie Assistant Simulator verwenden und Cloud Logging ansehen 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 in Ihrem Browser zu starten.
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 Ihre Berechtigung erforderlich ist, damit die Google Home-Erweiterung einen URI öffnen kann. Klicken Sie auf Öffnen, um die Anmeldung abzuschließen.
Nach der Anmeldung lädt Google Home Extension deine Projekte. Klicken Sie anschließend auf Projekt auswählen.
Wählen Sie im Drop-down-Menü Projekt auswählen Ihr Smart-Home-Projekt aus.
Android Debug Bridge-Tool (ADB) installieren
Wenn Sie die Matter-Logs auf einem Android-Telefon aufrufen möchten, müssen Sie ADB installieren:
- Installieren Sie ADB auf Ihrem Computer.
- Aktivieren Sie Entwickleroptionen und USB-Debugging auf Ihrem Android-Smartphone.
Matter-Geräte-SoC-Tools installieren
So sehen Sie sich die Fehlerbehebungsprotokolle von Matter-Geräten an:
- 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 Log direkt auf dem Gerät lesen. - Für einige SoC-Typen wie NXP oder Silicon Labs müssen möglicherweise externe Tools (z. B. JLink) installiert werden. Weitere Informationen finden Sie unter Unterstützte Geräte.
Google Home-Erweiterung für VS Code verwenden
Entwicklerressourcen ansehen
Klicken Sie unter HILFE UND FEEDBACK auf Jetzt starten und Ressourcen, um die Seite Ressourcen zu öffnen, auf der Sie nützliche Informationen zur Entwicklung mit Google Home finden.
Google Assistant-Simulator verwenden
Klicken Sie zum Öffnen von Assistant Simulator in VS Code in der Seitenleiste auf GOOGLE ASSISTANT SIMULATOR. Geben Sie im Feld Nachricht Ihre Abfrage ein und drücken Sie Enter.
Sie können Assistant Simulator-Antworten ansehen. Klicken Sie auf die Schaltfläche nach Ihrer Abfrage, um sie noch einmal zu senden.
Batch-Äußerungen ausführen
Bewegen Sie den Mauszeiger auf die Menüleiste von GOOGLE ASSISTANT SIMULATOR und wählen Sie eine der folgenden Optionen zum Einrichten von Skripts aus:
Klicken Sie auf , um vorhandene Äußerungsskripts zu öffnen.
Klicken Sie auf , um den Verlauf in einem
*.utterance-Skript zu speichern.
Wenn Sie Batch-Äußerungen senden möchten, wählen Sie eine der folgenden Optionen aus:
- Klicken Sie auf , um ein Äußerungsskript aus dem Drop-down-Fenster auszuwählen.
Öffnen Sie die Datei
*.utterancedirekt und klicken Sie auf .
Cloud Logging ansehen
Klicken Sie unter QUICK ACCESS auf Cloud Logs, um die Seite Cloud Logs zu öffnen. Dort finden Sie die Logs des ausgewählten Projekts.
Nutzer können Logs nach Schweregrad und Zeitraum filtern.
Standardmäßig sind die Logs auf 50 Zeilen beschränkt. Wenn der Nutzer weitere Logs ansehen möchte, scrollen Sie nach unten und klicken Sie auf Mehr, um weitere Logs aufzurufen.
Home Graph anzeigen und Tests ausführen
Klicken Sie unter QUICK ACCESS (QUICK-ZUGRIFF) auf Home Graph Viewer, um den Bereich 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 durchzuführen.
Dadurch wird die Testsuite in Ihrem Browser gestartet und das Gerät ist ausgewählt. Klicken Sie auf Start und warten Sie auf die Testergebnisse.
Sie können sich die Testdetails ansehen und die Logs ansehen, nachdem alle Tests abgeschlossen sind.
Google Home-Erweiterung für die Matter-Fehlerbehebung verwenden
Android-Protokollierung
Klicken Sie unter MATTER LOGGING TOOLS auf Android Logs, um die Seite Android Logs zu öffnen. Wählen Sie dann das Smartphone Android aus, mit dem Sie eine Verbindung herstellen möchten, und rufen Sie Logs auf.
Nachdem das Android-Smartphone verbunden ist, können Sie die Logs Zeile für Zeile sehen. Beachten Sie, dass die Logs gefiltert werden. Dies bedeutet, dass nur Logs mit Bezug zum GHA und zum Modul Google Play services Matter angezeigt werden. Außerdem haben Sie die Möglichkeit, mit Schweregrad Logs zu filtern oder in Suchbegriffen nach dem Keyword zu suchen.
Matter-Geräteprotokollierung
Klicken Sie unter MATTER LOGGING TOOLS auf Gerätelogs, um die Seite Ressourcen zu öffnen, und wählen Sie zuerst SoC-Typ aus:
Wählen Sie dann das Matter-Gerät aus:
Danach kannst du alle Geräteprotokolle vom Gerät abrufen und mit Filtern wie Schweregrad und Suche nach relevanten Informationen suchen.
Alle Matter-Logs herunterladen
Klicken Sie unter QUICK ACCESS auf Logs herunterladen, um das Dialogfeld Logs herunterladen zu öffnen. Wählen Sie nun die herunterzuladenden Logs aus und klicken Sie auf OK.
Wählen Sie den Ordner aus, in dem Sie Protokolle herunterladen möchten, und klicken Sie auf Save (Speichern):
Danach werden die Protokolle im Zielordner gespeichert:
Extrahieren Sie die gespeicherte ZIP-Datei. Sie enthält Geräteinformationen und Protokolldateien.
Die Datei mit den Geräteinformationen enthält alle Versionsinformationen, die zur Fehlerbehebung erforderlich sind.
Feedback geben
Wenn Sie uns mitteilen möchten, wie wir die Entwicklung mit Google Home Extension verbessern können, haben Sie folgende Möglichkeiten:
- 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 ein Problem mit Google Home Extension zu melden.
- Auf der Seite Ressourcen befindet sich auch ein Feedbacksymbol.