PUT 控制灯具

PUT /clip/v2/resource/light/light_uuid

说明

• 用于控制一个灯具
• 参数为严格模式, 如果不希望控制, 不要传这个key
• 控制颜色时, 多段色, 彩色, 冷暖色 相互冲突, 请不要一起传入
• 如果一起传入, 那么优先级是 多段色 > 彩色 > 冷暖色
• 请求会立刻返回成功, 并将内存中灯具的状态设置为请求值
• 实际的控制指令会稍后发出

注意 网关内部存在一个状态同步机制, 会将内存中的灯具状态刷新成实际值 如: 设备A, 亮度为100%, 控制灯亮度设置为 50%, 假设指令丢包, 那么 此时调用查询接口, 会得到亮度50% 过10秒左右再调用接口, 会得到亮度100%

Body 请求参数

{
  "on": true
}

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	否		none
» on	body	boolean	否	开关	none
» brightness	body	integer	否	亮度	none
» color_cw	body	integer	否	冷暖色	范围 2000 - 6500
» color_x	body	integer	否	彩色X值	none
» color_y	body	integer	否	彩色Y值	none
» color_arr	body	[object]	否	多段色	none
»» x	body	integer	否	多段X值	none
»» y	body	integer	否	多段Y值	none
» color_rgb	body	integer	否	RGB颜色值	0x112233，11:R 22:G 33:B
» color_rgb_arr	body	[object]	否	RGB多段色	RGB类型的integer数组

说明：获取灯具列表里面有个color_mode 表示灯目前处于的模式，在控制灯具的时候这个参数不需要传，网关会根据设置的值自动识别。

返回示例

{
  "code": 0,
  "data": {
    "arr": [],
    "obj": {}
  },
  "msg": "success"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none	状态码	none
» msg	string	true	none	信息	none