Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema für Smart-Home-Szene

action.devices.traits.Scene: Mit dieser Eigenschaft werden virtuelle Geräte zusammen mit dem Gerätetyp „SZENE“ implementiert.

Weitere Informationen finden Sie im Leitfaden zu Szenentypen.

Wenn ein Gerät beispielsweise Nutzern die Möglichkeit bietet, Befehle mit nur einer Berührung zu konfigurieren – Licht auf bestimmte Farben zu setzen oder verschiedene Sicherheitsfunktionen zu sequenzieren – oder eine andere Kombination von Aktivitäten durchzuführen, kann diese Konfiguration über SYNC als benannte Szene zur Verfügung gestellt werden. Assistant stellt diese Szene dann mithilfe einer einfachen Aktivierungsgrammatik zur Verfügung:

  • Partymodus starten
  • Mitternachtsszene aktivieren.

Als virtuelle Objekte können Szenen (sofern relevant) zur Unterscheidung in Räume platziert werden:

  • Partyzeit in der Küche.
  • Aktiviere den Nachtlichtmodus im Schlafzimmer.

Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Szenenbefehle anwendet. So können Nutzer Szenen zwischen mehreren Partnern auslösen. Wenn ein Nutzer beispielsweise eine Partyszene auf zwei verschiedenen Partnern hat, einen für die Sicherheit und einen für Lampen, löst Partymodus aktivieren beide aus.

Die Szenen interagieren mit anstehenden persönlichen Aktionen für benutzerdefinierte Grammatik wie etwa Partymodus aktivieren -> Los gehts!.

Szenen sollten vom Nutzer immer Namen haben und nicht die standardmäßigen Namen von Bob Co. Jede Szene ist ein eigenes virtuelles Gerät mit einem eigenen Namen. Vom Nutzer angegebene Namen können von SYNC stammen.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
sceneReversible Boolesch

(Standard: false)

Gibt an, dass diese Szene abgebrochen werden kann. Dieses Attribut ist nur für Szenen relevant, in denen der Zustand geändert und der vorherige Zustand beibehalten wird. Das Gerät unterstützt den Befehl ActivateScene mit dem Parameter deactivate auf „true“.

Beispiele

Gerät, das eine umkehrbare Szene unterstützt.

{
  "sceneReversible": true
}

Gerät STATES

Keine.

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.ActivateScene

Aktivieren oder deaktivieren Sie eine Szene.

Parameter

Parameter Typ Beschreibung
deactivate Boolesch

Erforderlich.

Die Einstellung „wahr“ gibt an, dass eine Szene abgebrochen werden soll, wenn sie reversibel ist, und „falsch“, um sie zu aktivieren.

Beispiele

Aktivieren Sie eine Szene anhand des Namens.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Szene nach Name deaktivieren:

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen