Tuya物联网平台设备属性指南_云市场(Marketplace)-阿里云帮助中心

设置设备属性

通过调用SetDeviceProperty或SetDevicesProperty下发设置属性指令到设备。

设置设备属性的原理：

重要

设置设备属性成功，只表示物联网平台云端下发属性设置请求成功，不保证设备端执行了该请求。所以设备端SDK成功响应云端设置设备属性值的请求后，需上报对应属性值，设备属性值才能真正设置成功。设备上报属性说明，请参见本文“设备上报属性”。

Topic和数据格式（下行）：

数据格式（下行）	请求和响应Topic
透传/自定义	请求Topic：`/sys/${productKey}/${deviceName}/thing/model/down_raw` 响应Topic：`/sys/${productKey}/${deviceName}/thing/model/down_raw_reply`
JSON	请求Topic：`/sys/${productKey}/${deviceName}/thing/service/property/set` 响应Topic：`/sys/${productKey}/${deviceName}/thing/service/property/set_reply`

请求数据格式：

{
    "id": "123",
    "version": "1.0",
    "params": {
        "temperature": "30.5"
    },
    "method": "thing.service.property.set"
}

响应数据格式：

{
    "code": 200,
    "data": {},
    "id": "123",
    "message": "success",
    "version": "1.0"
}

{
    "code": 9201,
    "data": {},
    "id": "123",
    "message": "device offLine",
    "version": "1.0"
}

参数说明：

参数	类型	说明
id	String	消息ID号，String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
version	String	协议版本号，目前协议版本号唯一取值为1.0。
params	Object	属性设置参数。如以上示例中，设置属性：`{ "temperature": "30.5" }`。
method	String	请求方法。例如：`thing.service.property.set`。

响应数据格式：

参数	类型	说明
id	String	消息ID号，String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。
code	Integer	结果状态码，具体参考设备端通用code。
data	Object	请求成功时，返回的数据固定为空。
message	String	返回结果信息。请求成功时，返回success。
version	String	协议版本号，与请求参数中version相同。