Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.

Google Home Playground

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Geräte-SDK

Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.

Kontoverknüpfung abschließen

Zur Verwendung von Home Playground empfehlen wir, das Tool zuerst mit Ihrem Konto zu verknüpfen. Google Home app (GHA) on your phone, and go through the account linking process: öffnen

  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 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 Authorize (Autorisieren), um die Kontoverknüpfung zu autorisieren.
Diese Abbildung zeigt die Verknüpfung des Google Home App-Kontos mit dem Google Home Playground.

Sobald die Kontoverknüpfung abgeschlossen ist, werden auf der GHA einige virtuelle Standardgeräte angezeigt, mit denen Sie interagieren können.

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

Anmelden

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

Playground starten

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

Diese Abbildung zeigt den Anfangsstatus des Google Home Playgrounds und die Anmeldeschaltfläche in der rechten oberen Ecke.

Nach der Anmeldung zeigt Home Playground die virtuellen Geräte an, die in Home Graph gespeichert sind.

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

Die Webbenutzeroberfläche besteht aus drei Bereichen:

  • In der Geräteliste sehen Sie alle Ihre virtuellen Geräte. Sie können ein bestimmtes virtuelles Gerät auswählen, um dessen Informationen anzusehen und virtuelle Geräte über dieses Feld zu erstellen.
  • Unter Geräteinformationen sehen Sie die Informationen des ausgewählten virtuellen Geräts. Sie können diese Informationen auch bearbeiten und das ausgewählte virtuelle Gerät über das Feld entfernen.
  • Im Logbereich werden die Interaktionslogs zwischen Home Playground und Home Graph angezeigt. Sie können die Logs erweitern, 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 gewünschte virtuelle Gerät aus. Im Bereich Geräteinformationen werden die Informationen in fünf Tabs unterteilt:

  • Allgemeine Informationen: Attribute der obersten Ebene des Geräts, einschließlich Gerätetyp, ID und Name.
  • Attribute: unterstützte Funktionen des Geräts.
  • Attribute: Eigenschaften des Geräts.
  • Status:alle Gerätezustände.
  • SUV:Sekundäre Nutzerbestätigung für das Gerät.

Informationen zu virtuellen Geräten bearbeiten

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

Unterstützte Merkmale ändern

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

Geräteattribute ändern

  1. Wählen Sie den Tab Allgemeine Informationen/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 können diese aktualisierten Attribute im Bereich „Log“ einsehen.

Gerätestatus ändern

  1. Wählen Sie den Tab Bundesstaaten 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 auf virtuellem Gerät hinzufügen

Sie können virtuellen Geräten einen SUV hinzufügen und den Wettkampftyp 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ählen Sie im Bereich Geräteinformationen den Tab SUV aus und konfigurieren Sie Folgendes:
    • Aktiviert: Gibt an, ob der SUV auf dem Gerät aktiviert oder deaktiviert ist.
    • Herausforderungstyp: Gibt an, ob SUV eine ausdrückliche Bestätigung (ackNeeded) oder eine persönliche Identifikationsnummer (pinNeeded) erfordert.
    • PIN:Die gültige PIN.
    • Falsche PIN-Eingabe: Wenn die falsche PIN eingegeben wurde, ob der Nutzer noch einmal gefragt werden muss, ob er nicht geantwortet hat
Diese Abbildung zeigt das UX-Tool zum Aktivieren sekundärer Nutzerbestätigungsattribute auf einem ausgewählten Gerät im Google Home Playground.

Geräte finden, die SUV unterstützen

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

Diese Zahl zeigt Geräte, die für die Aktivierung der sekundären Nutzerbestätigung empfohlen werden.

Die folgende Liste der Merkmale erfordert SUV:

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 das neue Gerät ein. Alternativ können Sie eine vordefinierte Gruppe von Geräten zum Hinzufügen auswählen.
  3. Nachdem Sie alle Schritte ausgeführt haben, wird das neue Gerät 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 und klicken Sie unten auf PapierkorbsymbolGerät entfernen.
  2. Bestätigen Sie das Entfernen des Geräts in der Pop-up-Benachrichtigung.
  3. Sobald Sie das Entfernen des Geräts bestätigen, wird es aus Home Graph entfernt.
Diese Abbildung zeigt das UX-Tool zum Entfernen eines virtuellen Gerätetyps in Google Home Playground.

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 sie zu importieren und zu replizieren.

Diese Abbildung zeigt das UX-Tool zum Importieren und Exportieren von virtuellen Geräten 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 exportierter virtueller 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 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 Sie mit den virtuellen Geräten interagieren, wendet 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 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 API-Aufrufs Home Graph.
request object Anfragetext des API-Aufrufs Home Graph. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation.
response object Antworttext des API-Aufrufs Home Graph. Informationen zum Format der einzelnen Methoden finden Sie in der Referenzdokumentation.

Unterstützte Gerätetypen und -merkmale ansehen

Über das Fragezeichen-Hilfesymbol oben rechts können Sie den aktuellen Gerätetyp und die von Home Playground unterstützte Liste der Merkmale anzeigen.

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

Feedback und Probleme melden

Ihre Meinung ist uns wichtig. Sie können uns Feedback geben, indem Sie oben rechts auf das Smiley-Symbol Sentiment_Zufrieden klicken. Alternativ können Sie Probleme mit dem Ausrufezeichen Feedback melden.

Diese Abbildung zeigt die Symbole für Feedback und Probleme in Google Home Playground.