Google Home Playground ist eine Webanwendung, die ein Smart-Home-Projekt mit konfigurierbaren Gerätetypen und -eigenschaften simuliert. Sie können virtuelle Geräte erstellen, 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. Öffne die Google Home app (GHA) auf deinem Smartphone und führe die Kontoverknüpfung durch:
- Klicken Sie links oben auf das Pluszeichen (+).
- Wählen Sie Gerät einrichten > Mit Geräten von Google kompatibel aus.
- Suchen Sie nach der Aktion Google Home Playground.
- Wählen Sie die Aktion aus. GHA leitet Sie zur Anmeldeseite weiter. Klicken Sie auf Sign in with Google (Über Google anmelden) und wählen Sie Ihr Konto aus.
- Klicken Sie auf die Schaltfläche Autorisieren, um die Kontoverknüpfung zu autorisieren.
Sobald du die Kontoverknüpfung abgeschlossen hast, wird auf der GHA eine Reihe von virtuellen Standardgeräten angezeigt, mit denen du interagieren kannst.
Anmelden
Starten Sie Google Home Playground, indem Sie auf die Schaltfläche unten klicken:
Klicke auf Sign in with Google (Über Google anmelden). Melde dich mit demselben Konto an, das du in GHA verwendet hast, um die Kontoverknüpfung abzuschließen.
Nach der Anmeldung zeigt Google Home Playground die in Home Graph gespeicherten virtuellen Geräte an.
Die Web-UI besteht aus drei Bereichen:
- In der Geräteliste sind alle virtuellen Geräte aufgeführt. In diesem Bereich können Sie ein bestimmtes virtuelles Gerät auswählen, um dessen Informationen anzusehen und virtuelle Geräte zu erstellen.
- Unter Geräteinformationen werden die Informationen zum ausgewählten virtuellen Gerät angezeigt. Sie können diese Informationen auch bearbeiten und das ausgewählte virtuelle Gerät über das Steuerfeld entfernen.
- Im Logbereich werden die Interaktionslogs zwischen Google Home Playground und Home Graph angezeigt. Sie können die Logs erweitern, um die Nutzlasten von Anfragen und Antworten auf Fehler zu prüfen.
Virtuelles Gerät
Informationen zu virtuellen Geräten ansehen
Wählen Sie in der Geräteliste das virtuelle Gerät aus, das Sie sich ansehen möchten. Wählen Sie in der Geräteliste das virtuelle Gerät aus, das Sie sich ansehen möchten. Die Informationen im Bereich Geräteinformationen sind in fünf Tabs unterteilt:
- Allgemeine Informationen:Eigenschaften der obersten Ebene des Geräts, einschließlich Gerätetyp, ID und Name.
- Eigenschaften: unterstützte Eigenschaften des Geräts.
- Attribute: trait-spezifische Attribute des Geräts.
- Status:alle Gerätestatus
- SUV:Konfiguration des Geräts für die Sekundäre Nutzerbestätigung.
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 über das Steuerfeld Geräteinfo direkt bearbeiten.
Unterstützte Traits ändern
- Wähle den Tab Eigenschaften aus und klicke auf die Schaltfläche Bearbeiten.
- Im Pop-up-Fenster werden die derzeit unterstützten Eigenschaften des Geräts und die verfügbaren Traits angezeigt, die du hinzufügen kannst. Mit den Pfeilschaltflächen
(arrow_forward/arrow_back) kannst du unterstützte Traits für das Gerät hinzufügen oder entfernen. - Wenn Sie die unterstützten Traits aktualisiert haben, klicken Sie auf Save (Speichern). Die aktualisierten Traits werden dann auf Home Graph angewendet.
- Du kannst die aktualisierten Trait-Daten im Bereich „Eintragen“ einsehen.
Geräteattribute ändern
- Wähle den Tab Attributes (Attribute) aus und bearbeite das Attribut für die vom Gerät unterstützten Traits.
- Wenn Sie fertig sind, drücken Sie die Eingabetaste. Die Attributänderungen werden dann auf Home Graph angewendet.
- Die aktualisierten Attribute können Sie im Logbereich einsehen.
Gerätestatus ändern
- Wählen Sie den Tab Status aus und bearbeiten Sie den Status direkt. Die Statusänderungen werden auf Home Graph angewendet.
- Sie können diese Statusänderungen im Logbereich einsehen.
Sekundäre Nutzerbestätigung zum virtuellen Gerät hinzufügen
Sie können virtuellen Geräten einen SUV hinzufügen und die Art der Identitätsbestätigung und das entsprechende Verhalten auf jedem Gerät konfigurieren. Sie können einen SUV zu virtuellen Geräten hinzufügen und die Art der Identitätsbestätigung und das entsprechende Verhalten auf jedem Gerät konfigurieren.
SUV auf dem Gerät konfigurieren
- Wählen Sie in der Geräteliste das virtuelle Gerät aus, das Sie konfigurieren möchten.
- Wählen Sie im Bereich Geräteinformationen den Tab SUV aus und konfigurieren Sie Folgendes:
- Aktiviert:Gibt an, ob SUV auf dem Gerät aktiviert oder deaktiviert ist (keine Abfrage).
- Art der Identitätsbestätigung:Gibt an, ob SUV eine ausdrückliche Bestätigung (ackNeeded) oder eine persönliche Identifikationsnummer (pinNeeded) erfordert.
- PIN:Die gültige PIN.
- Umgang mit einer falschen PIN:Wenn die PIN falsch ist, wird der Nutzer noch einmal gefragt und wenn nicht, wird der Fehler zurückgegeben.
SUV-fähige Geräte ermitteln
In der Geräteliste wird neben jedem SUV-fähigen Gerät ein Schlüsselsymbol Schlüssel angezeigt.
Für die folgende Liste von Merkmalen ist SUV erforderlich:
Neues virtuelles Gerät erstellen
- Klicken Sie in der Geräteliste auf Gerät hinzufügen.
- 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.
- Sobald Sie alle Schritte abgeschlossen haben, wird das neue Gerät Home Graph hinzugefügt.
Virtuelles Gerät entfernen
- Wählen Sie in der Geräteliste das Gerät aus, das Sie entfernen möchten.
Wählen Sie dann im Bereich Geräteinformationen den Tab Allgemeine Informationen aus. Wählen Sie dann im Bereich Geräteinformationen den Tab Allgemeine Informationen aus und klicken Sie unten auf
Gerät entfernen. - Bestätigen Sie in der Pop-up-Benachrichtigung, dass das Gerät entfernt wurde.
- Sobald du das Entfernen des Geräts bestätigt hast, wird es aus Home Graph entfernt.
Editor für Synchronisierungsantworten
Sie können Ihre Synchronisierungsantwort in Google Home Playground bestätigen oder aktualisieren. Klicken Sie auf Sync Response Editor, um eine eingebettete IDE zu öffnen.
Bearbeite oder kopiere deine Synchronisierungsantwort und klicke auf Speichern, um die Änderungen zu übernehmen und zu sehen, wie das Ganze im Google Home-System funktioniert.
Virtuelle Geräte importieren und exportieren
Zur Fehlerbehebung oder Reproduktion von Problemen können Sie Ihre virtuellen Geräte mit ihrem Status in eine Datei exportieren und die Datei für andere Nutzer freigeben, um Ihre virtuellen Geräte zu importieren und zu replizieren.
Virtuelle Geräte in eine Datei exportieren
- Klicken Sie auf , um virtuelle Geräte in eine Datei zu exportieren.
- Geben Sie den Namen der Datei ein, die Sie exportieren möchten, und klicken Sie auf OK.
- 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
- Klicken Sie auf , um virtuelle Geräte aus einer Datei zu importieren.
- Wählen Sie die Datei aus, die Sie importieren möchten, und klicken Sie auf OK.
- 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.
Interaktionslogs prüfen
Wenn du mit den virtuellen Geräten interagierst, wendet Google Home Playground deine Änderung automatisch auf Home Graph an. Die Interaktionen mit Home Graph werden im Bereich Logbereich aufgezeichnet. Dort können Sie jeden Eintrag maximieren, um die Nutzlasten der API-Anfrage und der API-Antwort Home Graph zu prüfen.
Jeder Logeintrag ist ein JSON-Array, das Elemente mit der folgenden Struktur enthält:
{
"uri": string,
"request": object,
"response": object
}
| Felder | Typ | Beschreibung |
|---|---|---|
uri |
string |
URL des API-Aufrufs Home Graph. |
request |
object |
Anfragetext des API-Aufrufs Home Graph. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation Referenzdokumentation. |
response |
object |
Antworttext des API-Aufrufs Home Graph. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation Referenzdokumentation. |
Unterstützte Gerätetypen und Traits ansehen
Über das Fragezeichen Hilfesymbol oben rechts werden der aktuelle Gerätetyp und die Trait-Liste angezeigt, die von Google Home Playground unterstützt werden.
Probleme melden
Deine Meinung ist uns wichtig. Melden Sie aufgetretene Probleme mithilfe des Ausrufezeichensymbols Feedback oben rechts.
