Google Home-Plug-in für Android Studio

Google Home Plugin for Android Studio wurde für Google Home Platform-Entwickler konzipiert und erstellt. Dieses Plug-in bietet Zugriff auf Google Assistant Simulator, Cloud Logging und andere Tools, um die Entwicklung von Smart-Home-Geräten zu vereinfachen.

Sicherheitshinweis

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

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.

Funktionen

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 Android Studio zu verlassen.

Ähnlich wie mit dem vorhandenen Assistant-Simulator in der Actions on Google Console-Konsole können Sie mit Assistant Simulator Ihre Geräte ganz einfach durch Eingabe von Abfragen steuern, 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.“

Cloud Logging ansehen

Google 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 Plugin während der Fehlerbehebung Echtzeit-Cloud Logging-Nachrichten direkt neben Ihrem Code an.

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

Batch-Äußerungen

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

• Ok, ich schalte 2 Lampen ein.
• Kein Problem, ich schalte 2 Lampen ein.
• Got it, turning 2 lights on.
• Alles klar, ich schalte zwei Leuchten ein.

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 die Assistant Simulator senden. Dazu müssen Sie Äußerungsskripts ausführen. Sobald ein Skript gespeichert ist, können Sie Antworten erfassen und mehrere Tests für Ihre Abfragen ausführen.

Home Graph-Anzeige

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

ADB-Loganzeige (Android Debug Bridge)

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

Installieren

So installieren Sie Google Home Plugin in Android Studio:

1. Android Studio herunterladen oder aktualisieren. Android Studio herunterladen
2. Gehen Sie zu Datei > Einstellungen (Android Studio > Einstellungen unter macOS).
3. Rufen Sie im Abschnitt Plug-ins den Marketplace auf 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 vom 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
• Cloud-Projekt auswählen

Ü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. Klicke auf der linken Seite des Fensters Android Studio in der Spalte für vertikale Tabs auf den Tab Google Home.

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

   

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 auswählen können.

Cloud-Projekt auswählen

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

Im Drop-down-Menü Projekt werden die ersten 100 Projekte anhand des festgelegten Filters geladen. Wenn Sie Android Studio beenden, wird Ihre Auswahl beibehalten.

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

Assistant-Simulator verwenden

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

Es gibt mehrere Möglichkeiten, Abfragen an Assistant Simulator zu senden. Als Nächstes werden wir alle Optionen 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 cached zum erneuten Senden am Ende der Abfrage klicken.

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

Klicken Sie auf save Speichern, um die Abfragen und Antworten zu speichern, die Sie im Bereich Äußerungen eingegeben haben. Ihre Interaktionen werden in das folgende Format in das JSON-Format 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 Datei mit Äußerungen, um die 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, funktionieren Collect und Test mit allen Äußerungen .json-Dateien in diesem Ordner.

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

Die Statusleiste zeigt das Ergebnis des letzten Tests (falls zutreffend), einen gelben oder grünen Punkt an, der angibt, ob die Datei erfasst wurde, und den Dateipfad .json für Äußerungen. Nachdem Sie auf tocErfassen geklickt haben, führt Assistant Simulator Ihre Abfragen aus. Sie werden benachrichtigt, wenn eine neue Antwort erfasst wird, und in der Statusleiste wird ein Zähler angezeigt, während Ihre Abfragen verarbeitet werden.

Wenn die Erfassung abgeschlossen ist, wird in der Statusleiste ein grünes Häkchen vor dem Pfad .json angezeigt und die Äußerungen werden mit möglichen Antworten gefüllt.

{
  "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 switch_left Testen, um die Abfragen noch einmal zu starten 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 werden. Wenn Ihr Test eine Antwort zurückgibt, die nicht erfasst wurde, erhalten Sie eine Benachrichtigung, die in etwa so aussieht:

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

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

Cloud Logging ansehen

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

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:

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

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 Datums- und Uhrzeitformat in das dafür vorgesehene Textfeld eingeben, z. B. 5/11/22, 12:37 PM, oder die Datumsauswahl calendar_month verwenden, um das Datum auszuwählen, und dann die Uhrzeit in das Textfeld eingeben.

• Wenn Sie ein Datum nach dem 5/1/22 auswählen möchten, wählen Sie Nach aus und klicken Sie auf das Datumssymbol calendar_month.
• Wenn Sie ein Datum vor dem 5/1/22 auswählen möchten, wählen Sie Vor aus und klicken Sie auf das Datumssymbol calendar_month.
• Wenn du ein Datum zwischen 5/1/22 und 6/30/22 auswählen möchtest, wähle Vor und Nach aus und klicke auf das Datumssymbol calendar_month, um die gewünschten Daten auszuwählen.

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

Wichtigkeitsstufe

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

Abfrageergebnisse

Klicken Sie auf cached Abrufen, um die Abfrageparameter zu senden.

Nachdem die Logs geladen wurden, klicken Sie auf einen beliebigen Eintrag chevron_right, um die vollständige JSON-Nutzlast zu maximieren. Klicken Sie noch einmal auf chevron_left, um die vollständige Nachricht aufzurufen.

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

Home Graph ansehen und Tests durchführen

Wähle im Bereich Google Home Plugin die Option Home Graph aus, um eine Liste deiner Geräte aufzurufen.

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

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

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

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

Sie können sich die Testdetails ansehen und die Logs aufrufen, sobald die Tests abgeschlossen sind.

ADB-Loganzeige (Android Debug Bridge)

Wenn Sie einen Projekt-Tab im Fenster des ADB-Logtools öffnen möchten, klicken Sie links in der Symbolleiste des Google Home-Plug-ins auf den Befehl Adb Log. Sie können separate ADB Log-Register für jede Ihrer Protokolldateien öffnen. Klicken Sie zum Löschen eines Tabs auf das Symbol clear.

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

In dem ausgewählten ADB-Log können Sie Logeinträge mithilfe des Felds Filter mit optionalen Groß-/Kleinschreibung oder Regex-Modifikatoren filtern.

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

• Über das Feld Suchen und die Befehle Nächstes suchen (arrow_downward-Symbol) und Vorherige suchen (Symbol arrow_upward) können Sie nach bestimmten Einträgen suchen.
• Verwenden Sie optionale Modifikatoren für Groß-/Kleinschreibung oder Regex.
• Mit Zu Zeile springen können Sie im Protokoll zu einer bestimmten Zeile (anhand der Zahl) springen.

Wählen Sie Nummeriert aus, um Protokollzeilen mit hinzugefügten Zeilennummern aufzurufen. Wählen Sie Rohdaten aus, um Rohlogeinträge anzusehen.

Ressourcen und Feedback

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

Wenn Sie uns Feedback geben möchten, wie wir die Entwicklung mit Google Home Plugin verbessern können, klicken Sie auf Feedback.