ThermostatMode 스키마

Nest Thermostat 

sdm.devices.traits.ThermostatMode

이 트레잇은 다양한 온도 조절기 모드를 지원하는 THERMOSTAT 기기 유형에 속합니다.

필드

필드 설명 데이터 유형
availableModes 지원되는 온도 조절기 모드 목록입니다. array(string)
값: ["HEAT", "COOL", "HEATCOOL", "OFF"]
mode 현재 온도 조절기 모드입니다. string
값: 'HEAT', 'COOL', 'HEATCOOL', 'OFF'

샘플 GET 요청 및 응답

요청

GET /enterprises/project-id/devices/device-id

응답

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    }
  }
}

명령어

SetMode

온도 조절기 모드를 변경합니다.

SetMode 요청 및 응답

요청

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

응답

{}

SetMode 요청 필드

필드 설명 데이터 유형
mode 온도 조절기를 변경할 모드입니다. string
값: 'HEAT', 'COOL', 'HEATCOOL', 'OFF'

오류

이 트레잇과 관련하여 다음과 같은 오류 코드가 반환될 수 있습니다.

오류 메시지 RPC 문제 해결
현재 온도 조절기 모드에서는 명령어를 사용할 수 없습니다. FAILED_PRECONDITION 일부 온도 조절기 모델은 ThermostatMode 트레잇에 따라 온도 조절기 모드가 꺼져 있을 때 절전 모드를 변경하는 기능을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 HEAT, COOL 또는 HEATCOOL로 변경해야 합니다.

API 오류 코드의 전체 목록은 API 오류 코드 참조를 확인하세요.