Google Home Plugin for Android Studio wurde für Google entwickelt und entwickelt Home Platform-Entwickler 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
Um zu testen, ob Ihre Smart-Home-Geräte ordnungsgemäß mit Google Home funktionieren können Sie jederzeit mit Assistant Simulator interagieren, Android Studio 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 könnte beispielsweise eine der folgenden Wortgruppen sein:
- Ok, ich schalte 2 Lampen ein.
- Kein Problem, ich schalte 2 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 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-Geräte Logs.
Installieren
So installieren Sie Google Home Plugin in Android Studio: führen Sie folgende Schritte aus:
- Android Studio herunterladen oder aktualisieren. <ph type="x-smartling-placeholder"> 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
Nach der Installation des Plug-ins Führen Sie die folgenden Schritte aus, bevor Sie Assistant Simulator und Rufen Sie Cloud Logging auf:
Ü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 Anmelden mit 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 sammeln
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 im Folgenden in das JSON-Format konvertiert: Format:
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 Felder Collect und Test
mit allen Äußerungen in .json-Dateien in diesem Ordner arbeiten.
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. Nach dem Klicken auf
Erfassen,
führt die Assistant Simulator Ihre Abfragen aus.
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.
<ph type="x-smartling-placeholder">
Cloud Logging ansehen
Klicken Sie zum Öffnen eines Projekttabs im Fenster des Cloud Logs-Tools auf Cloud Logs. aus dem Bereich Google Home Plugin. Sie können separate Cloud Log-Tabs öffnen für jedes Ihrer Projekte.
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
5/1/22und6/30/22auswählen möchten, wählen Sie Vor und Nach und wählen Sie über das Datumssymbol den gewünschten Zeitraum 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.
Nachdem die Logs geladen wurden, klicken Sie auf einen beliebigen Eintrag zum Maximieren der vollständigen Anzeige JSON-Nutzlast. 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.
Home Graph ansehen und Tests durchfü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.
So starten Sie die Test-Suite für ein bestimmtes Gerät: Klicken Sie auf Testen. Dadurch wird die Test-Suite in Ihrem Browser mit Ihrem Gerät ausgewählt und bereit zum Testen. 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. Um einen Tab zu löschen, klicken Sie auf das Symbol -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
- Über das Feld Suchen und die Befehle Nächstes suchen (-Symbol) und Vorherige suchen (Symbol ) können Sie nach bestimmten Einträgen suchen.
- Verwenden Sie optionale Modifikatoren für Groß-/Kleinschreibung 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 RAW aus. um unformatierte Logeinträge anzuzeigen.
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.
<ph type="x-smartling-placeholder">