Die Google Home Plugin for Android Studio wurde für Entwickler der Google Home-Plattform entwickelt. Mit diesem Plug-in erhalten Sie Zugriff auf Google Assistant Simulator, Cloud Logging und andere Tools zur Vereinfachung Ihres Entwicklungsprozess von Smart Homes.
Sicherheitshinweis
Um zu verhindern, dass Android Studio Secrets speichert und Passwörter verwenden möchten, führen Sie die folgenden Schritte aus:
- Klicken Sie auf Datei und dann auf Einstellungen.
- Klicken Sie unter Darstellung & Verhalten, maximieren Sie Systemeinstellungen und klicken Sie 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.
Ähnlich wie beim bisherigen Assistant Simulator bereitgestellt in der Actions on Google Console-Konsole können Sie mit Assistant Simulator können Sie Ihre Geräte ganz einfach steuern, indem Sie Suchanfragen eingeben, z. B. „Schalte das Licht ein.“ Innerhalb von Android Studio, Assistant Simulator antwortet mit einer Nachricht zu: z. B. „Alles klar, das Licht wird eingeschaltet.“
Cloud Logging ansehen
Google Cloud Logging bietet Debugging-Informationen und wichtige Messwerte, die Ihnen Einblicke in Ihre Nutzung der Aktion. Zur Vereinfachung der Entwicklung zeigt der Google Home Plugin Cloud Logging-Nachrichten in Echtzeit direkt neben dem Code Fehlerbehebung.
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 zwei Lampen ein.
- Alles klar, ich schalte zwei Lampen ein.
- Alles klar, zwei Leuchten werden eingeschaltet.
- Alles klar, ich schalte zwei Leuchten ein.
Hier können Sie automatisierte Tests ausführen und prüfen, wie Ihre Google-Integrationen funktionieren. Antworten gefunden haben, können Sie Batch-Äußerungen an die Assistant Simulator, indem Sie Äußerungsskripts ausführen. Sobald ein Script gespeichert haben, können Sie Antworten sammeln und mehrere Tests mit Ihren Abfragen durchführen.
Home Graph-Anzeige
Mit dem Home Graph Viewer können Sie den Status Ihrer Geräte anzeigen und den Google Home-Test-Suite in Ihrem Browser.
ADB-Loganzeige (Android Debug Bridge)
Der ADB Log Viewer ist ein Tool zum Anzeigen und Analysieren von Protokolldateien, zum Beispiel Protokolldateien von Matter-Geräten, Google Home-Protokolle und Android Logs.
Installieren
So installieren Sie Google Home Plugin in Android Studio: führen Sie folgende Schritte aus:
- Android Studio herunterladen oder aktualisieren. Android Studio herunterladen
- Gehen Sie zu Datei > Einstellungen (Android Studio > Einstellungen unter macOS).
- Klicken Sie im Abschnitt 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 die JetBrains Marketplace
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 Android Studio wird autorisiert, mit Google zu kommunizieren Dienstleistungen in Ihrem Namen zu erbringen.
Klicken Sie links in der Spalte für den vertikalen Tab auf den Tab Google Home. Seite des Android Studio-Fensters.
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 auswählen können.
Cloud-Projekt auswählen
Wähle nach der Anmeldung ein Projekt aus dem Drop-down-Menü aus. So filtern Sie Ihre
Projektliste einen Filterausdruck ein, z. B. matter, und drücken Sie dann
Enter.
Über das Drop-down-Menü Projekt werden die ersten 100 Projekte anhand Ihrer Filter: Deine Auswahl wird beim Beenden beibehalten Android Studio
Hilfe zu Projektfiltern finden Sie unter Suchparameter in der Google Cloud-Referenz.
Assistant-Simulator verwenden
So öffnen Sie die Assistant Simulator in Android Studio: Klicken Sie im Bereich Google Home Plugin auf Bereich „Äußerungen“.
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
Um mit Assistant Simulator zu interagieren, gib deine Anfrage ein und drücke Drücken Sie die Eingabetaste.
Sie können eine Anfrage erneut senden, indem Sie auf -Symbol zum erneuten Senden am Ende von Ihrer Abfrage.
Nachdem Sie eine oder mehrere Abfragen gesendet haben, klicken Sie auf Erneut abspielen, um Ihre und überprüfen Sie Ihre Antworten. Im Bereich Äußerungen werden Ihre Abfragen und Antworten in einem gespeicherten Cache. Mit Wiederholung werden nur neue Antworten zu in diesem internen Cache gespeichert. Ihre Abfragen werden nicht jedes Mal dupliziert, wenn Sie auf das Schaltfläche.
Klicken Sie auf Speichern, um die Abfragen zu speichern. Antworten, die Sie in den Bereich Äußerungen: Ihre Interaktionen werden in JSON im folgenden 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 sie zu öffnen.
Ihre gespeicherten JSON-Dateien in einem neuen Tab. Unter Pfad auswählen können Sie einen
eine Datei oder einen Ordner. 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 verschiedene Dateien öffnen, z. B.
lights, lights(1) und plug.
In der Statusleiste wird gegebenenfalls das Ergebnis Ihres letzten Tests angezeigt.
einen gelben oder grünen Punkt, um anzuzeigen, ob die Datei gesammelt wurde, und der
Dateipfad für Äußerung .json. Nachdem Sie auf Erfassen geklickt haben, werden Ihre Abfragen vom Assistant Simulator ausgeführt.
Sie werden benachrichtigt, sobald eine neue Antwort eingegangen ist, und die Statusleiste wird angezeigt.
zeigt einen Zähler an, während Ihre Abfragen verarbeitet werden.
Wenn die Erfassung abgeschlossen ist, wird die Statusleiste mit einem grünen Häkchen aktualisiert.
vor dem .json-Pfad ein und Ihre Äußerungsdateien werden mit
möglichen Antworten.
{
"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 durch Anhalten vorzeitig beenden, wird der Pfad .json nicht als
gesammelt.
Batchäußerungen testen
Wenn Sie Ihre Antworten gesammelt haben, klicken Sie auf Testen, um Ihre Abfragen wiederzugeben und überprüfen Sie Ihre Antworten und Protokolle. Wenn Sie Batchäußerungen testen, Assistant Simulator erwartet die Antworten, die in Ihrer JSON-Datei gespeichert sind -Datei. Wenn Ihr Test eine Antwort zurückgibt, die nicht erfasst wurde, erhalten Sie eine Benachrichtigung, die in etwa so aussieht:
Expected one of: "Got it, turning on
2 lights."
Dieses Szenario deutet auf einen nicht erfolgreichen Test hin. Andernfalls wird der Assistant Simulator führt jede Ihrer Abfragen aus und gibt eine Antwort zurück. Im Statusleiste, wenn der Test erfolgreich war.
Cloud Logging ansehen
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 Logs auch mithilfe des Felds Abfrage filtern.
So filtern Sie beispielsweise Logs nach dem Schlüsselwort light:
Wählen Sie QL verwenden aus, um 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 Protokollen nach Datum ist ebenfalls optional und kann durch Klicken auf
Nach und Vor: Sie können das Datums- und Uhrzeitformat in den Text eingeben
angegeben, z. B. 5/11/22, 12:37 PM, oder Sie können die Datumsauswahl verwenden
um Ihr Datum auszuwählen, und geben Sie dann die Uhrzeit in das Textfeld ein.
- Um ein Datum nach dem
5/1/22auszuwählen, 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 Datum Symbol . - 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-Projektlogs abzurufen. Klicken Sie auf Beenden, um eine Echtzeit-Feed.
Wichtigkeitsstufe
Sie können auch im Drop-down-Menü einen Minimalen Schweregrad auswählen.
Abfrageergebnisse
Klicken Sie zum Senden auf Abrufen. Ihre Suchparameter.
Klicken Sie nach dem Laden der Protokolle auf einen beliebigen Eintrag , um die gesamte JSON-Nutzlast zu maximieren. Klicken Sie noch einmal um die vollständige Nachricht anzuzeigen.
Optional können Sie in das Feld Filter ein Stichwort eingeben, um das Protokoll einzugrenzen.
Ergebnisse. Klicken Sie auf das x, um den Filter zu entfernen und zum Original zurückzukehren.
Abruf von Ergebnissen.
Startseite-Grafik aufrufen und Tests ausführen
Wenn du eine Liste deiner Geräte erstellen möchtest, wähle Home Graph aus der Bereich Google Home Plugin.
Klicken Sie auf Aktualisieren, um die Gerätename, Geräte-ID und Gerätetyp für Ihre Geräte die mit dem ausgewählten Projekt verknüpft sind. Sie können mehrere Google Home Graph Bereiche werden für separate Projekte geöffnet.
Sobald deine Geräte geladen sind, klicke auf einen Eintrag zum Maximieren der vollständigen Anzeige JSON-Nutzlast.
Sie können die JSON-Datei auch mit Maximieren und Minimieren ein- und ausblenden. Nutzlasten für eure Geräte.
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 den Test. Ergebnisse.
Sie können sich die Testdetails ansehen und die Logs aufrufen, sobald die Tests abgeschlossen sind.
ADB-Loganzeige (Android Debug Bridge)
Klicken Sie auf den Befehl Adb Log, um im ADB-Log-Tool einen Projekt-Tab zu öffnen. in der Symbolleiste des Google Home-Plug-ins (links). Sie können ein separates ADB-Protokoll öffnen für jede Ihrer Protokolldateien. Wenn Sie einen Tab löschen möchten, klicken Sie auf das Symbol .
Verwenden Sie das Feld Auswählen, um eine bestimmte Logging-Komponente zur Ansicht auszuwählen. Schweregrad, um nur Einträge mit dem entsprechenden Logschweregrad anzuzeigen.
Sie können Logeinträge für das ausgewählte ADB-Log mit der Funktion Filter filtern. mit optionalen Modifikatoren für Groß-/Kleinschreibung oder Regex.
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.
- Mit Zu Zeile springen gelangen Sie zu einer bestimmten Zeile im Protokoll (anhand der Zahl).
Wählen Sie Nummeriert aus, um Protokollzeilen mit hinzugefügten Zeilennummern aufzurufen. 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.
Senden Sie uns Ihre Meinung oder Ihr Feedback, damit wir die Entwicklung verbessern können. mit dem Google Home Plugin haben, klicken Sie auf Feedback.