Appearance
设置设备属性
平台可以设置设备属性,设备收到属性设置请求后,修改成对应的属性值。
请求topic定义
请求topic:tlink/${productKey}/${deviceName}/command/setProperty/exec
数据流向:平台发布消息,设备监听消息
请求数据体格式
请求数据格式
javascript
{
"reqid": "0020fdf71f0d491da12ba3cd38b205be",
"v": "1",
"t": 1630054074378,
"method": "tlink.${productKey}.${deviceName}.command.setProperty.exec",
"data": {
"temperature": "30.5"
}
}
请求参数说明
参数名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
reqid | String | 是 | 消息ID号。全局唯一,用于系统消息追踪 |
v | String | 是 | 协议版本号,目前协议版本号唯一取值为1 |
t | Long | 是 | 消息发送时间戳 |
method | String | 否 | TCP连接时必传 |
data | Object | 是 | 属性设置参数。 如以上示例中,设置属性: { "temperature": "30.5" } 。 如果是自定义模块属性,属性标识符格式为 模块标识符:属性标识符 (中间为英文冒号),例如{ "test:temperature": "30.5" } 。 |
key | String | 是 | 设置的属性名 |
value | other | 是 | 设置的属性值 |
响应设置设备属性
响应topic定义
设置属性响应的topic说明:tlink/${productKey}/${deviceName}/command/setProperty/exec_reply
数据流向:设备发布消息,平台监听消息
响应数据体格式
javascript
{
"reqid": "0020fdf71f0d491da12ba3cd38b205be",
"method": "tlink.${productKey}.${deviceName}.command.setProperty.exec_reply",
"code": 200,
"data": {}
}
响应参数说明
参数名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
reqid | String | 是 | 消息ID号。和请求的对应 |
method | String | 否 | TCP连接时必传 |
code | Integer | 是 | 结果状态码。成功为200,其他为失败 |
data | Object | 否 | 请求成功时,返回的数据。不需要返回则为空。 |