下发指令队列
默认队列名称 : term-cmd
消息发送者 : 流媒体服务
当需要向终端下发媒体相关指令时(如请求实时音视频),流媒体服务构造 TermCmd 消息对象,向该队列推送。企业应用在收到这个消息后,应通过企业终端网关向终端下发相应的指令。
当终端应答时,企业应用应构造 CmdStateChange 消息对象,推送到指令状态变更通知队列。
指令集
流媒体服务只下发以下指令:
| 指令所属协议 | 指令消息号 | 指令名称 | 必要 |
|---|---|---|---|
| JT/T 1078 | 9101 | 音视频传输请求 (指令参数) | 必要 |
| JT/T 1078 | 9102 | 音视频实时传输控制 (指令参数) | 必要 |
| JT/T 1078 | 9201 | 远程录像回放请求 (指令参数) | 必要 |
| JT/T 1078 | 9202 | 远程录像回放控制 (指令参数) | 必要 |
| JT/T 1078 | 9205 | 查询资源列表 (指令参数) | 可选 1 |
| JT/T 1078 | 9206 | 录像文件上传指令 (指令参数) | 可选 1 |
| JT/T 1078 | 9207 | 录像文件上传控制 (指令参数) | 可选 1 |
| T/GDRTA, T/SCSDX, T/JSATL等 | 9208 | 报警附件上传指令 (指令参数) | 可选 2 |
注2:如不需要流媒体服务内置的报警附件接收功能,可不实现这些指令的响应
如果企业应用不支持某个指令,忽略该指令消息即可。
消息结构 (JSON)
| 属性 | 数据类型 | 必要 | 说明 |
|---|---|---|---|
| id | string | Y | 指令记录ID |
| appId | string | 应用ID,不指定或指定为空字符串时表默认应用 | |
| reqId | string | 指令关联的媒体请求ID | |
| msgId | string | Y | JT/T 808,JT/T 1078 指令消息号,如位置信息查询指令为:8201 |
| subCmdTyp | string | 子命令类型。如终端控制的大类型是8105,子命令类型是它的命令字。又如下发终端升级包,大类型是8108,子命令是它的升级类型 | |
| plate | string | 车牌号 | |
| plateColor | int | JT/T 808标准定义的车牌颜色代码 | |
| msgSn | int | 服务端下发的消息流水号 | |
| simNo | string | Y | 终端识别号 |
| params | object | 参数,以 JSON 对象表示。参考 终端指令参数、应答通知 。部分指令无参数 | |
| ackParams | object | 应答的数据,以Json对象表示。不同的指令的应答的结构不同,参考 终端指令参数、应答通知 中应答部分。部分指令无应答数据。 注:此属性只出现在查询返回结果中,下发指令时不使用此属性。 | |
| timeout | int | 超时时长,单位:秒。不指定时或指定为0时,指令将在5秒后超时。小于2的非0值无效 |