Fan Schema

Nest 温控器 

sdm.devices.traits.Fan

此特征属于任何具有控制风扇的系统能力的设备。

字段

字段 说明 数据类型
timerMode 当前计时器模式。 string
值：“ON”“OFF”
timerTimeout 时间戳（采用 RFC 3339 格式），用于指示计时器模式何时关闭。 string
示例：“2019-05-10T03:22:54Z”

GET 请求和响应示例

请求

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

响应

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

命令

SetTimer

更改风扇计时器。

SetTimer 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

响应

{}

SetTimer 请求字段

字段 说明 数据类型
timerMode 用于设置风扇计时器的模式。 string
值：“ON”“OFF”
duration 可选。指定计时器设定的运行时长（以秒为单位）。 string
范围：“1 秒”到“43200 秒”
默认值：“900 秒”

错误

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

错误消息 RPC 问题排查
温控器风扇不可用。 FAILED_PRECONDITION 温控器不支持风扇。 风扇相关特征和指令无法用于此设备。

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