Smart-Home-Szenenleitfaden
action.devices.types.SCENE
: Bei Szenen ist der Typ 1:1 dem Merkmal zugeordnet, da Szenen nicht mit anderen Merkmalen kombiniert werden, um zusammengesetzte Geräte zu bilden. Szenen sollten immer vom Nutzer vergebene Namen haben. Jede Szene ist ein eigenes virtuelles Gerät mit einem eigenen Namen.
Dieser Typ gibt an, dass das Gerät das Szenensymbol und einige zugehörige Synonyme und Aliasse erhält.
Weitere Informationen finden Sie im Abschnitt zu den Szenenmerkmalen.
Gerätefunktionen
In der entsprechenden Trat-Dokumentation finden Sie Details zur Implementierung, z. B. Attribute und Status, die Ihr Dienst unterstützen sollte, und das Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Eigenschaften und Befehle sind gegebenenfalls für Ihr Gerät erforderlich.
Qualitätsanforderungen
- Latenz muss kleiner oder gleich 3.000 ms sein.
- Zuverlässigkeit muss mindestens 97% betragen.
Beispielgerät: Einfache Szene
Dieser Abschnitt enthält beispielhafte Intent-Nutzlasten, die je nach Gerätetyp und Merkmalen oben eine gemeinsame "Szene" darstellen. Wenn du in deiner Implementierung Merkmale hinzufügst oder entfernst, ändere deine Antworten entsprechend.
SYNC-Beispielantwort
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SCENE", "traits": [ "action.devices.traits.Scene" ], "name": { "name": "Simple scene" }, "willReportState": true, "attributes": { "sceneReversible": true }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
QUERY-Beispielantwort
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true } } } }
Beispiele für EXECUTE-Befehle
Szene aktivieren
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu action.devices.traits.Scene
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }