Schema für Smart-Home-Szeneneigenschaften
action.devices.traits.Scene
: Diese Eigenschaft wird verwendet, um virtuelle Geräte zusammen mit dem SCENE-Gerätetyp zu implementieren.
Weitere Informationen finden Sie in der Anleitung zum Szenentyp.
Wenn Nutzer auf einem Gerät beispielsweise Befehle mit nur einer Berührung konfigurieren können, um Lampen auf bestimmte Farben einzustellen oder verschiedene Sicherheitsfunktionen zu sequenzieren oder eine beliebige andere Kombination von Aktivitäten auszuführen, kann diese Konfiguration über SYNC
als benannte Szene bereitgestellt werden. Assistant stellt Nutzern diese Szenen dann über eine einfache Aktivierungsgrammatik zur Verfügung:
- Partymodus starten
- Aktiviere die Mitternachtsszene.
Als virtuelle Objekte können Szenen zur Unterscheidung in Räumen (falls relevant) platziert werden:
- Partyzeit in der Küche starten
- Aktiviere den Nachtsichtmodus in den Schlafzimmern.
Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Scene-Befehle anwendet, sodass Nutzer Szenen über mehrere Partner hinweg auslösen können. Wenn ein Nutzer beispielsweise eine Partymodus-Szene mit zwei verschiedenen Partnern hat, einen für die Sicherheit und einen für Lampen, werden beide durch Partymodus aktivieren ausgelöst.
Szenen werden gut mit zukünftigen persönlichen Aktionen für benutzerdefinierte Grammatik interagieren (z. B. Partymodus aktivieren -> Los gehts!).
Szenen sollten immer vom Nutzer vergebene Namen haben, anstatt die Standardbenennung „BobCo Scene“ zu verwenden. Jede Szene ist ein eigenes virtuelles Gerät mit eigenen Namen.
Von Nutzern angegebene Namen können aus SYNC
stammen.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. 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, die den Status ändern und den vorherigen Status speichern. Das Gerät unterstützt den Befehl |
Beispiele
Gerät, das eine umkehrbare Szene unterstützt
{ "sceneReversible": true }
Gerät STATES
Keine.
BEFEHLE auf Gerät
Geräte mit dieser Eigenschaft 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. „True“, um eine Szene abzubrechen, wenn sie umkehrbar ist, „false“, um eine Szene zu aktivieren. |
Beispiele
Eine Szene anhand des Namens aktivieren
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Eine Szene anhand des Namens deaktivieren.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }