乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 1.引用标准JT/T808-2011《道路运输车辆卫星定位系统终端通信协议及数据格式》
JT/T-808-2013《道路运输车辆卫星定位系统北斗兼容车载终端通信协议技术规范》
JT/T-1078-2016《道路运输车辆卫星定位系统车载视频通信协议》
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
(1)消息名称:位置信息汇报
(2)消息Id:0x0200
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:1078协议对808协议的0200消息进行了扩展,其中扩展部分字段见以下描述(原有的808协议字段仍然保持不变)。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.5 终端上传音视频属性0x1003(1)消息名称:终端上传音视频属性
(2)消息Id:0x1003
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:终端接收到业务平台下发的“9003”消息后,立即上传该消息应答业务平台。业务平台接收到该消息之后,可根据自身业务进行处理。
输入音频采样率
0:8 kHz;
1:22.05 kHz;
2:44.1 kHz;
3:48 kHz
{ "message":{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"1003", "messageSeq":323, "protocol":"jt808", "protocolVersion":"1078_2011",
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "deviceSn":"013100000000" }, "messageBody":{ "audioCoding":0, "inputChlNum":2, "samplingRate":1, "samplingNum":2, "frameLen":320, "output":true, "videoCoding":28, "maxAudioChlNum":4, "maxVideoChlNum":8 } } }}
(1)消息名称:终端上传乘客流量
(2)消息Id:0x1005
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:车载终端主动上传该消息通知业务平台当前车辆的乘客流量情况。
{ "message":{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"1005", "messageSeq":323,
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000000" }, "messageBody":{ "startTime":"2010-11-01 8:00:00", "endTime":"2010-11-01 9:00:00", "inCar":20, "offCar":10 } } }}
(1)消息名称:终端上传音视频资源列表
(2)消息Id:0x1205
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:车载终端在接收到9205指令之后,应答该消息把音视频资源记录上传至平台。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.8 文件上传完成通知0x1206(1)消息名称:文件上传完成通知
(2)消息Id:0x1206
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:终端在接收到9206指令之后,在文件上传完毕之后向业务平台发送该消息告知平台文件已上传完毕,业务平台接收到该消息后可根据自身的业务需求进行相关的处理。
{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"1206", "messageSeq":7 }, "messageBody":{ "result":1, "messageSeq":0 } }, "createTime":1540915278102, "dataLength":80}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.9 设置终端参数0x8103(1)消息名称:设置终端参数
(2)消息Id:0x8103
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:平台通过发送设置终端参数消息设置终端音视频相关的参数,终端回复终端通用应答消息。平。
参数项列表,key/val键值对,key对应参数id,参考协议表中的定义,如0001;val为要设置的终端参数的值,DWORD,WORD,BYTE类型的参数值要转成十六进制值。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"8103", "messageSeq":7 }, "messageBody":{ "paramList":{ "0029":"5" } } }}
(1)消息名称:查询终端音视频属性
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (2)消息Id:0x9003(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:查询终端音视频属性,平台通过向车载终端设备发送该指令,车载终端应答1003消息上传终端当前音视频属性信息。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9003", "messageSeq":7 }, "messageBody":{ } }}
消息概述
(1)消息名称:实时音视频传输请求
(2)消息Id:0x9101
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:实时音视频传输请求,平台通过向车载终端设备发送该指令,车载终端调用摄像头把车内的实时录像上传至业务平台,业务平台进行实时视频监控。
消息体定义
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 数据类型
0:音视频,
1:视顿,
2:双向对讲,
3:监听,
4:中心广播,
5:透传
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9101", "messageSeq":7 }, "messageBody":{ "ip":"217.0.0.1", "tcpPort":6078, "udpPort":0, "channelId":1, "dataType":1, "streamType":0 } }}
(1)消息名称:音视频实时传输控制
(2)消息Id:0x9102
(3)消息方向:业务平台->车联网网关->车载终端设备
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (1)消息名称:实时音视频传输状态通知
(2)消息Id:0x9105
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:业务平台向车载终端设备发送该消息告知终端当前平台接收到的实时音视频数据的丢包率等状态。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9105", "messageSeq":7 }, "messageBody":{ "channelId":1, "lossRate":10 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.14 平台下发远程录像回放请求0x9201(1)消息名称:平台下发远程录像回放请求
(2)消息Id:0x9201
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:平台下发远程录像回放请求,业务平台通过发送该指令给终端要求终端上传指定的音视频文件数据,业务平台进行实时音视频回放。
tcp端口号,实时音视颊服务器端口号,不使用 TCP传输时置0
udp端口号,实时音视频服务器端口号,不使用UDP传输时置0
数据类型
0:音视频,
1 :音顿,
2:视频,
3:视频或音视频
码流类型
0:主码流或子码流,
1:主码流,
2:子码流;
如果此通道只传输音频,此字段置0
存储器类型
0:主存储器或灾备存储器,
1 :主存储器,
2:灾备存储器
回放方式
0:正常回放;
l :快进回放;
2:关键帧快退回放;
3:关键帧播放;
4:单帧上传
快进或快退倍数
回放方式为1和2时,此字段内容有效,否则置0。
0:无效;
1 :1倍;
2 :2倍
3:4倍;
4:8倍;
5: 16倍
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 结束时间,为0表示一直回放,回放方式为4时,该字段无效
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9201", "messageSeq":7 }, "messageBody":{ "ip":"217.0.0.1", "tcpPort":6078, "udpPort":0, "channelId":1, "dataType":1, "streamType":0, "storeType":1, "startTime":"2010-11-01 08:00:00", "endTime":"2010-11-01 09:00:00", "playbackType":1, "playTimes":1 } }}
(1)消息名称:平台下发远程录像回放控制
(2)消息Id:0x9202
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:平台下发远程录像回放控制,平台在进行远程录像回放时可以发送平台下发远程录像回放控制指令,控制车载终端设备音视频的播放速度/进度等。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.16 查询资源列表0x9205(1)消息名称:查询资源列表
(2)消息Id:0x9205
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:查询资源列表,平台发送该指令给车载终端设备查询指定的音视频资源列表,终端通过应答1205消息上传相关的音视频资源列表。
存储器类型
0:所有存储器,
l :主存储器,
2:灾备存储器
报警标志位,定义见JT/T808协议表24
0表示无报警类型条件
视频报警标志,按位设置,见协议文档表13
0表示无报警类型条件
音视频资源类型
0:音视频,
1:音顿,
2:视频,
3:视顿或音视频
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9205", "messageSeq":7
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) }, "messageBody":{ "channelId":1, "ip":"217.0.0.1", "port":6078, "userName":"test", "password":"123456", "filePath":"/user/local/test/", "dataType":1, "streamType":0, "storeType":1, "startTime":"2010-11-01 08:00:00", "endTime":"2010-11-01 09:00:00", "videoAlarm":0, "alarm":0, "resourceType":1 } }}
(1)消息名称:文件上传指令
(2)消息Id:0x9206
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:文件上传指令,平台通过向车载终端设备发送该消息要求上传指定的音视频文件到指定的ftp服务器。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "videoAlarm":0, "alarm":0, "resourceType":1, "condition":7 } }}
(1)消息名称:文件上传控制
(2)消息Id:0x9207
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:文件上传控制,平台通过向车载终端设备发送该消息实现对正在上传的音视频文件暂停/取消等操作的控制。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9207", "messageSeq":7 }, "messageBody":{ "messageSeq":2, "flag":1 } }
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (1)消息名称:云台旋转
(2)消息Id:0x9301
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:云台旋转,平台通过向车载终端设备发送该消息实现对车载摄像头进行旋转控制以调整摄像头的角度。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9301", "messageSeq":7 }, "messageBody":{ "channelId":1, "direction":1, "speed":10 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.20 云台调整焦距控制0x9302(1)消息名称:云台调整焦距控制
(2)消息Id:0x9302
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:云台调整焦距控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小焦距控制。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9302", "messageSeq":7 }, "messageBody":{ "channelId":1, "direction":1 } }}
(1)消息名称:云台调整光圈控制
(2)消息Id:0x9303
(3)消息方向:业务平台->车联网网关->车载终端设备
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (4)业务逻辑:云台调整光圈控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小光圈控制。{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9303", "messageSeq":7 }, "messageBody":{ "channelId":1, "type":1 } }}
(1)消息名称:云台雨刷控制
(2)消息Id:0x9304
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:云台雨刷控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行雨刷控制。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) { "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9304", "messageSeq":7 }, "messageBody":{ "channelId":1, "flag":1 } }}
(1)消息名称:红外补光控制
(2)消息Id:0x9305
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:红外补光控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行红外补光控制。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9305", "messageSeq":7 }, "messageBody":{ "channelId":1, "flag":1 } }}
(1)消息名称:云台变倍控制
(2)消息Id:0x9306
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑:云台变倍控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小控制。
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002",
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "messageId":"9305", "messageSeq":7 }, "messageBody":{ "channelId":1, "type":1 } }}
(1)消息名称:视频鉴权
(2)消息Id:0x0102
(3)消息方向:流媒体网关->业务平台
(4)业务逻辑:车载设备在连接流媒体网关进行推流时,流媒体网关会模拟一条鉴权消息给业务平台,业务平台根据设备信息校验设备的合法性后,应答“平台应答视频鉴权消息”。
{ "exchangeId":"1073170776284332033", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000", "messageId":"0102", "messageSeq":323 }, "messageBody":{ "authCode":"123456" } }
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (1)消息名称:平台应答视频鉴权消息
(2)消息描述:业务平台向流媒体网关发送终端鉴权应答消息
(3)消息方向:业务平台 ->车联网网关
(4)业务逻辑:业务平台接收到流媒体网关的终端鉴权消息(“0102”消息)后,对车载终端设备的信息进行校验之后,需要按照规定格式应答,消息格式见下文。
messageHeader. protocolVersion
{ "exchangeId":"1073170776284332033", "messageId":"8102", "gatewayId":"elink-iov-message-gateway", "message":{ "result":0, "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000" } }}
消息概述
(1)消息名称:视频状态消息
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) (2)消息Id:0x0002(3)消息方向:流媒体网关->业务平台
(4)业务逻辑:终端实时视频或者历史视频推流流媒体网关时,若网关开启了视频录制功能,在终端推流结束时,网关发送消息通知平台录制文件的存储路径。
消息体定义
消息示例
{ "message":{ "messageHeader":{ "messageId":"0801", "messageSeq":323, "protocol":" jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000" }, "messageBody":{
"mdiaDataId":1, "mediaType":2, "mediaFormatCode":9, "eventCode":9, "channelId":2 "filePath":"/usr/local/data/test.flv" } }, "createTime":1540915278102}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 3.28 视频录制完成通知0x1801(1)消息名称:视频录制完成通知
(2)消息Id:0x1801
(3)消息方向:流媒体网关->业务平台
(4)业务逻辑:终端实时视频或者历史视频推流流媒体网关时,若网关开启了视频录制功能,在终端推流结束时,网关发送消息通知平台录制文件的存储路径。
{ "message":{ "messageHeader":{ "messageId":"0801", "messageSeq":323, "protocol":" jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000" }, "messageBody":{
"mdiaDataId":1, "mediaType":2, "mediaFormatCode":9, "eventCode":9, "channelId":2 "filePath":"/usr/local/data/test.flv" } },
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) "createTime":1540915278102}
消息概述
(1)消息名称: JT809平台拉流鉴权信息下发
(2)消息Id:无(注:消息的最外层的“messageId”固定为“8009”,消息示例红色加粗部分"messageId":"8009")
(3)消息方向:业务平台->流媒体网关
(4)业务逻辑:流媒体网关需要支持JT809平台拉流时,业务平台在接收到设备推流上线消息时,需要把JT809平台拉流鉴权信息下发给网关。
消息体定义
消息示例
{ "exchangeId":"36", "messageId":"8009", "message":{ "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000002" }, "messageBody":{ "deviceSn":"013100000002", "plateColor":1, "plateNumber":"车牌号", "authorizeCode":"时效口令" } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 4.二次开发 音视频直播目前支持基于JT/T1078协议的音视频直播功能,具体业务流程如下图:
1、业务平台在开始音视频直播前,首先需要明确知道车载设备支持几路摄像头,具体是哪几个通道,摄像头安装时最好是统一按通道顺序安装以方便平台观看视频;
2、在发送启动视频直播指令之前,首先检查设备是否在线,并按照文档定义的“9101消息”格式封装业务数据,调用平台接口发布给消息网关中间件;
3、消息网关中间件接收到“9101消息”经过编码之后,下发给车载设备;
4、车载设备接收到指令后,启动音视频直播,开始推流至指定的流媒体网关中间件,同时应该消息网关中间件成功开启音视频直播;
5、业务平台定时调用平台接口检查下发指令的状态,直至车载设备应答直播开启成功后,开启播放器拉流指定的音视频流URl进行播放音视频;
6、对于同一车载设备同一路视频,若是存在多个客户端同时观看的情况,流媒体网关中间件支持共享直播流,支持流复用,业务平台不必重复下发音视频直播指令;
7、在音视频直播过程中,可能由于网络信号等原因,音视频直播出现不稳定或者卡顿是时常发生的,业务平台需根据具体情况判断是否需要重新发送开启音视频指令,因为有些车载设备在与平台之间的连接断开之后即使网络信号恢复了,也不会重新连接推流;
8、业务平台在不需要观看音视频直播时,需要发送指令给车载设备,通知其停止音视频直播,此处需要注意多客户端同时观看音视频的情况以及浏览器异常关闭等情况,后台需
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 对此类情况做处理决定是否需要自动发送停止音视频直播指令,否则会有可能导致车载设备不停止直播一直推流的情况。
对于基于JT/T1078协议的音视频回放功能,其流程基本同音视频直播流程一致,其业务处理流程如下图:
音视频回放与音视频直播不同点主要有:
1、在开始音视频回放之前,首先需要发送“9205消息”查看当前车载设备的历史音视频资源列表,然后根据车载设备返回资源列表,下发“9201消息”开始回放指定的音视频资源;
2、对于音视频回放,是以独占通道的方式进行的,也就是说,对于同一车载设备同一音视频通道,同一时刻只能有一个人观看,不支持多人同时回放不同的音视频。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895(QQ) 4.3 对讲流程 对于基于JT/T1078协议的对讲功能,其业务流程在音视频直播流程的基础上多了一个平台音频推流至车载设备的流程,其业务流程如下图:
1、对于车载设备的声音推流平台部分,其业务流程是与直播一样的;
2、业务平台在推流声音到车载设备时,需要等待车载设备先连接流媒体网关之后,才能进行推流。
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。