Przewodnik po inteligentnym domowym termostacie
action.devices.types.THERMOSTAT
– termostaty to urządzenia zarządzające temperaturą za pomocą ustawionych punktów i trybów. To odróżnia je od grzejników i klimatyzatorów, które mogą mieć tylko ustawione tryby i ustawienia (np. wysoka/niska) w porównaniu z docelową temperaturą.
Ten typ oznacza, że urządzenie zobaczy ikonę termostatu oraz pewne powiązane synonimy i aliasy.
Urządzenia tego typu sterują temperaturą, podczas gdy niektóre urządzenia ogrzewania i chłodzenia mają różne opcje sterowania oraz tryby wysokiej/niskiej, ale nie sterują temperaturą.Funkcje urządzenia
W dokumentacji odpowiedniej cechy znajdziesz szczegółowe informacje na temat implementacji, takie jak atrybuty i stany, które powinna obsługiwać usługa, oraz informacje o tworzeniu odpowiedzi EXECUTE i QUERY.
Wymagane cechy
Te cechy i polecenia są wymagane, jeśli dotyczy to Twojego urządzenia. 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 artykule Błędy i wyjątki.
Polecenia termostatu są często łączone w intencjach EXECUTE
. Użytkownik, który powie *Ustaw ogrzewanie na 22 stopnie*, wyświetli polecenie trybu i ustaw temperaturę.
Wymagania dotyczące jakości
- Czas oczekiwania: nie może przekraczać 700 ms.
- Niezawodność: musi wynosić co najmniej 97%.
Przykładowe urządzenie: prosty termostat
Ta sekcja zawiera przykładowe ładunki intencji reprezentujące wspólny „termostat” określony na podstawie powyższego typu urządzenia i cech. Jeśli dodasz lub usuniesz cechy w swojej implementacji, zmodyfikuj odpowiedzi, by uwzględnić 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.THERMOSTAT", "traits": [ "action.devices.traits.TemperatureSetting" ], "name": { "name": "Simple thermostat" }, "willReportState": true, "attributes": { "availableThermostatModes": [ "off", "heat", "cool", "heatcool", "on" ], "thermostatTemperatureRange": { "minThresholdCelsius": 15, "maxThresholdCelsius": 30 }, "thermostatTemperatureUnit": "F" }, "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, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 23, "thermostatTemperatureAmbient": 25.1, "thermostatHumidityAmbient": 45.3 } } } }
Przykładowe polecenia EXECUTE
Nastawa temperatury termostatu
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetpoint", "params": { "thermostatTemperatureSetpoint": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ZakresUstawienia temperatury termostatu
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetRange", "params": { "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
Ustawianie trybu termostatu
Więcej informacji o parametrach poleceń znajdziesz w dokumentacji
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatSetMode", "params": { "thermostatMode": "heatcool" } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
Urządzenie ERRORS
Zobacz pełną listę błędów i wyjątków.inHeatOrCool
– polecenia ogrzewania/chłodzenia/zakresu temperatury nie działają, ponieważ urządzenie jest wyraźnie grzane lub chłodne.inHeatCool
– polecenia ogrzewania lub chłodzenia nie działają, ponieważ urządzenie jest nagrzewane lub chłodne.lockedToRange
– urządzenie jest zablokowane na podstawie zakresu lub trybu temperatury i nie można wprowadzić żądanej zmiany.rangeTooClose
– punkty temperatury w zakresie chłodzenia ogrzewania są zbyt blisko siebie.