在鸿云文档

Appearance

简版-网关与子设备设置设备属性 ​

平台可主动发送请求设置设备属性的命令到设备，设备反馈给平台设置设备属性结果，上报到平台。

请求topic定义 ​

请求topic：tlink/${productKey}/${deviceName}/command/setProperty/exec

数据流向：平台发布消息，设备监听消息

注意：这里的productKey和deviceName都是网关设备的。

请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
  "method": "tlink.${productKey}.${deviceName}.command.setProperty.exec",
  "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "data": {
    "temperature": "30.5"
  }
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。全局唯一，用于系统消息追踪
vString是协议版本号，目前协议版本号唯一取值为1
tLong是消息发送时间戳
deviceIdString是设备ID,可能是网关设备自己的id，也可能是子设备的设备id，如果是子设备的id，就是设置的子设备的属性数据
methodString否TCP连接时必传
dataObject是属性设置参数。
如以上示例中，设置属性：{ "temperature": "30.5" }。
如果是自定义模块属性，属性标识符格式为模块标识符:属性标识符（中间为英文冒号），例如{ "test:temperature": "30.5" }。
  keyString是设置的属性名
  valueother是设置的属性值

响应设置设备属性 ​

响应topic定义 ​

设置属性响应的topic说明：tlink/${productKey}/${deviceName}/command/setProperty/exec_reply

数据流向：设备发布消息，平台监听消息

响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "method": "tlink.${productKey}.${deviceName}.command.setProperty.exec_reply",
  "deviceId": "8725dfbe93a64c5db1653ca766c036ce_sn1234",
  "code": 200,
  "data": {}
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
deviceIdString是设备ID,可能是网关设备自己的id，也可能是子设备的设备id
codeInteger是结果状态码。成功为200，其他为失败
dataObject否请求成功时，返回的数据。不需要返回则为空。