Schema der Smart Home-Szene
action.devices.traits.Scene
: Mit dieser Eigenschaft werden virtuelle Geräte zusammen mit dem Gerätetyp „SCENE“ implementiert.
Weitere Informationen finden Sie im Leitfaden zu Szenentypen.
Wenn Nutzer auf einem Gerät z. B. Befehle mit nur einer Berührung konfigurieren können – beispielsweise können die Lichter auf bestimmte Farben festgelegt oder verschiedene Sicherheitsfunktionen oder andere Aktivitäten ausgeführt werden –, kann diese Konfiguration über SYNC
als benannte Szene bereitgestellt werden.
- Partymodus starten
- Mitternachtsszenen aktivieren.
Virtuelle Objekte können zum Zweck der Unterscheidung in Räumen platziert werden:
- Partyzeit in der Küche beginnen
- Aktiviere den Nachtlichtmodus in den Schlafzimmern.
Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Befehle in Szenen anwenden kann, sodass Nutzer Szenen über mehrere Partner hinweg auslösen können. Wenn ein Nutzer beispielsweise eine Szene im „Partymodus“ von zwei verschiedenen Partnern hat, einen für die Sicherheit und einen für die Beleuchtung, wird durch den Partymodus aktivieren beides ausgelöst.
Szenen interagieren mit anstehenden persönlichen Aktionen für benutzerdefinierte Grammatik, z. B. Partymodus aktivieren -> Lass uns die Party beginnen!.
Szenen sollten immer vom Nutzer bereitgestellte Namen haben und die Standardbezeichnung „BobCo Scene“ verwenden. Jede Szene ist mit einem eigenen virtuellen Gerät und eigenen Namen ausgestattet.
Von Nutzern übermittelte Namen können von SYNC
stammen.
Geräte-ATTRIBUTE
Geräte mit diesem Merkmal können im Rahmen des SYNC
-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
sceneReversible |
Boolesch |
(Standard: Gibt an, dass die Szene abgebrochen werden kann. Dieses Attribut ist nur für Szenen relevant, die den Zustand ändern und sich an den vorherigen Zustand erinnern. Das Gerät unterstützt den Befehl |
Beispiele
Gerät, das eine reversible Szene unterstützt.
{ "sceneReversible": true }
Gerätestatus
Keine.
BEISPIELE für Geräte
Geräte mit diesem Merkmal können im Rahmen des EXECUTE
-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.ActivateScene
Szene aktivieren oder deaktivieren
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
deactivate |
Boolesch |
Erforderlich. Dieser Wert ist „true“, um eine Szene abzubrechen, wenn sie rückgängig gemacht werden kann, und „false“, um eine Szene zu aktivieren. |
Beispiele
Aktivieren Sie eine Szene anhand des Namens.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Szene mit Namen deaktivieren:
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }