ThermostatMode 架构

Nest Thermostat 

sdm.devices.traits.ThermostatMode

此特征属于支持不同温控器模式的温控器设备类型。

字段

字段	说明	数据类型
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

更改温控器模式。

此特征不适用于节能模式。如需了解详情，请参阅 ThermostatEco 特征。

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”

错误数

可能会返回与此 trait 相关的以下错误代码：

错误消息	RPC	问题排查
在当前温控器模式下，系统不允许使用命令。	FAILED_PRECONDITION	根据 ThermostatMode 特征，某些温控器型号不支持在温控器模式处于关闭状态时更改节能模式。您必须先将温控器模式改为“HEAT”（制热）、“COOL”（制冷）或 HEATCOOL（“HEATCOOL”），然后才能更改节能模式。

如需查看 API 错误代码的完整列表，请参阅 API 错误代码参考。