Google Home Plugin for Android Studio wurde für die Google Home Platform-Entwickler entwickelt und erstellt. Dieses Plug-in bietet Zugriff auf Google Assistant Simulator, Cloud Logging und andere Tools, um die Entwicklung Ihres Smart Homes zu vereinfachen.
Sicherheitshinweis
Führen Sie die folgenden Schritte aus, um zu verhindern, dass Android Studio Secrets 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 dem Neustart vergessen aus.
Features
Assistant-Simulator
Wenn du testen möchtest, ob deine Smart-Home-Geräte mit Google Home kompatibel sind, kannst du jederzeit mit Assistant Simulator interagieren, ohne Android Studio zu verlassen.
Ähnlich wie beim vorhandenen Assistant-Simulator in der Actions on Google Console-Konsole können Sie mit Assistant Simulator Ihre Geräte ganz einfach steuern, indem Sie Ihre Anfragen eingeben, z. B.: „Schalte das Licht ein“. In Android Studio antwortet Assistant Simulator mit Textnachrichten, die auf deinen Befehlen basieren, z. B. „Alles klar, ich schalte das Licht ein.“
Cloud Logging ansehen
Google Cloud Logging bietet Debugging-Informationen und wichtige Messwerte, die Ihnen Informationen zur Nutzung Ihrer Aktion liefern. Zur Vereinfachung der Entwicklung zeigt Google Home Plugin während der Fehlerbehebung Cloud Logging-Echtzeitnachrichten direkt neben Ihrem Code an.
Sie können Protokolle in Echtzeit anzeigen oder einen Zeitraum auswählen.
Batch-Äußerungen
Assistant Simulator-Antworten auf eine einzelne Äußerung sind nicht deterministisch. Als Antwort kann eine der folgenden Wortgruppen zurückgegeben werden:
- Ok, ich schalte 2 Lampen ein.
- Ok, 2 Lampen werden eingeschaltet.
- Alles klar, 2 Lampen werden eingeschaltet.
- In Ordnung, 2 Lampen werden eingeschaltet.
Um automatisierte Tests auszuführen und zu prüfen, wie Ihre Google-Integrationen mit diesen verschiedenen Antworten funktionieren, können Sie Batch-Äußerungen an Assistant Simulator senden, indem Sie Äußerungsskripts ausführen. Nachdem ein Skript gespeichert wurde, können Sie Antworten erfassen und mehrere Tests für Ihre Abfragen ausführen.
Startseitendiagramm-Betrachter
Mit dem Home Graph Viewer können Sie den Status Ihrer Geräte anzeigen lassen und die Google Home Test Suite in Ihrem Browser starten.
Loganzeige für Android Debug Bridge (adb)
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:
- Android Studio herunterladen oder aktualisieren. Android Studio herunterladen
- Gehen Sie zu Datei > Einstellungen (Android Studio > Einstellungen unter macOS).
- Gehen Sie im Bereich Plug-ins zu 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 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 ansehen können:
Über Google anmelden
Sie können sich über das Google Home-Steuerfeld in Ihrem Entwicklerkonto anmelden und Android Studio autorisieren, in Ihrem Namen mit Google-Diensten zu kommunizieren.
Klicken Sie links im Fenster Android Studio in der Spalte „Vertikaler Tab“ auf den Tab Google Home.
Klicken Sie bei Anmelden mit auf Google, um den 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.
Jetzt sollten Sie angemeldet sein und die Option Abmelden haben.
Cloud-Projekt auswählen
Wählen Sie nach der Anmeldung im Drop-down-Menü ein Projekt aus. Geben Sie zum Filtern Ihrer Projektliste einen Filterausdruck ein, z. B. matter, und drücken Sie dann Enter.
Im Drop-down-Menü Projekt werden die ersten 100 Projekte auf der Grundlage Ihres Filters geladen. Ihre Auswahl wird beim Beenden von Android Studio beibehalten.
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 Bereich Google Home Plugin auf Bereiche.
Es gibt mehrere Möglichkeiten, Abfragen an Assistant Simulator zu senden. Als Nächstes sehen wir uns jede Option an.
Abfragen eingeben und Antworten erfassen
Geben Sie die Abfrage ein und drücken Sie die Eingabetaste, um mit Assistant Simulator zu interagieren.
Sie können eine Abfrage noch einmal senden, wenn Sie auf das Symbol zum erneuten Senden am Ende der Abfrage klicken.
Nachdem Sie eine oder mehrere Abfragen gesendet haben, klicken Sie auf Wiederholen, um die Abfragen noch einmal auszuführen und die Antworten zu prüfen. Im Bereich Utterances werden Ihre Abfragen und Antworten in einem gespeicherten Cache gespeichert. Replay fügt diesem internen Cache nur neue Antworten hinzu und dupliziert Ihre Abfragen nicht jedes Mal, wenn Sie auf die Schaltfläche klicken.
Klicken Sie auf Speichern, um die Abfragen und Antworten zu speichern, die Sie im Bereich Äußerungen eingegeben haben. Ihre Interaktionen werden im JSON-Format in folgendem 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."
]
}
]
}
Batch-Antworten erfassen
Klicken Sie im Bereich Google Home Plugin auf Utterance File (Datei der Äußerung), um die gespeicherten JSON-Dateien in einem neuen Tab zu öffnen. Für Pfad auswählen können Sie eine Datei oder einen Ordner auswählen. Wenn Sie einen Ordner auswählen, funktionieren Erheben und Testen bei allen Äußerungen von .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) sowie einen gelben oder grünen Punkt, der angibt, ob die Datei erfasst wurde, und den Dateipfad .json. Nachdem Sie auf Erfassen geklickt haben, führt Assistant Simulator Ihre Abfragen aus.
Sie werden benachrichtigt, wenn eine neue Antwort erfasst wird. Außerdem wird in der Statusleiste ein Zähler angezeigt, während Ihre Abfragen verarbeitet werden.
Wenn Erfassen abgeschlossen ist, wird die Statusleiste vor Ihrem .json-Pfad mit einem grünen Häkchen aktualisiert und die Äußerungen werden mit möglichen Antworten befü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 Sammlung frühzeitig beenden, wird der Pfad .json nicht als erfasst markiert.
Batch-Äußerungen testen
Nachdem Sie Ihre Antworten erfasst haben, klicken Sie auf Testen, um die Abfragen noch einmal abzuspielen und die Antworten und Logs zu prüfen. Wenn Sie Batch-Äußerungen testen, erwartet Assistant Simulator, dass die Antworten in Ihrer JSON-Datei gespeichert werden. Wenn bei Ihrem Test eine Antwort zurückgegeben wird, die nicht erhoben wurde, erhalten Sie eine Benachrichtigung, die der folgenden Antwort ähnelt:
Expected one of: "Got it, turning on
2 lights."
Dieses Szenario weist auf einen fehlgeschlagenen Test hin. Andernfalls führt Assistant Simulator alle Abfragen aus und gibt eine Antwort zurück. Wenn der Test erfolgreich war, wird in der Statusleiste die -Prüfung angezeigt.
Cloud Logging ansehen
Zum Öffnen eines Tabs im Projekt im Fenster „Cloud Logs“ klicken Sie im Bereich Google Home Plugin auf Cloud Logs. Sie können für jedes Ihrer Projekte separate Cloud Log-Tabs öffnen.
Suchbegriffe
Sie können Logs für das ausgewählte Projekt auch mit dem Feld Abfrage filtern.
So filtern Sie Logs für ein Keyword von light:
Wählen Sie QL verwenden aus, um die Logging-Abfragesprache zu verwenden.
Im Folgenden finden Sie 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 aktiviert werden, indem Sie auf Nach und Vorher klicken. Sie können das Datums- und Uhrzeitformat in das Textfeld eingeben, z. B. 5/11/22, 12:37 PM, oder mit der Datumsauswahl auswählen. Geben Sie dann die Uhrzeit in das Textfeld ein.
- 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 Vorher aus und klicken Sie dann auf das Datumssymbol . - Wenn Sie ein Datum zwischen
5/1/22und6/30/22auswählen möchten, wählen Sie Vor und Nach aus und wählen Sie dann die Datumsangaben aus dem Datumssymbol aus.
Wählen Sie Echtzeit aus, um die Live-Projektprotokolle abzurufen. Klicken Sie auf Beenden, um den Echtzeitfeed zu beenden.
Schweregrad
Sie können auch im Drop-down-Menü einen 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 Mitteilung aufzurufen.
Optional können Sie im Feld Filter einen Suchbegriff eingeben, um die Logergebnisse einzugrenzen. Klicken Sie auf x, um den Filter zu entfernen und zu den ursprünglichen Abrufergebnissen zurückzukehren.
Home Graph anzeigen und Tests ausführen
Wählen Sie im Bereich Google Home Plugin die Option Home Graph aus, um Ihre Geräte aufzulisten.
Klicken Sie auf Aktualisieren, um Gerätename, Geräte-ID und Gerätetyp für Ihre Geräte aufzurufen, die mit dem ausgewählten Projekt verknüpft sind. Sie können mehrere Google Home Graph-Bereiche für separate Projekte öffnen.
Klicken Sie nach dem Laden Ihrer Geräte auf einen beliebigen Eintrag , um die vollständige JSON-Nutzlast zu maximieren.
Sie können die JSON-Nutzlast für Ihre Geräte auch über Maximieren und Minimieren ein- und ausblenden.
Klicken Sie zum Starten der Test Suite für ein bestimmtes Gerät auf Test. Dadurch wird die Test-Suite in Ihrem Browser gestartet. Ihr Gerät ist ausgewählt und bereit zum Testen. Klicken Sie auf Start und warten Sie auf die Testergebnisse.
Sie können die Testdetails aufrufen und die Protokolle aufrufen, sobald die Tests abgeschlossen sind.
Loganzeige für Android Debug Bridge (adb)
Klicken Sie zum Öffnen eines Projekttabs im Fenster des Tools für ADB Log in der Symbolleiste des Google Home-Plug-ins (links) auf den Befehl Adb Log. Sie können separate ADB-Log-Tabs für jede Ihrer Protokolldateien öffnen. Klicken Sie auf das Symbol , um einen Tab zu löschen.
Wählen Sie im Feld Auswählen eine bestimmte Logging-Komponente aus, die Sie ansehen möchten, und im Drop-down-Menü Schweregrad, um nur Einträge mit dem passenden Logschweregrad anzuzeigen.
Beim ausgewählten ADB-Log können Sie Logeinträge mithilfe des Felds Filter mit optionalen Modifikatoren oder Regex filtern.
Sie können auch regelmäßiger Leser eines Blogs oder einer URL
- Über das Feld Find (Suchen) und die Befehle Find Next (Weiter suchen) () und Find Zurück () können Sie nach bestimmten Einträgen suchen.
- Sie können optionale Modifikatoren oder Regex verwenden.
- Zu Zeile springen: So springen Sie im Protokoll zu einer bestimmten Zeile (Zahl).
Wählen Sie Nummeriert aus, um Protokollzeilen mit hinzugefügten Zeilennummern aufzurufen. Wählen Sie Rohdaten aus, um die ursprünglichen Logeinträge anzusehen.
Ressourcen und Feedback
Klicken Sie auf Ressourcen, um eine Liste der Entwicklertools und -ressourcen zu sehen.
Wenn Sie uns Feedback oder Verbesserungsvorschläge zu Google Home Plugin senden möchten, klicken Sie auf Feedback.
