Google Home-Plug-in für Android Studio

Das Google Home Plugin for Android Studio wurde für Google Home Platform-Entwickler entwickelt. Mit diesem Plug-in erhalten Sie Zugriff auf Google Assistant Simulator, Cloud Logging und andere Tools, um die Entwicklung Ihres Smart Homes zu vereinfachen.

Google Home-Plug-in für Android Studio

Sicherheitshinweis

Führen Sie die folgenden Schritte aus, um zu verhindern, dass Android Studio Secrets und Passwörter speichert:

  1. Klicken Sie auf Datei und dann auf Einstellungen....
  2. Maximieren Sie unter Darstellung und Verhalten die Option Systemeinstellungen und klicken Sie dann auf Passwörter.
  3. Wählen Sie Nicht speichern, Passwörter nach Neustart vergessen aus.
Google Home-Plug-in für Android Studio

Features

Assistant-Simulator

Du kannst jederzeit mit Assistant Simulator interagieren, ohne Android Studio zu verlassen, um zu testen, ob deine Smart-Home-Geräte ordnungsgemäß mit der Google Home-Umgebung funktionieren.

Ähnlich wie mit dem Assistant-Simulator, der in der Actions on Google Console-Konsole bereitgestellt wird, kannst du mit Assistant Simulator deine Geräte einfach steuern, indem du deine Anfragen eingibst, z. B. „Schalte das Licht ein“. Innerhalb von Android Studio antwortet Assistant Simulator mit Textnachrichten, die auf Ihren Befehlen basieren, z. B. „Alles klar, das Licht wird eingeschaltet.“

Mit Assistant-Simulator testen

Cloud Logging ansehen

Google Cloud Logging bietet Informationen zur Fehlerbehebung und wichtige Messwerte, um dir einen Einblick in die Nutzung deiner Aktion zu geben. Zur Vereinfachung der Entwicklung zeigt Google Home Plugin bei der Fehlerbehebung Echtzeit-Cloud Logging-Meldungen direkt neben dem Code an.

Sie können Echtzeitprotokolle aufrufen oder einen Zeitraum auswählen.

Cloud Logging-Ansicht

Batch-Äußerungen

Assistant Simulator-Antworten auf eine einzelne Äußerung sind nicht deterministisch. Eine Antwort kann beispielsweise eine der folgenden Formulierungen sein:

  • Verstanden, ich schalte zwei Leuchten ein.
  • Natürlich, zwei Leuchten werden eingeschaltet.
  • Verstanden, ich schalte zwei Leuchten an.
  • Alles klar, zwei Leuchten werden eingeschaltet.

Wenn Sie automatisierte Tests ausführen und prüfen möchten, wie Ihre Google-Integrationen mit diesen verschiedenen Antworten funktionieren, können Sie Batchäußerungen an Assistant Simulator senden. Dazu führen Sie Sprachskripts aus. Sobald ein Skript gespeichert ist, können Sie Antworten erfassen und mehrere Tests für Ihre Abfragen ausführen.

Home Graph-Betrachter

Mit dem Home Graph Viewer kannst du den Status deiner Geräte anzeigen und die Google Home Test Suite in deinem Browser starten.

Android Debug Bridge (adb)-Loganzeige

Die ADB-Loganzeige ist ein Tool zum Ansehen und Analysieren von Protokolldateien, z. B. Matter-Geräteprotokolldateien, Google Home-Protokollen und Android-Protokollen.

Installieren

So installieren Sie Google Home Plugin in Android Studio:

  1. Laden Sie Android Studio herunter oder aktualisieren Sie die App. Android Studio herunterladen
  2. Rufen Sie Datei > Einstellungen (Android Studio > Einstellungen unter macOS) auf.
  3. Gehen Sie im Abschnitt Plug-ins zu Marketplace und suchen Sie nach google home.
  4. Installieren Sie das Tool und starten Sie Android Studio neu.

Sie können das Plug-in auch direkt aus dem JetBrains Marketplace herunterladen.

Einrichtung

Nachdem Sie das Plug-in installiert haben, müssen Sie die folgenden Schritte ausführen, bevor Sie Assistant Simulator verwenden und Cloud Logging aufrufen können:

Über Google anmelden

Du kannst dich über das Google Home-Steuerfeld in deinem Entwicklerkonto anmelden und Android Studio autorisieren, in deinem Namen mit Google-Diensten zu kommunizieren.

  1. Klicken Sie auf den Tab Google Home in der vertikalen Tabspalte auf der linken Seite des Fensters Android Studio.

  2. Klicken Sie unter Anmelden mit auf Google, um den Browser zu starten.

    Android Studio – 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. Schließen Sie das Browserfenster und kehren Sie zu Android Studio zurück.

Sie sollten jetzt angemeldet sein und die Option Abmelden haben.

Cloud-Projekt auswählen

Wählen Sie nach der Anmeldung ein Projekt aus dem Drop-down-Menü aus. Geben Sie zum Filtern der Projektliste einen Filter-Ausdruck ein, z. B. matter, und drücken Sie Enter.

Im Drop-down-Menü Projekt werden die ersten 100 Projekte gemäß Ihrem Filter geladen. Ihre Auswahl wird beibehalten, wenn Sie Android Studio beenden.

Projekt auswählen

Informationen zu Projektfiltern finden Sie in der Google Cloud-Referenz unter Abfrageparameter.

Assistant-Simulator verwenden

Klicken Sie zum Öffnen von Assistant Simulator in Android Studio im Feld Google Home Plugin auf Bereich „Äußerungen“.

Bereich „Äußerungen“ öffnen

Es gibt mehrere Möglichkeiten, Abfragen an Assistant Simulator zu senden. Als Nächstes werden wir jede Option besprechen.

Abfragen eingeben und Antworten sammeln

Geben Sie Ihre Abfrage ein und drücken Sie die Eingabetaste, um mit Assistant Simulator zu interagieren.

Sie können eine Abfrage noch einmal senden, indem Sie auf das Symbol zum erneuten Senden am Ende der Abfrage klicken.

Nachdem Sie eine oder mehrere Abfragen gesendet haben, klicken Sie auf Noch einmal abspielen, um die Abfragen noch einmal auszuführen und Ihre Antworten zu prüfen. Im Bereich Äußerungen werden Ihre Abfragen und Antworten in einem gespeicherten Cache angezeigt. Bei der Option Noch einmal abspielen werden diesem internen Cache nur neue Antworten hinzugefügt. Ihre Abfragen werden nicht jedes Mal dupliziert, wenn Sie auf die Schaltfläche klicken.

Äußerungen mit Assistant Simulator noch einmal abspielen

Klicken Sie auf Speichern, um die Abfragen und Antworten zu speichern, die Sie im Bereich Äußerungen eingegeben haben. Ihre Interaktionen werden im folgenden Format in JSON konvertiert:

  • ask: Ihre Abfrage.
  • answers: ein Array möglicher Assistant Simulator-Antworten.

Sie können diese JSON-Datei in Android Studio bearbeiten.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

Batchantworten erfassen

Klicken Sie im Bereich Google Home Plugin auf Utterances-Datei, um Ihre gespeicherten JSON-Dateien in einem neuen Tab zu öffnen. Unter Pfad auswählen können Sie eine Datei oder einen Ordner auswählen. Wenn Sie einen Ordner auswählen, werden Collect und Test für alle .json-Dateien der Äußerungen in diesem Ordner verwendet.

Sie können mehrere Tabs für dieselbe oder unterschiedliche Dateien öffnen, z. B. lights, lights(1) und plug.

In der Statusleiste werden das Ergebnis des letzten Tests (falls zutreffend), ein gelber oder grüner Punkt, der angibt, ob die Datei erfasst wurde, und der Dateipfad der Äußerung .json angezeigt. Nachdem Sie auf Erfassen geklickt haben, führt Assistant Simulator Ihre Abfragen aus. Sie werden benachrichtigt, wenn eine neue Antwort vorliegt. In der Statusleiste wird während der Verarbeitung Ihrer Abfragen ein Zähler angezeigt.

Mit dem Assistant-Simulator Äußerungen erfassen

Wenn Collect abgeschlossen ist, wird die Statusleiste mit einem grünen Häkchen vor dem Pfad .json aktualisiert und Ihre Äußerungsdateien werden mit möglichen Antworten gefüllt.

Mit dem Assistant-Simulator Äußerungen erfassen
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

Wenn Sie die Erfassung vorzeitig beenden, wird der .json-Pfad nicht als erfasst markiert.

Batchäußerungen testen

Nachdem Sie die Antworten erfasst haben, klicken Sie auf Testen, um die Abfragen noch einmal wiederzugeben und die Antworten und Logs zu prüfen. Wenn Sie Batchäußerungen testen, erwartet Assistant Simulator die Antworten, die in der JSON-Datei gespeichert sind. Wenn Ihr Test eine Antwort zurückgibt, die noch nicht erfasst wurde, erhalten Sie eine Benachrichtigung, die der folgenden Antwort ähnelt:

Expected one of: "Got it, turning on 2 lights."

Äußerungen mit dem Assistant-Simulator ausführen

Dieses Szenario deutet auf einen fehlgeschlagenen Test hin. Andernfalls führt Assistant Simulator jede Ihrer Abfragen aus und gibt eine Antwort zurück. Wenn der Test erfolgreich war, wird in der Statusleiste ein -Symbol angezeigt.

Äußerungen mit dem Assistant-Simulator ausführen

Cloud Logging ansehen

Klicken Sie zum Öffnen eines Projekttabs im Fenster des Cloud Logs-Tools im Bereich Google Home Plugin auf Cloud Logs. Sie können für jedes Ihrer Projekte separate Cloud Log-Tabs öffnen.

Cloud Logging-Tabs

Suchbegriffe

Für das ausgewählte Projekt können Sie Logs auch mithilfe des Felds Abfrage filtern. So filtern Sie beispielsweise Logs nach dem Schlüsselwort light:

Cloud Logging-Abfrage

Wählen Sie QL verwenden aus, um die Logging-Abfragesprache zu verwenden.

Cloud Logging-Abfragesprache

Hier sind einige Beispiele für QL-Abfragen, die Ihnen den Einstieg erleichtern:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

Datums- und Uhrzeitabfragen

Das Abfragen von Logs nach Datum ist ebenfalls optional und kann durch Klicken auf Nach und Vor aktiviert werden. Sie können das Format für Datum und Uhrzeit in das Textfeld eingeben, z. B. 5/11/22, 12:37 PM. Alternativ können Sie das Datum über die Datumsauswahl auswählen und dann die Uhrzeit in das Textfeld eingeben.

  • Wenn Sie ein Datum nach dem 5/1/22 festlegen möchten, wählen Sie Nach aus und klicken Sie auf das Datumssymbol .
  • Wenn Sie ein Datum vor dem 5/1/22 auswählen möchten, wählen Sie Vor aus und klicken auf das Datumssymbol .
  • Wenn Sie ein Datum zwischen 5/1/22 und 6/30/22 festlegen möchten, wählen Sie Vor und Nach und dann über das Datumssymbol den gewünschten Zeitraum aus.

Wählen Sie Echtzeit aus, um Live-Projektlogs abzurufen. Klicken Sie auf Beenden, um einen Echtzeitfeed zu beenden.

Schweregrad

Sie können im Drop-down-Menü auch einen Minimalen Schweregrad auswählen.

Abfrageergebnisse

Klicken Sie auf Abrufen, um die Abfrageparameter zu senden.

Klicken Sie nach dem Laden der Logs auf einen beliebigen Eintrag , um die vollständige JSON-Nutzlast zu maximieren. Klicken Sie noch einmal auf , um die vollständige Nachricht aufzurufen.

Optional können Sie ein Schlüsselwort in das Feld Filter eingeben, um die Logergebnisse einzuschränken. Klicken Sie auf x, um den Filter zu entfernen und zu den ursprünglichen Abrufergebnissen zurückzukehren.

Cloud Logging ansehen

Home Graph anzeigen und Tests durchführen

Wenn Sie Ihre Geräte auflisten möchten, wählen Sie im Bereich Google Home Plugin die Option Home Graph aus.

Klicken Sie auf Aktualisieren, um den Gerätenamen, die Geräte-ID und den Gerätetyp für die Geräte aufzurufen, die mit dem ausgewählten Projekt verknüpft sind. Sie können mehrere Google Home Graph-Bereiche für separate Projekte geöffnet haben.

Wenn die Geräte geladen sind, klicken Sie auf einen beliebigen Eintrag , um die vollständige JSON-Nutzlast zu maximieren.

Home Graph-JSON-Nutzlast

Sie können auch Maximieren und Minimieren verwenden, um die JSON-Nutzlasten für Ihre Geräte ein- und auszublenden.

Home Graph – JSON maximieren und minimieren

Wenn Sie die Test-Suite für ein bestimmtes Gerät starten möchten, klicken Sie auf Testen. Dadurch wird die Test-Suite in Ihrem Browser gestartet. Das Gerät ist ausgewählt und zum Testen bereit. Klicken Sie auf Starten und warten Sie auf die Testergebnisse.

Home Graph-Ausführungstests

Sie können die Testdetails und die Protokolle aufrufen, sobald die Tests abgeschlossen sind.

Home Graph – Abgeschlossene Tests

Android Debug Bridge (adb)-Loganzeige

Klicken Sie zum Öffnen eines Projekt-Tabs im Fenster des ADB-Log-Tools auf den Befehl Adb Log in der Symbolleiste des Google Home-Plug-ins (links). Sie können für jede Protokolldateien einen separaten Tab mit ADB-Logs öffnen. Klicken Sie zum Löschen eines Tabs auf das Symbol .

Verwenden Sie das Feld Auswählen, um eine bestimmte Logging-Komponente zur Anzeige auszuwählen, und das Drop-down-Menü Schweregrad, um nur Einträge mit dem entsprechenden Logschweregrad anzuzeigen.

Sie können Logeinträge für das ausgewählte ADB-Log filtern, indem Sie das Feld Filter mit optionalen Modifizierern für Groß-/Kleinschreibung beachten oder Regex verwenden.

Sie können auch regelmäßiger Leser eines Blogs oder einer URL

  • Mit dem Feld Suchen und den Befehlen Weitersuchen () bzw. Vorherige suchen (Symbol ) können Sie nach bestimmten Einträgen suchen.
  • Verwenden Sie optionale Modifikatoren, bei denen die Groß-/Kleinschreibung beachten und die Regex-Modifikatoren verwendet werden.
  • Zu Zeile springen, um im Protokoll zu einer bestimmten Zeile (nach Zahl) zu springen.

Wählen Sie Nummeriert aus, um Protokollzeilen mit hinzugefügten Zeilennummern aufzurufen. Wählen Sie Raw (Rohdaten) aus, um unformatierte Logeinträge anzusehen.

ADB-Loganzeige

Ressourcen und Feedback

Klicken Sie auf Ressourcen, um eine Liste der Entwicklertools und Ressourcen aufzurufen.

Klicke auf Feedback, um uns Feedback zur Verbesserung der Entwicklungsumgebung mit Google Home Plugin zu senden.

Feedback geben