Google Home Playground

Cloud-zu-Cloud    Local Home SDK    Device SDK

Die Google Home Playground ist eine Webanwendung, die ein Smart-Home-Projekt mit konfigurierbaren Gerätetypen und -merkmalen simuliert. Sie können virtuelle Geräte erstellen, die Geräteattribute und -status ändern, diese Geräte in Google Home Graph aufrufen 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. Öffne die Google Home app (GHA) App auf deinem Smartphone und führe die Kontoverknüpfung durch:

  1. Klicken Sie links oben auf das Pluszeichen (+).
  2. Wählen Sie Gerät einrichten > Funktioniert mit Google aus.
  3. Suchen Sie nach der Aktion mit dem Titel Google Home Playground.
  4. Wählen Sie die Aktion aus. Über die GHA gelangen Sie zur Anmeldeseite. Klicken Sie auf Über Google anmelden und wählen Sie das Konto aus, mit dem Sie sich anmelden möchten.
  5. Klicken Sie auf die Schaltfläche Autorisieren, um die Kontoverknüpfung zu autorisieren.
Auf dieser Abbildung ist der Ablauf der Kontoverknüpfung in der Google Home App zu sehen, um Google Home Playground zu verbinden.

Sobald Sie die Kontoverknüpfung abgeschlossen haben, werden auf der GHA eine Reihe von Standard-virtuellen Geräten angezeigt, mit denen Sie interagieren können.

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

Anmelden

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

Launch Playground

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

Diese Abbildung zeigt den ursprünglichen Zustand des Google Home Playgrounds und die Anmeldeschaltfläche oben rechts.

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

Diese Abbildung zeigt die Geräteliste, Geräteinformationen und den Protokollbereich der Standardansicht von Google Home Playground.

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 sich die zugehörigen Informationen anzusehen und über diesen Bereich virtuelle Geräte zu erstellen.
  • Unter Geräteinformationen finden Sie Informationen zum ausgewählten virtuellen Gerät. Sie können diese Informationen auch über das Steuerfeld bearbeiten und das ausgewählte virtuelle Gerät entfernen.
  • Im Logbereich werden die Interaktionsprotokolle zwischen Google Home Playground und Home Graph angezeigt. Sie können die Protokolle maximieren, um die Nutzlasten von Anfragen und Antworten zur Fehlerbehebung zu prüfen.

Virtuelles Gerät

Informationen zum virtuellen Gerät 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äteinformationen werden die Informationen auf fünf Tabs kategorisiert angezeigt:

  • Grundlegende Informationen:oberste Eigenschaften des Geräts, einschließlich Gerätetyp, ID und Name.
  • Traits:Unterstützte Merkmale des Geräts.
  • Attribute:Merkmalsspezifische Attribute des Geräts.
  • Status:Alle Gerätestatus.
  • SUV: Sekundäre Nutzerbestätigung-Konfiguration des Geräts.

Informationen zum virtuellen Gerät bearbeiten

Sie können sich nicht nur die Informationen zu einem virtuellen Gerät ansehen, sondern auch die in Home Graph gespeicherten Informationen direkt über den Bereich Geräteinformationen bearbeiten.

Unterstützte Merkmale ändern

  1. Wählen Sie den Tab Eigenschaften aus und klicken Sie auf die Schaltfläche Bearbeiten.
  2. Im Pop-up-Fenster sehen Sie die derzeit unterstützten Merkmale des Geräts und die verfügbaren Merkmale, die Sie hinzufügen können. Verwenden Sie die Schaltflächen Pfeil (arrow_forward/arrow_back), um unterstützte Merkmale für das Gerät hinzuzufügen oder zu entfernen.
  3. Wenn Sie die unterstützten Merkmale aktualisiert haben, klicken Sie auf Speichern. Die aktualisierten Merkmale werden dann auf Home Graph angewendet.
  4. Sie können diese Aktualisierungen im Logbereich einsehen.
Diese Abbildung zeigt das UX-Tool zum Hinzufügen oder Löschen unterstützter Merkmale auf einem ausgewählten Gerät im Google Home Playground.

Geräteattribute ändern

  1. Wählen Sie den Tab Attribute aus und bearbeiten Sie das Attribut für die vom Gerät unterstützten Merkmale.
  2. Wenn Sie mit der Bearbeitung fertig sind, drücken Sie die Eingabetaste. Die Attributänderungen werden dann auf Home Graph angewendet.
  3. Sie finden diese aktualisierten Attribute im Logbereich.

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. Diese Statusänderungen können Sie im Logbereich sehen.

Virtuellem Gerät eine sekundäre Nutzerbestätigung hinzufügen

Sie können virtuellen Geräten einen SUV hinzufügen und den Herausforderungstyp und das entsprechende Verhalten auf jedem Gerät konfigurieren. Sie können virtuellen Geräten einen SUV hinzufügen und den Herausforderungstyp 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äteinformationen den Tab SUV aus und konfigurieren Sie Folgendes:
    • Aktiviert:Gibt an, ob die sekundäre Nutzerbestätigung auf dem Gerät aktiviert (challenge) oder deaktiviert ist.
    • Challenge-Typ:Gibt an, ob für die SUV-Bestä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.
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 mit aktivierter sekundärer Nutzerbestätigung ermitteln

In der Geräteliste wird neben jedem für Smart Home-fähigen Gerät ein Schlüsselsymbol Schlüssel angezeigt.

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

Für die folgenden Merkmale ist ein SUV erforderlich:

Neues virtuelles Gerät erstellen

  1. Klicken Sie im Bereich Geräteliste auf Gerät hinzufügen.
  2. Wählen Sie im Pop-up-Fenster den Gerätetyp aus und geben Sie den Gerätenamen für Ihr neues Gerät ein. Alternativ können Sie eine vordefinierte Gruppe von Geräten auswählen, die hinzugefügt werden sollen.
  3. Sobald Sie alle Schritte ausgeführt haben, wird das neue Gerät Home Graph hinzugefügt.
Auf dieser Abbildung ist das UX-Tool zu sehen, mit dem im Google Home Playground ein neuer Gerätetyp hinzugefügt wird.

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äteinformationen den Tab Allgemeine Informationen aus und klicken Sie unten auf PapierkorbsymbolGerä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.
Diese Abbildung zeigt das UX-Tool zum Entfernen eines virtuellen Gerätetyps im Google Home Playground.

Editor für SYNC-Antwort

Sie können Ihre Synchronisierungsantwort in Google Home Playground prüfen oder aktualisieren. Klicken Sie auf Sync Response Editor (Sync-Antwort-Editor), um eine eingebettete IDE zu öffnen.

Auf dieser Abbildung ist die Schaltfläche zu sehen, mit der der Editor für SYNC-Antworten geöffnet wird.

Bearbeiten oder kopieren Sie die Antwort für die Synchronisierung und fügen Sie sie ein. Klicken Sie dann auf Speichern, um die Änderungen anzuwenden und zu sehen, wie sie im Google Home-System funktioniert.

Auf dieser Abbildung ist das Fenster zu sehen, in dem die Synchronisierungsantwort bearbeitet werden kann.

Virtuelle Geräte importieren und exportieren

Wenn Sie Probleme beheben oder reproduzieren möchten, können Sie Ihre virtuellen Geräte mit ihren Status in eine Datei exportieren und die Datei für andere freigeben, damit sie Ihre 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. Klicken Sie auf , 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 , 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. Nachdem Sie die zu importierende Datei bestätigt haben, importiert Google Home Playground virtuelle Geräte mit Status aus der Datei und aktualisiert die Informationen und Status der importierten Geräte in Home Graph.

Interaktionsprotokolle prüfen

Wenn Sie mit den virtuellen Geräten interagieren, wendet Google Home Playground die Änderung automatisch auf Home Graph an. Die Interaktionen mit Home Graph werden im Bereich Log aufgezeichnet. Dort können Sie jeden Eintrag maximieren, um die Home Graph API-Anfrage- und Antwortnutzlasten 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. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation und in der Referenzdokumentation.
response object Antworttext des Home Graph API-Aufrufs. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation und in der Referenzdokumentation.

Unterstützte Gerätetypen und -Traits ansehen

Über das Fragezeichen Hilfe-Symbol oben rechts wird die aktuelle Liste der von Google Home Playground unterstützten Gerätetypen und Merkmale angezeigt.

Auf dieser Abbildung ist das UX-Tool zu sehen, mit dem im Google Home Playground ein neuer Gerätetyp hinzugefügt wird.

Probleme melden

Wir würden uns freuen, von Ihnen zu hören. Melden Sie Probleme über das Ausrufezeichensymbol Feedback oben rechts.

Auf dieser Abbildung sind die Symbole zu sehen, mit denen Sie Feedback geben und Probleme in Google Home Playground melden können.