Die Google Home Plugin for Android Studio wurde für Entwickler der Google Home-Plattform entwickelt. Dieses Plug-in bietet Zugriff auf Google Assistant Simulator, Cloud Logging und andere Tools, die den Entwicklungsprozess für Smart-Home-Geräte vereinfachen.
Sicherheitshinweis
So verhindern Sie, dass Android Studio Geheimnisse und Passwörter speichert:
- Klicken Sie auf Datei und dann auf Einstellungen.
- Maximieren Sie unter Darstellung und Verhalten die Option Systemeinstellungen und klicken Sie dann auf Passwörter.
- Wählen Sie Nicht speichern, Passwörter nach Neustart vergessen aus.
Funktionen
Assistant-Simulator
Wenn Sie testen möchten, ob Ihre Smart-Home-Geräte richtig mit dem Google Home-System funktionieren, können Sie jederzeit mit Assistant Simulator interagieren, ohne Android Studio zu verlassen.
Mit der Assistant Simulator können Sie Ihre Geräte ganz einfach per Eingabe steuern, z. B. „Schalte das Licht ein“. In Android Studio antwortet Assistant Simulator mit Nachrichten, die auf Ihren Befehlen basieren, z. B. „In Ordnung, ich schalte das Licht ein.“
Cloud Logging aufrufen
Google 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 Plugin während der Fehlerbehebung Echtzeit-Cloud Logging-Nachrichten direkt neben dem Code angezeigt.
Sie können Echtzeitprotokolle anzeigen oder einen Zeitraum auswählen.
Batch-Sätze
Assistant Simulator Antworten auf eine einzelne Äußerung sind nicht deterministisch. Eine Antwort könnte beispielsweise eine der folgenden Formulierungen sein:
- Ok, ich schalte zwei Lampen ein.
- Alles klar, ich schalte zwei Lampen ein.
- Ok, ich schalte zwei Lampen ein.
- Alles klar, ich schalte zwei Lampen 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-Sätze an die Assistant Simulator senden, indem Sie Sätzeskripts ausführen. Nachdem ein Script gespeichert wurde, können Sie Antworten erfassen und mehrere Tests für Ihre Abfragen ausführen.
Home Graph-Betrachter
Mit dem Home Graph Viewer können Sie den Status Ihrer Geräte anzeigen und die Google Home Test Suite in Ihrem Browser starten.
Android Debug Bridge (adb) Log Viewer
Adb Log Viewer ist ein Tool zum Ansehen und Analysieren von Protokolldateien, z. B. Matter-Geräteprotokolldateien, Google Home-Protokolle und Android-Protokolle.
Installieren
So installieren Sie die Google Home Plugin in Android Studio:
- Android Studio herunterladen oder aktualisieren.
- Wählen Sie Datei > Einstellungen aus (Android Studio > Einstellungen unter macOS).
- Klicken Sie im Bereich Plug-ins auf Marketplace und suchen Sie nach
google home. - Installieren Sie das Tool und starten Sie Android Studio neu.
Sie können das Plug-in auch direkt über den 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
Sie können sich über das Google Home-Steuerfeld in Ihrem Entwicklerkonto anmelden und Android Studio berechtigen, in Ihrem Namen mit Google-Diensten zu kommunizieren.
Klicken Sie in der vertikalen Tab-Spalte auf der linken Seite des Android Studio-Fensters auf den Tab Google Home.
Klicken Sie unter Über auf Google, um Ihren 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.
Schließen Sie das Browserfenster und kehren Sie zu Android Studio zurück.
Sie sollten jetzt angemeldet sein und die Option Abmelden sehen.
Cloud-Projekt auswählen
Wählen Sie nach der Anmeldung im Drop-down-Menü ein Projekt aus. Wenn Sie die Projektliste filtern möchten, geben Sie einen Filter-Ausdruck ein, z. B. matter, und drücken Sie dann Enter.
Über das Drop-down-Menü Projekt werden die ersten 100 Projekte basierend auf Ihrem Filter geladen. Ihre Auswahl bleibt erhalten, wenn Sie Android Studio schließen.
Informationen zu Projektfiltern finden Sie in der Google Cloud-Referenz unter Abfrageparameter.
Assistant-Simulator verwenden
Wenn Sie die Assistant Simulator in Android Studio öffnen möchten, klicken Sie im Bereich Google Home Plugin auf Utterances Panel (Bereich für Äußerungen).
Es gibt mehrere Möglichkeiten, Abfragen an die Assistant Simulator zu senden. Sehen wir uns die einzelnen Optionen an.
Abfragen eingeben und Antworten erfassen
Wenn Sie mit Assistant Simulator interagieren möchten, geben Sie Ihre Suchanfrage ein und drücken Sie die Eingabetaste.
Sie können eine Abfrage noch einmal senden, indem Sie am Ende der Abfrage auf das Symbol zum Senden klicken.
Nachdem Sie eine oder mehrere Abfragen gesendet haben, klicken Sie auf Wiedergeben, um die Abfragen noch einmal auszuführen und die Antworten zu überprüfen. Im Bereich Sätze werden Ihre Suchanfragen und Antworten in einem gespeicherten Cache erfasst. Mit Wiedergabe werden nur neue Antworten in diesen internen Cache aufgenommen. Ihre Abfragen werden nicht jedes Mal dupliziert, wenn Sie auf die Schaltfläche klicken.
Klicken Sie auf Speichern, um die Abfragen und Antworten zu speichern, die Sie im Bereich Sätze eingegeben haben. Ihre Interaktionen werden in JSON im folgenden Format konvertiert:
ask: Ihre Suchanfrage.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 File (Satzdatei), um Ihre gespeicherten JSON-Dateien in einem neuen Tab zu öffnen. Wählen Sie unter Pfad auswählen eine Datei oder einen Ordner aus. Wenn Sie einen Ordner auswählen, werden die Optionen Erfassen und Testen auf alle .json-Dateien mit Äußerungen in diesem Ordner angewendet.
Sie können mehrere Tabs für dieselbe Datei oder für verschiedene Dateien öffnen, z. B. lights, lights(1) und plug.
In der Statusleiste sehen Sie das Ergebnis des letzten Tests (falls zutreffend), einen gelben oder grünen Punkt, der angibt, ob die Datei erfasst wurde, und den Dateipfad .json der Äußerung. Nachdem Sie auf Erfassen geklickt haben, werden Ihre Abfragen vom Assistant Simulator ausgeführt.
Sie werden benachrichtigt, wenn eine neue Antwort erfasst wird. In der Statusleiste wird ein Zähler angezeigt, während Ihre Abfragen verarbeitet werden.
Wenn Erfassen abgeschlossen ist, wird in der Statusleiste vor dem Pfad .json ein grünes Häkchen angezeigt und Ihre Äußerungsdateien 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 Pfad .json nicht als erfasst markiert.
Batch-Äußerungen testen
Nachdem Sie die Antworten erfasst haben, klicken Sie auf Test, um die Abfragen noch einmal auszuführen und die Antworten und Protokolle zu prüfen. Wenn Sie Batch-Sätze testen, erwartet Assistant Simulator die Antworten, die in Ihrer JSON-Datei gespeichert sind. Wenn Ihr Test eine Antwort zurückgibt, die nicht erfasst wurde, erhalten Sie eine Benachrichtigung, die der folgenden ähnelt:
Expected one of: "Got it, turning on
2 lights."
Dieses Szenario weist 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 Häkchen angezeigt.
Cloud Logging aufrufen
Wenn Sie einen Projekttab im Fenster des Cloud Logging-Tools öffnen möchten, klicken Sie im Bereich Google Home Plugin auf Cloud Logging. Sie können für jedes Ihrer Projekte separate Cloud Logs-Tabs öffnen.
Suchbegriffe
Für das ausgewählte Projekt können Sie Protokolle auch über das Feld Abfrage filtern.
So filtern Sie Protokolle beispielsweise nach dem Keyword 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"
Abfragen zu Datum und Uhrzeit
Sie können Protokolle auch nach Datum abfragen. Klicken Sie dazu auf Nach und Vor. Sie können das Datums- und Uhrzeitformat in das bereitgestellte Textfeld eingeben, z. B. 5/11/22, 12:37 PM. Sie können auch die Datumsauswahl verwenden, um das Datum auszuwählen, und dann die Uhrzeit in das Textfeld eingeben.
- Wenn Sie ein Datum nach dem
5/1/22auswählen möchten, wählen Sie Nach aus und klicken Sie auf das Datumssymbol . - Wenn Sie ein Datum vor dem
5/1/22auswählen möchten, wählen Sie Vor aus und klicken Sie auf das Datumssymbol . - Wenn Sie ein Datum zwischen dem
5/1/22und dem6/30/22auswählen möchten, wählen Sie Vor und Nach aus und wählen Sie die gewünschten Datumsangaben über das Datumssymbol aus.
Wählen Sie Echtzeit aus, um Live-Projektprotokolle abzurufen. Klicken Sie auf Beenden, um einen Echtzeitfeed zu beenden.
Wichtigkeitsstufe
Sie können auch eine Minimale Wichtigkeit aus dem Drop-down-Menü auswählen.
Abfrageergebnisse
Klicken Sie auf Abrufen, um Ihre Abfrageparameter zu senden.
Klicken Sie nach dem Laden der Protokolle auf einen beliebigen Eintrag , um die gesamte JSON-Nutzlast zu maximieren. Klicken Sie noch einmal auf , um die vollständige Nachricht zu sehen.
Optional können Sie ein Keyword in das Feld Filter eingeben, um die Protokollergebnisse einzugrenzen. Klicken Sie auf x, um den Filter zu entfernen und zu den ursprünglichen Abrufergebnissen zurückzukehren.
Startseite-Grafik aufrufen und Tests ausführen
Wenn Sie eine Liste Ihrer Geräte aufrufen möchten, wählen Sie im Steuerfeld Google Home Plugin die Option Zuhause-Diagramm aus.
Klicken Sie auf Aktualisieren, um den Gerätenamen, die Geräte-ID und den Gerätetyp für die mit dem ausgewählten Projekt verknüpften Geräte aufzurufen. 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 , um die vollständige JSON-Nutzlast zu maximieren.
Mit Maximieren und Minimieren können Sie die JSON-Nutzlast für Ihre Geräte ein- und ausblenden.
Wenn Sie die Testsuite für ein bestimmtes Gerät starten möchten, klicken Sie auf Testen. 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.
Nach Abschluss der Tests können Sie die Testdetails und die Protokolle einsehen.
Android Debug Bridge (adb) Log Viewer
Wenn Sie einen Projekttab im Fenster des Adb Log-Tools öffnen möchten, klicken Sie in der Symbolleiste des Google Home-Plug-ins (links) auf den Befehl Adb Log. Sie können für jede Protokolldatei einen separaten Adb-Protokolltab öffnen. Wenn Sie einen Tab löschen möchten, klicken Sie auf das Symbol .
Wählen Sie im Feld Auswählen eine bestimmte Logging-Komponente aus, die Sie sich ansehen möchten, und im Drop-down-Menü Schweregrad nur Einträge mit dem entsprechenden Log-Schweregrad.
Für das ausgewählte adb-Protokoll können Sie Logeinträge mithilfe des Felds Filter mit den optionalen Modifikatoren Groß- und Kleinschreibung berücksichtigen oder Regex filtern.
Sie können auch regelmäßiger Leser eines Blogs oder einer URL
- Mit dem Feld Suchen und den Befehlen Nächstes Element suchen (-Symbol) und Vorheriges Element suchen (-Symbol) können Sie bestimmte Einträge finden.
- Verwenden Sie optional die Modifikatoren Groß- und Kleinschreibung berücksichtigen oder Regex.
- Zur Zeile springen, um zu einer bestimmten Zeile (anhand der Nummer) im Protokoll zu springen.
Wählen Sie Nummeriert aus, um Logzeilen mit hinzugefügten Zeilennummern zu sehen. Wählen Sie Roh aus, um Roh-Logeinträge aufzurufen.
Ressourcen und Feedback
Klicken Sie auf Ressourcen, um eine Liste der Entwicklertools und ‑ressourcen aufzurufen.
Wenn Sie uns Ihre Meinung oder Feedback dazu geben möchten, wie wir die Entwicklung mit der Google Home Plugin verbessern können, klicken Sie auf Feedback.
