Google Home Playground

Cloud-to-Cloud    Local Home SDK    Home APIs

Die Google Home Playground ist eine Webanwendung, die ein Smart Home-Projekt mit konfigurierbaren Gerätetypen und -Traits simuliert. Sie können 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 Sie Google Home Playground verwenden möchten, sollten Sie das Tool zuerst mit Ihrem Konto verknüpfen. Öffnen Sie die Google Home app (GHA) auf Ihrem Smartphone und führen Sie die Kontoverknüpfung gemäß der Anleitung unter Smart-Home-Geräte von Drittanbietern in der Google Home App verbinden durch.

1. Suchen Sie nach der Integration Google Home Playground.
2. Wählen Sie die Integration aus. Sie werden dann zu r Anmeldeseite weitergeleitet.GHA Klicken Sie auf Über Google anmelden und wählen Sie Ihr Konto aus, um sich anzumelden.
3. Klicken Sie auf die Schaltfläche Autorisieren , um die Kontoverknüpfung zu autorisieren.

Nachdem Sie die Kontoverknüpfung abgeschlossen haben, wird in GHA eine Reihe virtueller Standardgeräte angezeigt, mit denen Sie interagieren können.

Anmelden

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

Playground starten

Klicken Sie auf Über Google anmelden. Melden Sie sich mit demselben Konto an, das Sie in der GHA verwendet haben, um die Kontoverknüpfung abzuschließen.

Nachdem Sie sich angemeldet haben, werden in Google Home Playground die virtuellen Geräte gespeichert in Home Graph angezeigt.

Die Web-UI besteht aus drei Bereichen:

• In der Geräteliste werden alle Ihre virtuellen Geräte angezeigt. Sie können 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. Sie können 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. Sie können 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ählen Sie im Bereich Geräteliste das virtuelle Gerät aus, das Sie ansehen möchten. Wählen Sie im Bereich Geräteliste das virtuelle Gerät aus, das Sie ansehen möchten. 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: Sekundäre Nutzerbestätigung Konfiguration von dem Gerät.

Informationen zu virtuellen Geräten bearbeiten

Sie können nicht nur die Informationen eines virtuellen Geräts ansehen, sondern auch die in Home Graph gespeicherten Informationen direkt über den Bereich Geräteinfo bearbeiten.

Unterstützte Traits ändern

1. Wählen Sie den Tab Traits aus und klicken Sie auf die Schaltfläche Bearbeiten.
2. Im Pop‑up-Bereich sehen Sie die derzeit unterstützten Traits des Geräts und die verfügbaren Traits, die Sie hinzufügen können. Verwenden Sie die Pfeiltasten (arrow_forward/arrow_back), um unterstützte Traits für das Gerät hinzuzufügen oder zu entfernen.
3. Wenn Sie die unterstützten Traits aktualisiert haben, klicken Sie auf Speichern. Die aktualisierten Traits werden auf Home Graph angewendet.
4. Sie können diese Trait-Aktualisierungen im Logbereich ansehen.

Geräteattribute ändern

1. Wählen Sie den Tab Attribute aus und bearbeiten Sie das Attribut für die vom Gerät unterstützten Traits.
2. Wenn Sie die Bearbeitung abgeschlossen haben, drücken Sie die Eingabetaste . Die Attributänderungen werden auf Home Graph angewendet.
3. Sie können diese aktualisierten Attribute im Logbereich ansehen.

Gerätestatus ändern

1. Wählen Sie den Tab Status aus und bearbeiten Sie den Status direkt. Die Statusänderungen werden auf Home Graph angewendet.
2. Sie können diese Statusänderungen im Logbereich ansehen.

Sekundäre Nutzerbestätigung zu virtuellem Gerät hinzufügen

Sie können virtuellen Geräten eine sekundäre Nutzerbestätigung hinzufügen und den Challenge-Typ und das entsprechende Verhalten auf jedem Gerät konfigurieren. Sie können virtuellen Geräten eine sekundäre Nutzerbestätigung hinzufügen und den Challenge-Typ und das entsprechende Verhalten auf jedem Gerät konfigurieren.

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

1. Wählen Sie im Bereich Geräteliste das virtuelle Gerät aus, das Sie konfigurieren möchten.
2. Wählen Sie im Bereich Geräteinfo den Tab Sekundäre Nutzerbestätigung aus und konfigurieren Sie Folgendes:
   • Aktiviert: Gibt an, ob die sekundäre Nutzerbestätigung auf dem Gerät aktiviert oder deaktiviert ist (keine Challenge) auf dem Gerät.
   • Challenge-Typ: 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, falls nicht, welche Fehlermeldung angezeigt werden soll.

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.

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

• ArmDisarm
• LockUnlock
• OpenClose
• Reboot
• SoftwareUpdate

Neues virtuelles Gerät erstellen

1. Klicken Sie im Bereich Geräteliste auf Gerät hinzufügen.
2. Wählen Sie im Pop‑up-Bereich den Gerätetyp aus und geben Sie den Gerätenamen für das neue Gerät ein. Alternativ können Sie eine vordefinierte Gruppe von Geräten auswählen, die hinzugefügt werden sollen.
3. Nachdem Sie alle Schritte ausgeführt haben, wird das neue Gerät zu Home Graph hinzugefügt.

Virtuelles Gerät entfernen

1. Wählen Sie im Bereich Geräteliste das Gerät aus, das Sie entfernen möchten. Wählen Sie dann im Bereich Geräteinfo den Tab Grundlegende Informationen aus und Wählen Sie dann im Bereich Geräteinfo den Tab Grundlegende Informationen aus und klicken Sie unten auf Gerät entfernen.
2. Bestätigen Sie das Entfernen des Geräts im Pop‑up-Fenster.
3. Sobald Sie das Entfernen des Geräts bestätigt haben, wird es aus Home Graph entfernt.

Editor für SYNC-Antwort

Sie können Ihre SYNC-Antwort in Google Home Playground validieren oder aktualisieren. Klicken Sie auf Editor für SYNC-Antwort , um eine eingebettete IDE zu öffnen.

Bearbeiten Sie Ihre SYNC-Antwort oder kopieren Sie sie und fügen Sie sie ein. Klicken Sie dann auf Speichern, um die Änderungen anzuwenden und zu sehen, wie sie im Google Home-Ökosystem funktionieren.

Virtuelle Geräte importieren und exportieren

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

Virtuelle Geräte in eine Datei exportieren

1. Klicken Sie auf „file_download“, um virtuelle Geräte in eine Datei zu exportieren.
2. Geben Sie den Namen der Datei ein, die Sie exportieren möchten, und klicken Sie auf OK.
3. Nachdem Sie den Dateinamen eingegeben haben, lädt der Browser die Datei der exportierten virtuellen Geräte herunter.

Virtuelle Geräte aus einer Datei importieren

1. Klicken Sie auf „upload_file“, um virtuelle Geräte aus einer Datei zu importieren.
2. Wählen Sie die Datei aus, die Sie importieren möchten, und klicken Sie auf OK.
3. Sobald Sie die zu importierende Datei bestätigt haben, werden in Google Home Playground virtuelle Geräte mit Status aus der Datei importiert und die Informationen und Status der importierten Geräte in Home Graph aktualisiert.

Interaktionslogs prüfen

Wenn Sie mit den virtuellen Geräten interagieren, Google Home Playground werden Ihre Änderungen automatisch auf Home Graphangewendet. Die Interaktionen mit Home Graph werden im Bereich Logbereich aufgezeichnet. Sie können jeden Eintrag maximieren, um die Home Graph Nutzlasten von Anfragen und Antworten der API zu prüfen.

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

{
  "uri": string,
  "request": object,
  "response": object
}

Unterstützte Gerätetypen und Traits ansehen

Über das Fragezeichensymbol help rechts oben können Sie die aktuelle Liste der Gerätetypen und Traits aufrufen, die von Google Home Playground unterstützt werden.

Probleme melden

Wir freuen uns auf Ihr Feedback. Melden Sie Probleme über das Ausrufezeichen feedback rechts oben.