Google Home-Erweiterung für VS Code

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.

Google Home-Erweiterung für VS Code

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.

Matter-Protokollierung der Google Home-Erweiterung

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:

  1. Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
  2. Suchen Sie nach google home und klicken Sie dann auf Installieren.

    Marketplace der Google Home-Erweiterung

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.

  1. Klicken Sie in der Aktivitätsleiste auf das Symbol für Google Home, um Google Home Extension zu öffnen.

    Symbol der Google Home-Erweiterung
  2. Klicken Sie auf Über Google anmelden, um die Anmeldeansicht im Browser zu öffnen.

    VS Code-Google-Anmeldung
  3. Wählen Sie das Konto aus, das mit Ihren Smart-Home-Geräten verknüpft ist.

  4. Klicken Sie auf der Autorisierungsseite Über Google anmelden auf Zulassen.

  5. 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.

    Dialogfeld „VS Code“ öffnen
  6. 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.

    Google Home-Erweiterung erlauben, URI zu öffnen
  7. Nach der Anmeldung lädt Google Home Extension Ihre Projekte. Wenn Sie fertig sind, klicken Sie auf Projekt auswählen.

    Projekt auswählen
  8. 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:

  1. Installieren Sie ADB auf Ihrem Computer.
  2. 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:

  1. Die meisten SoC-Geräte exportieren serielle Ports wie /dev/ttyUSBx unter Linux oder /dev/tty.SLAB_USBtoUART oder /dev/tty.usbserial unter macOS. Die Loganzeige kann das Protokoll direkt vom Gerät aus lesen.
  2. 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.

Ressourcen für das Google Home-System

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.

Google Assistant-Simulator verwenden

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.

    Menüsymbole für Batch-Äußerungen

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 .

    Symbol für die Ausführung von Äußerungen im Batch

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.

Cloud Logging verwenden

Nutzer können Logs nach Schweregrad und Zeitraum filtern.

Logs nach Schweregrad und Zeit 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).

Weitere Logs ansehen

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.

Home Graph-Betrachter

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.

Google Home-Test-Suite

Sie können sich die Testdetails und die Logs ansehen, nachdem alle Tests abgeschlossen sind.

Testergebnisse

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.

Android-Protokollierung

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.

Android Logging gefiltert

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:

Matter-Geräteprotokollierung

Wählen Sie als Nächstes das Matter-Gerät aus:

Matter-Geräteprotokollierung – Gerät auswählen

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.

Gefiltertes Logging von Matter-Geräten

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.

Matter-Protokolle herunterladen

Wählen Sie den Ordner aus, in dem Sie die Protokolle herunterladen möchten, und klicken Sie auf Speichern:

Matter-Protokollspeicher

Anschließend werden die Protokolle im Zielordner gespeichert:

Zielordner für Matter-Protokoll

Extrahieren Sie die gespeicherte ZIP-Datei. Die Geräteinformationen und Protokolldateien werden angezeigt.

ZIP-Datei mit Matter-Protokoll

Die Datei mit den Geräteinformationen enthält alle Versionsinformationen, die zum Beheben von Problemen erforderlich sind.

Fehlerbehebung im Matter-Log

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.
Symbol „Feedback geben“
  • Auf der Seite Ressourcen finden Sie jetzt ein Feedbacksymbol.