平台消息下发
功能介绍
设备无法按照产品模型中定义的格式进行指令下发时,可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式,即在应用侧API的下发设备消息中payload_format填写为“standard”,或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。
消息下发和命令下发的区别,请查看消息通信说明。
低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
Topic
下行:$oc/devices/{device_id}/sys/messages/down
参数说明
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
object_device_id |
可选 |
String |
参数解释:
|
name |
可选 |
String |
参数解释: 消息名称,可不填写,做说明用。 |
id |
可选 |
String |
参数解释: 消息的唯一标识,用于区分与查找消息。如不填写系统会自动生成一个消息ID,消息ID不可重复。 |
content |
必选 |
String |
参数解释: 消息内容,可以为base64编码格式。 |
示例
系统格式:
Topic: $oc/devices/{device_id}/sys/messages/down 数据格式: { "object_device_id": "{object_device_id}", "name": "name", "id": "id", "content": "hello" }
自定义格式:
Topic: $oc/devices/{device_id}/sys/messages/down 数据格式: arbitrary content