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: 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 |
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 } }