Smart-Home-Lüfter – Anleitung
action.devices.types.FAN
: Ventilatoren können normalerweise ein- und ausgeschaltet werden und haben Geschwindigkeitseinstellungen. Einige Lüfter verfügen möglicherweise über zusätzliche unterstützte Modi, z. B. Lüfterrichtung/Ausrichtung. Eine Wandeinheit kann beispielsweise Einstellungen haben, mit denen sich einstellen lässt, ob der Ventilator nach oben oder unten bewegt wird.
Dieser Typ gibt an, dass das Gerät das Lüftersymbol und einige zugehörige Synonyme und Aliasse hat.
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 700 ms sein.
- Zuverlässigkeit muss mindestens 97% betragen.
Beispielgerät: Einfacher Lüfter
Dieser Abschnitt enthält Intent-Nutzlasten, die je nach Gerätetyp und Merkmalen oben einen gemeinsamen "Fan" 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.FAN", "traits": [ "action.devices.traits.FanSpeed", "action.devices.traits.OnOff" ], "name": { "name": "Simple fan" }, "willReportState": true, "attributes": { "availableFanSpeeds": { "speeds": [ { "speed_name": "low_key", "speed_values": [ { "speed_synonym": [ "low", "slow" ], "lang": "en" }, { "speed_synonym": [ "niedrig", "schleppend" ], "lang": "de" } ] }, { "speed_name": "high_key", "speed_values": [ { "speed_synonym": [ "high" ], "lang": "en" }, { "speed_synonym": [ "hoch" ], "lang": "de" } ] } ], "ordered": true }, "reversible": 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, "on": true, "currentFanSpeedSetting": "low_key" } } } }
Beispiele für EXECUTE-Befehle
SetFanSpeed
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu action.devices.traits.FanSpeed
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "high_key" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentFanSpeedSetting": "high_key" } } ] } }
An
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu action.devices.traits.OnOff
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }