
# 平台消息下发
#### 功能介绍
设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的[下发设备消息](https://support.huaweicloud.com/api-iothub/iot_06_v5_0059.html)中payload_format填写为"standard"，或者在设备详情页的[云端下发-消息下发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0331.html)中下发时选择"按系统格式"。
消息下发和命令下发的区别，请查看[消息通信说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0050.html)。
![](https://support.huaweicloud.com/devg-ocsmartcampus/public_sys-resources/note_3.0-zh-cn.png)
低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过[开发编解码插件](https://support.huaweicloud.com/devg-iothub/iot_02_9990.html)实现二进制数据到平台定义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
```
