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.
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 Neustart vergessen aus.
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.“
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.
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:
- Laden Sie Android Studio herunter oder aktualisieren Sie die App. Android Studio herunterladen
- Rufen Sie Datei > Einstellungen (Android Studio > Einstellungen unter macOS) auf.
- Gehen Sie im Abschnitt 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 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.
Klicken Sie auf den Tab Google Home in der vertikalen Tabspalte auf der linken Seite des Fensters Android Studio.
Klicken Sie unter 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.
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.
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“.
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.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.
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.
{
"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 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:
Testen, um die Abfragen noch einmal wiederzugeben und die Antworten und Logs zu prüfen. Wenn Sie Batchäußerungen testen, erwartetExpected one of: "Got it, turning on
2 lights."
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.
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.
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 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
und6/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.
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 Google Home Graph-Bereiche für separate Projekte geöffnet haben.
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 mehrereWenn die Geräte geladen sind, klicken Sie auf einen beliebigen Eintrag
, 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.
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.
Sie können die Testdetails und die Protokolle aufrufen, sobald die Tests abgeschlossen sind.
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.
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.