文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 设备消息/ 平台消息下发
更新时间：2025-05-26 GMT+08:00
查看PDF
分享

平台消息下发

功能介绍

设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。

消息下发和命令下发的区别，请查看消息通信说明。

低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。

Topic

下行：$oc/devices/{device_id}/sys/messages/down

参数说明

表1 系统格式下发消息字段表

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

  • 平台下发时，若为直连设备，不携带该参数。
  • 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。

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
父主题： 设备消息

相关文档