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 ist eine Webanwendung, mit der Sie ein Smart-Home-Projekt simulieren können, indem Sie ein virtuelles Zuhause mit konfigurierbaren Gerätetypen und Merkmalen simulieren. Mit Home Playground können Sie 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

Zur Verwendung von Home Playground empfehlen wir, das Tool zuerst mit Ihrem Konto zu verknüpfen. Öffne Google Home app (GHA) auf deinem Smartphone und führe die Schritte zur 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 Google Home Playground.
  4. Wähle die Aktion aus. GHA leitet dich dann zur Anmeldeseite weiter. 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 eine Reihe von virtuellen Standardgeräten auf dem GHA angezeigt, mit denen du interagieren kannst.

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 in 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 direkt über den Bereich Geräteinformationen 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. Ihre 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 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 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 werden der aktuelle Gerätetyp und die von Home Playground unterstützte Liste der Probleme angezeigt.

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.