Google Home Playground

Die Google Home Playground ist eine Webanwendung, die ein Smart Home-Projekt mit konfigurierbaren Gerätetypen und -Traits simuliert. Du kannst virtuelle Geräte erstellen, die Geräteattribute und -status ändern, diese Geräte in Google Home Graph ansehen und Gerätekonfigurationen importieren oder exportieren.

Kontoverknüpfung abschließen

Wenn du Google Home Playground verwenden möchtest, solltest du das Tool zuerst mit deinem Konto verknüpfen. Öffne die Google Home app (GHA) auf deinem Smartphone und führe die Kontoverknüpfung gemäß der Anleitung unter Smart-Home-Geräte von Drittanbietern in der Google Home App verbinden durch.

  1. Suche nach der Integration Google Home Playground.
  2. Wähle die Integration aus. Du wirst zu r Anmeldeseite weitergeleitet.GHA Klicke auf Sign in with Google (Über Google anmelden) und wähle dein Konto aus, um dich anzumelden.
  3. Klicke auf die Schaltfläche Autorisieren , um die Kontoverknüpfung zu autorisieren.
In dieser Abbildung sehen Sie den Ablauf der Kontoverknüpfung in der Google Home App zum Verbinden von Google Home Playground.

Nachdem du die Kontoverknüpfung abgeschlossen hast, werden in der Google Home App einige virtuelle Standardgeräte angezeigt, mit denen du interagieren kannst.GHA

In dieser Abbildung ist die Standardgeräteliste zu sehen, die angezeigt wird, wenn ein Nutzer Google Home Playground erfolgreich mit seinem Konto verknüpft.

Anmelden

Klicke auf die Schaltfläche unten, um die Google Home Playground zu starten:

Playground starten

Klicke auf Sign in with Google (Über Google anmelden). Melde dich mit demselben Konto an, das du in der GHA verwendet hast, um die Kontoverknüpfung abzuschließen.

Auf diesem Bild ist der Ausgangszustand von Google Home Playground zu sehen. Der Anmeldebutton oben rechts ist hervorgehoben.

Nach der Anmeldung werden in Google Home Playground die virtuellen Geräte gespeichert in Home Graph angezeigt.

In dieser Abbildung sind die Geräteliste, die Geräteinformationen und der Logbereich der Standardansicht von Google Home Playground zu sehen.

Die Web-UI besteht aus drei Bereichen:

  • In der Geräteliste werden alle deine virtuellen Geräte angezeigt. Du kannst ein bestimmtes virtuelles Gerät auswählen, um seine Informationen aufzurufen und über diesen Bereich virtuelle Geräte zu erstellen.
  • Unter Geräteinfo werden die Informationen des ausgewählten virtuellen Geräts angezeigt. Du kannst diese Informationen auch bearbeiten und das ausgewählte virtuelle Gerät über den Bereich entfernen.
  • Im Logbereich werden die Interaktionslogs zwischen Google Home Playground und Home Graph angezeigt. Du kannst die Logs maximieren, um die Nutzlasten von Anfragen und Antworten zur Fehlerbehebung zu prüfen.

Virtuelles Gerät

Informationen zu virtuellen Geräten ansehen

Wähle im Bereich Geräteliste das virtuelle Gerät aus, das du ansehen möchtest. Wähle im Bereich Geräteliste das virtuelle Gerät aus, das du ansehen möchtest. Im Bereich Geräteinfo werden die Informationen in fünf Tabs kategorisiert angezeigt:

  • Grundlegende Informationen:Eigenschaften der obersten Ebene des Geräts, einschließlich Gerätetyp, ID und Name.
  • Traits:Unterstützte Traits des Geräts.
  • Attribute:Traits-spezifische Attribute des Geräts.
  • Status:Alle Gerätestatus.
  • SUV: Konfiguration der sekundären Nutzerbestätigung von Gerät.

Informationen zu virtuellen Geräten bearbeiten

Neben dem Aufrufen der Informationen eines virtuellen Geräts kannst du diese Informationen auch direkt über den Bereich Geräteinfo bearbeiten.Home Graph

Unterstützte Traits ändern

  1. Wähle den Tab Traits aus und klicke auf die Schaltfläche Bearbeiten.
  2. Im Pop‑up-Bereich werden die derzeit unterstützten Traits des Geräts und die verfügbaren Traits angezeigt, die hinzugefügt werden können. Verwende die Schaltflächen mit den Pfeilen (arrow_forward/arrow_back), um unterstützte Traits für das Gerät hinzuzufügen oder zu entfernen.
  3. Wenn du die unterstützten Traits aktualisiert hast, klicke auf Speichern . Die aktualisierten Traits werden auf Home Graphangewendet.
  4. Du kannst diese Trait-Aktualisierungen im Logbereich ansehen.
In dieser Abbildung sehen Sie das UX-Tool zum Hinzufügen oder Löschen unterstützter Traits auf einem ausgewählten Gerät im Google Home Playground.

Geräteattribute ändern

  1. Wähle den Tab Attribute aus und bearbeite das Attribut für die vom Gerät unterstützten Traits.
  2. Wenn du die Bearbeitung abgeschlossen hast, drücke die Eingabetaste . Die Attributänderungen werden auf Home Graph angewendet.
  3. Du kannst diese aktualisierten Attribute im Logbereich ansehen.

Gerätestatus ändern

  1. Wähle den Tab Status aus und bearbeite den Status direkt. Die Statusänderungen werden auf Home Graph angewendet.
  2. Du kannst diese Statusänderungen im Logbereich ansehen.

Sekundäre Nutzerbestätigung zu einem virtuellen Gerät hinzufügen

Du kannst virtuellen Geräten eine sekundäre Nutzerbestätigung hinzufügen und den Bestätigungstyp sowie das entsprechende Verhalten auf jedem Gerät konfigurieren. Du kannst virtuellen Geräten eine sekundäre Nutzerbestätigung hinzufügen und den Bestätigungstyp sowie das entsprechende Verhalten auf jedem Gerät konfigurieren.

Sekundäre Nutzerbestätigung auf einem Gerät konfigurieren

  1. Wähle im Bereich Geräteliste das virtuelle Gerät aus, das du konfigurieren möchtest.
  2. Wähle im Bereich Geräteinfo den Tab SUV aus und konfiguriere Folgendes:
    • Aktiviert: Gibt an, ob die sekundäre Nutzerbestätigung auf dem Gerät aktiviert oder deaktiviert ist (keine Bestätigung erforderlich) auf dem Gerät.
    • Bestätigungstyp: Gibt an, ob für die sekundäre Nutzerbestätigung eine explizite Bestätigung (ackNeeded) oder eine persönliche Identifikationsnummer (pinNeeded) erforderlich ist.
    • PIN:Die gültige PIN.
    • Umgang mit falscher PIN:Gibt an, ob der Nutzer bei einer falschen PIN noch einmal gefragt werden soll und, wenn nicht, welche Fehlermeldung angezeigt werden soll.
Diese Abbildung zeigt das UX-Tool zum Aktivieren von Eigenschaften für die sekundäre Nutzerbestätigung auf einem ausgewählten Gerät im Google Home Playground.

Geräte identifizieren, auf denen die sekundäre Nutzerbestätigung aktiviert ist

Im Bereich Geräteliste wird neben jedem Gerät, auf dem die sekundäre Nutzerbestätigung aktiviert ist, ein Schlüsselsymbol key angezeigt.

In dieser Abbildung sind Geräte zu sehen, für die die sekundäre Nutzerbestätigung empfohlen wird.

Für die folgenden Traits ist eine sekundäre Nutzerbestätigung erforderlich:

Neues virtuelles Gerät erstellen

  1. Klicke im Bereich Geräteliste auf Gerät hinzufügen.
  2. Wähle im Pop‑up-Bereich den Gerätetyp aus und gib den Gerätenamen für dein neues Gerät ein. Alternativ kannst du eine vordefinierte Gruppe von Geräten auswählen, die hinzugefügt werden sollen.
  3. Nachdem du alle Schritte ausgeführt hast, wird das neue Gerät zu Home Graph hinzugefügt.
Auf diesem Bild ist das UX-Tool zum Hinzufügen eines neuen Gerätetyps in Google Home Playground zu sehen.

Virtuelles Gerät entfernen

  1. Wähle im Bereich Geräteliste das Gerät aus, das du entfernen möchtest. Wähle dann im Bereich Geräteinfo den Tab Grundlegende Informationen aus und Wähle dann im Bereich Geräteinfo den Tab Grundlegende Informationen aus und klicke unten auf PapierkorbsymbolGerät entfernen.
  2. Bestätige das Entfernen des Geräts im Pop‑up-Fenster.
  3. Sobald du das Entfernen des Geräts bestätigt hast, wird es aus Home Graph entfernt.
In dieser Abbildung sehen Sie das UX-Tool zum Entfernen eines virtuellen Gerätetyps in Google Home Playground.

Editor für SYNC-Antwort

Du kannst deine SYNC-Antwort in Google Home Playground validieren oder aktualisieren. Klicke auf Editor für SYNC-Antwort , um eine eingebettete IDE zu öffnen.

In dieser Abbildung sehen Sie den Button zum Öffnen des Editors für SYNC-Antworten.

Bearbeite deine SYNC-Antwort oder kopiere und füge sie ein und klicke auf Speichern, um die Änderungen anzuwenden und zu sehen, wie sie im Google Home-Ökosystem funktionieren.

In dieser Abbildung sehen Sie das Fenster zum Bearbeiten der Synchronisierungsantwort.

Virtuelle Geräte importieren und exportieren

Zur Fehlerbehebung oder zur Reproduktion von Problemen kannst du deine virtuellen Geräte mit ihren Status in eine Datei exportieren und die Datei mit anderen teilen, damit sie deine virtuellen Geräte importieren und replizieren können.

Diese Abbildung zeigt das UX-Tool zum Importieren und Exportieren virtueller Geräte in Google Home Playground.

Virtuelle Geräte in eine Datei exportieren

  1. Klicke auf „“, um virtuelle Geräte in eine Datei zu exportieren.
  2. Gib den Dateinamen ein, den du exportieren möchtest, und klicke auf OK.
  3. Nachdem du den Dateinamen eingegeben hast, lädt der Browser die Datei der exportierten virtuellen Geräte herunter.

Virtuelle Geräte aus einer Datei importieren

  1. Klicke auf „“, um virtuelle Geräte aus einer Datei zu importieren.
  2. Wähle die Datei aus, die du importieren möchtest, und klicke auf OK.
  3. Sobald du die zu importierende Datei bestätigt hast, wird Google Home Playground virtuelle Geräte mit Status aus der Datei importieren und die Informationen und Status der importierten Geräte in Home Graph aktualisieren.

Interaktionslogs prüfen

Wenn du mit den virtuellen Geräten interagierst, Google Home Playground wendet deine Änderung automatisch auf Home Graph an. Die Interaktionen mit Home Graph werden im Bereich Logbereich aufgezeichnet. Dort kannst du jeden Eintrag maximieren, um die Home Graph Nutzlasten von API-Anfragen und -Antworten zu prüfen.

Jeder Logeintrag ist ein JSON-Array mit Elementen der folgenden Struktur:

{
  "uri": string,
  "request": object,
  "response": object
}
Felder Typ Beschreibung
uri string URL des Home Graph API-Aufrufs.
request object Anfragetext des Home Graph API-Aufrufs. Das Format der einzelnen Methoden findest du in der Referenzdokumentation Referenzdokumentation.
response object Antworttext des Home Graph API-Aufrufs. Das Format der einzelnen Methoden findest du in der Referenzdokumentation Referenzdokumentation.

Unterstützte Gerätetypen und Traits ansehen

Über das Fragezeichensymbol rechts oben kannst du die aktuelle Liste der Gerätetypen und Traits aufrufen, die von Google Home Playground unterstützt werden.

Auf diesem Bild ist das UX-Tool zum Hinzufügen eines neuen Gerätetyps in Google Home Playground zu sehen.

Probleme melden

Wir freuen uns auf dein Feedback. Melde Probleme über das Ausrufezeichen Feedback rechts oben.

Auf diesem Bild sind die Symbole zum Geben von Feedback und Melden von Problemen in Google Home Playground zu sehen.