添加消息批量下发任务

如果您需要同时向多个设备发送自定义Topic消息，可使用设备平台的消息批量下发任务。本文介绍该任务的创建方法、运行中Topic及其数据格式的说明，查看状态的具体操作。

任务管理流程

1、在具备权限的前提下，登录云鲸AIoT开发者平台。

2、点击 设备管理 > 批量任务，然后点击 创建任务。

3、在创建任务页面，根据页面提示，配置任务和作业，单击完成。

1）任务配置

参数	说明
任务名称	输入符合规则的任务名称。
任务类型	选择类型：批量向自定义Topic发送消息
Topic	输入自定义Topic，其中ProductID和DeviceID无需填写
Payload	输入要下发给设备的任意内容

2）作业配置

参数	说明
选择产品、目标设备	选择产品和目标设备，可以通过文件上传批量选择；也可以通过选择器进行筛选
调度方式	单次调度：任务有且仅下发一次循环调度：任务可设置循环次数和每次循环间隔时间
每分钟执行数量	根据您的业务需要，设置每分钟作业推送数量。最小50，最大1000；
开始调度时间	可选配置。从当前设置操作的时间，开始计算时间。设备任务创建成功后，先初始化，直至到达调度时间，才会开始调度执行。
循环次数	循环调度时可选。任务最大可循环的次数，任务内选中的设备根据顺序执行完成后会再次执行的次数。
循环间隔时间	每次循环结束后距离下次循环开始的间隔时间；若未填写，则默认循环结束后立即开始。

4、任务创建完成后，设备平台通过 MQTT Broker 向多个设备发送消息，但设备不会向设备平台返回响应结果，因此只要成功发布到MQTT Broker 即判断为成功。

自定义消息Topic为/${productKey}/${deviceName}/${TopicShortName}，数据格式根据任务配置内填写内容自定义。

5、在设备平台对应实例下的 设备管理 > 批量任务 页面，查看已创建任务及当前状态。您可根据实际场景需要，执行以下操作：

状态	说明
待调度	当前作业还在排队中，未到达调度时间。
执行中	该设备任务接口已调用，等待结果返回。
已超时	该设备任务接口调用超时。
失败	该设备任务接口调用结果已返回，但异常导致失败。
成功	该设备任务接口调用成功。注意：接口调用成功，不代表接口本身的业务执行成功。例如：批量下发mqtt消息的成功仅代表成功发送至mqtt broker，不代表成功发送消息至设备
已撤销	该设备任务还在排队中，但过程中任务被撤销。

创建时间：2023-10-19 10:58
最后编辑：陈勇琦更新时间：2024-10-18 16:29