스마트 홈 온도 조절기 가이드
action.devices.types.THERMOSTAT - 온도 조절기는 설정값과 모드로 온도를 관리하는 기기입니다. 이렇게 하면 온도 목표 대비 모드 및 설정 (예: 고온/낮음)만 있을 수 있는 히터 및 AC 장치와 분리됩니다.
이 유형은 기기에 온도 조절기 아이콘 및 관련 일부 아이콘이 표시된다는 것을 나타냅니다. 동의어 및 별명
이 유형의 기기는 온도를 제어하지만 일부 난방/냉방 장치의 경우 온도가 다릅니다. 제어 및 고/저 모드이지만 온도 제어는 그렇지 않습니다.기기 기능
관련 트레잇 문서를 참고하세요. 서비스가 지원해야 하는 속성과 상태, EXECUTE 및 QUERY 응답을 빌드합니다.
필수 trait
이러한 특성과 명령은
있습니다. 기기가 이러한 특성을 지원하지 않는 경우
QUERY 또는 EXECUTE 응답의 functionNotSupported 자세한 내용은
오류 및 예외에서 자세한 내용을 확인하세요.
Thermostat 명령어는 EXECUTE 인텐트에 자주 체이닝됩니다. 사용자가
*난방을 22도로 설정* 이라고 말하면 모드 명령 뒤에 온도를 설정합니다.
품질 요구사항
- 지연 시간: 700ms 이하여야 합니다.
- 안정성: 97% 이상이어야 합니다.
기기 예: 간단한 온도 조절기
이 섹션에는 일반적인 'Thermostat'를 나타내는 인텐트 페이로드 예시가 포함되어 있습니다. 위 기기 유형과 특성에 따라 다를 수 있습니다. 구현에서 트레잇을 추가하거나 삭제하면 이러한 변경사항을 반영하도록 응답을 수정하세요.
샘플 SYNC 응답
<ph type="x-smartling-placeholder">{
"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" } } ] } }
샘플 QUERY 응답
<ph type="x-smartling-placeholder">{ "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 } } } }
샘플 EXECUTE 명령어
ThermostatTemperatureSetpoint
명령어 매개변수에 대한 자세한 내용은
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 } } ] } }
ThermostatTemperatureSetRange
명령어 매개변수에 대한 자세한 내용은
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 } } ] } }
ThermostatSetMode
명령어 매개변수에 대한 자세한 내용은
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 } } ] } }
기기 ERRORS
전체 목록 보기 오류 및 예외를 방지합니다.inHeatOrCool- 기기가 다음 온도 범위 내에 있으므로 난방/냉방/범위 명령 실패 냉난방이 될 수 있습니다.inHeatCool- 기기가 난방 또는 온도 조절기로 인해 난방 또는 냉방 명령에 실패함 좋습니다.lockedToRange- 기기가 온도 범위 또는 모드로 잠겨 있습니다. 요청한 변경사항을 적용할 수 없습니다.rangeTooClose- 냉난방 범위의 온도 지점이 너무 가깝습니다. 서로 연결됩니다.