Przewodnik dotyczący inteligentnego osuszacza powietrza
action.devices.types.DEHUMIDIFIER
– osuszacze powietrza to urządzenia, które odprowadzają wilgoć z powietrza. Można je włączać i wyłączać, zgłaszać i dostosowywać wilgotność docelową, a także mieć różne tryby i ustawienia szybkości wentylatora.
Ten typ oznacza, że urządzenie wyświetla ikonę osuszacza powietrza oraz pewne powiązane synonimy i aliasy.
Funkcje urządzenia
W dokumentacji odpowiedniej cechy znajdziesz szczegółowe informacje o implementacji, takie jak atrybuty i stany, które powinna obsługiwać Twoja usługa, oraz sposoby tworzenia odpowiedzi EXECUTE i QUERY.
Wymagane cechy
Te cechy i polecenia są wymagane, jeśli masz je na urządzeniu. Jeśli Twoje urządzenie nie obsługuje tych cech, wpisz kod błędu functionNotSupported
w odpowiedzi QUERY lub EXECUTE. Więcej informacji znajdziesz w sekcji Błędy i wyjątki.
Zalecane cechy
Te cechy są zalecane, jeśli korzystasz z Twojego urządzenia. Możesz jednak łączyć i dopasowywać różne cechy, aby najlepiej pasowały do dotychczasowych funkcji produktu.
-
action.devices.traits.FanSpeed
-
action.devices.traits.HumiditySetting
-
action.devices.traits.StartStop
Wymagania dotyczące jakości
- Czas oczekiwania: nie może przekraczać 1000 ms.
- Niezawodność: musi wynosić co najmniej 97%.
Przykładowe urządzenie: prosty osuszacz powietrza
Ta sekcja zawiera przykładowe ładunki intencji reprezentujące powszechny „Osuszacz powietrza” na podstawie typu urządzenia i jego cech opisanych powyżej. Jeśli dodasz lub usuniesz cechy w implementacji, zmodyfikuj odpowiedzi, by odzwierciedlić te zmiany.
Przykładowa odpowiedź SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DEHUMIDIFIER", "traits": [ "action.devices.traits.FanSpeed", "action.devices.traits.HumiditySetting", "action.devices.traits.OnOff" ], "name": { "name": "Simple dehumidifier" }, "willReportState": true, "attributes": { "humiditySetpointRange": { "minPercent": 5, "maxPercent": 50 }, "availableFanSpeeds": { "speeds": [ { "speed_name": "low_key", "speed_values": [ { "lang": "en", "speed_synonym": [ "Low", "Slow" ] }, { "lang": "de", "speed_synonym": [ "Niedrig", "Schleppend" ] } ] }, { "speed_name": "high_key", "speed_values": [ { "lang": "en", "speed_synonym": [ "High" ] }, { "lang": "de", "speed_synonym": [ "Hoch" ] } ] } ], "ordered": true } }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Przykładowa odpowiedź na zapytanie QUERY
{ "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", "humiditySetpointPercent": 10, "humidityAmbientPercent": 20 } } } }
Przykładowe polecenia EXECUTE
SetFanSpeed
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
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" } } ] } }
SetHumidity
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
action.devices.traits.HumiditySetting
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetHumidity", "params": { "humidity": 15 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "humiditySetpointPercent": 15, "humidityAmbientPercent": 20 } } ] } }
OnOff
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }