Google Home Playground

Geräte-SDK

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, 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 Google Home app (GHA) 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 > Mit Geräten von Google kompatibel aus.
  3. Suchen Sie nach der Aktion mit dem Titel Google Home Playground.
  4. Wählen Sie die Aktion aus. Über GHA gelangen Sie zur Anmeldeseite. Klicken Sie auf Über Google anmelden und wählen Sie Ihr Konto aus, um sich anzumelden.
  5. Klicken Sie auf die Schaltfläche Autorisieren, um die Kontoverknüpfung zu autorisieren.
Diese Abbildung zeigt den Kontoverknüpfungsvorgang zur Google Home App für die Verbindung mit Google Home Playground.

Nachdem die Kontoverknüpfung abgeschlossen ist, werden auf GHA eine Reihe virtueller Standardgeräte angezeigt, mit denen du interagieren kannst.

Diese Abbildung zeigt die Standardgeräteliste, die ausgefüllt wird, wenn ein Nutzer Google Home Playground erfolgreich mit seinem Konto verknüpft hat.

Anmelden

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

Playground nutzen

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.

Diese Abbildung zeigt den Ausgangszustand von Google Home Playground. Die Anmeldeschaltfläche oben rechts ist hervorgehoben.

Nach der Anmeldung zeigt Google Home Playground die in Home Graph gespeicherten virtuellen Geräte an.

Diese Abbildung zeigt die Geräteliste, die 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. In diesem Bereich können Sie ein bestimmtes virtuelles Gerät auswählen, um seine Informationen aufzurufen 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 für die 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. Die Informationen im Bereich Geräteinformationen sind in fünf Tabs unterteilt:

  • Allgemeine Informationen:Übergeordnete Eigenschaften des Geräts, einschließlich Gerätetyp, ID und Name.
  • Eigenschaften: unterstützte Eigenschaften des Geräts.
  • Attribute:merkmalsspezifische Attribute des Geräts.
  • Status:alle Gerätestatus
  • SUV: Konfiguration der sekundären Nutzerbestätigung des Geräts.

Informationen zu virtuellen Geräten bearbeiten

Über den Bereich Geräteinformationen können Sie nicht nur die Informationen eines virtuellen Geräts aufrufen, sondern auch die in Home Graph gespeicherten Informationen direkt 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-Steuerfeld werden die derzeit unterstützten Eigenschaften des Geräts und die verfügbaren Traits angezeigt, die hinzugefügt werden können. Mit dem Pfeil (arrow_forward/arrow_back) können Sie unterstützte Traits für das Gerät hinzufügen oder entfernen.
  3. Wenn Sie mit der Aktualisierung der unterstützten Merkmale fertig sind, klicken Sie auf Speichern. Die aktualisierten Merkmale werden auf Home Graph angewendet.
  4. Die aktualisierten Eigenschaften werden im Protokollbereich angezeigt.
Diese Abbildung zeigt das UX-Tool zum Hinzufügen oder Löschen unterstützter Traits auf einem ausgewählten Gerät in 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 Merkmale.
  2. Wenn Sie mit der Bearbeitung fertig sind, drücken Sie die Eingabetaste. Ihre Attributänderungen werden auf Home Graph angewendet.
  3. Sie können die aktualisierten Attribute im Protokollbereich einsehen.

Gerätestatus ändern

  1. Wählen Sie den Tab US-Bundesstaaten aus und bearbeiten Sie den Bundesstaat direkt. Die Statusänderungen werden auf Home Graph angewendet.
  2. Sie können diese Statusänderungen im Protokollbereich sehen.

Sekundäre Nutzerbestätigung zum virtuellen Gerät hinzufügen

Sie können virtuellen Geräten einen SUV hinzufügen und den Identitätsbestätigungstyp und das entsprechende Verhalten auf jedem Gerät konfigurieren. Sie können virtuellen Geräten einen SUV hinzufügen und den Identitätsbestätigungstyp und das entsprechende Verhalten auf jedem Gerät konfigurieren.

SUV auf Gerät konfigurieren

  1. Wählen Sie im Bereich Geräteliste das virtuelle Gerät aus, das Sie konfigurieren möchten.
  2. Wähle im Bereich Geräteinformationen den Tab SUV aus und konfiguriere Folgendes:
    • Aktiviert:Gibt an, ob der SUV auf dem Gerät aktiviert oder deaktiviert ist (keine Identitätsbestätigung).
    • Art der Identitätsbestätigung:Gibt an, ob für den SUV eine explizite Bestätigung (ackNeeded) oder eine persönliche Identifikationsnummer (pinNeeded) erforderlich ist.
    • PIN:Die gültige PIN.
    • Handhabung einer falschen PIN:Wenn die PIN falsch ist, wird angegeben, ob der Nutzer noch einmal gefragt werden soll. Ist dies nicht der Fall, wird die Fehlermeldung angezeigt, dass er antworten soll.
Diese Abbildung zeigt das UX-Tool zum Aktivieren sekundärer Nutzerbestätigungsmerkmale auf einem ausgewählten Gerät im Google Home Playground.

Geräte identifizieren, die SUVs ermöglichen

Im Bereich Geräteliste wird neben jedem SUV-fähigen Gerät ein Schlüsselsymbol Schlüssel angezeigt.

Diese Abbildung zeigt Geräte, für die die sekundäre Nutzerbestätigung aktiviert werden sollte.

Für die folgende Liste von Eigenschaften 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 zum Hinzufügen auswählen.
  3. Sobald du alle Schritte abgeschlossen hast, wird das neue Gerät zu Home Graph hinzugefügt.
Diese Abbildung zeigt das UX-Tool zum Hinzufügen eines neuen Gerätetyps in Google Home Playground.

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. 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 in der Pop-up-Benachrichtigung.
  3. Sobald du das Entfernen des Geräts bestätigt hast, wird es aus Home Graph entfernt.
Diese Abbildung zeigt das UX-Tool zum Entfernen eines virtuellen Gerätetyps in Google Home Playground.

Editor für Synchronisierungsantworten

Sie können Ihre Synchronisierungsantwort in Google Home Playground validieren oder aktualisieren. Klicken Sie auf Sync Response Editor (Antworteditor synchronisieren), um eine eingebettete IDE zu öffnen.

Diese Abbildung zeigt die Schaltfläche zum Öffnen des Editors für Synchronisierungsantworten.

Bearbeiten Sie Ihre Synchronisierungsantwort oder kopieren Sie sie und fügen Sie sie ein. Klicken Sie auf Speichern, um die Änderungen zu übernehmen und zu sehen, wie sie auf Google Home-Geräten funktioniert.

Diese Abbildung zeigt das Fenster zum Bearbeiten der Synchronisierungsantwort.

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 freigeben, um Ihre virtuellen Geräte zu importieren und zu replizieren.

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. Sobald 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 den Status der importierten Geräte in Home Graph.

Interaktionslogs prüfen

Wenn Sie mit den virtuellen Geräten interagieren, wendet Google Home Playground Ihre Ä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 von Home Graph-API-Anfragen und -Antworten 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 in der Referenzdokumentation.
response object Antworttext des API-Aufrufs Home Graph. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation in der Referenzdokumentation.

Unterstützte Gerätetypen und -merkmale ansehen

Über das Fragezeichen-Hilfesymbol oben rechts kannst du den aktuellen Gerätetyp und die Liste der Eigenschaften aufrufen, die von Google Home Playground unterstützt werden.

Diese Abbildung zeigt das UX-Tool zum Hinzufügen eines neuen Gerätetyps in Google Home Playground.

Probleme melden

Ihre Meinung ist uns wichtig. Melden Sie Probleme über das Ausrufezeichensymbol Feedback oben rechts.

Diese Abbildung zeigt die Symbole für Feedback und zum Melden von Problemen in Google Home Playground.