乐高易车联网网关中间件使用手册
广西乐高易网络有限公司
www.legaoyi.com
修订日期:2024年2月20日
目录
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
1.引用标准
JT/T808-2011《道路运输车辆卫星定位系统终端通信协议及数据格式》
JT/T-808-2013《道路运输车辆卫星定位系统北斗兼容车载终端通信协议技术规范》
JT/T-1078-2016《道路运输车辆卫星定位系统车载视频通信协议》
2.系统架构
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
3.消息定义
3.1 数据交换方式
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
3.2 数据交换队列/主题
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
3.3 数据交换消息类型
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。
3.4 位置信息汇报0x0200
消息概述
(1)消息名称:位置信息汇报
(2)消息Id:0x0200
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:1078协议对808协议的0200消息进行了扩展,其中扩展部分字段见以下描述(原有的808协议字段仍然保持不变)。
消息体定义
字段名
类型
描述
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
videoAlarm
Long
视频相关报警位,按位设置,标志位定义见协议文档表14
cameraLoseAlarm
Long
视频信号丢失报警状态位,按位设置, bitO ~ bit31分别表示第1-32个逻辑通道,相应位为1则表示该逻辑通道发生视颊信号丢失
cameraCoverAlarm
Long
视树信号遮指报警状态,按位设置, bitO ~ bit31分别表示第1-32个逻辑通道,相应位为1则表示该逻辑通道发生视频信号遮挡
ramAlarm
Int
存储器故障报警状态, 按位设置, bitO ~ bit11分别表示第1~12个主存储器, bit12 ~ bitl5分别表示第4个灾备存储装置,相应位为1则表示该存储器发生故障
drivingAlarm
Int
异常驾驶行为报警状态位,
按位设置:0表示无,1表示有
bitO:疲劳
bitl :打电话
bit2 :抽烟
bit3 ~ bit10:保留
bit11 ~ bit15:自定义
fatigueAlarm
Int
疲劳程度,用0-100表示,数值越大表示疲劳程度越严重
消息示例
{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"0200", "messageSeq":323, "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000000" }, "messageBody":{ "":"……808协议0200其他字段)", "videoAlarm":0, "cameraLoseAlarm":36, "cameraCoverAlarm":0, "ramAlarm":0, "drivingAlarm":0, "fatigueAlarm":30 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.5 终端上传音视频属性0x1003
消息概述
(1)消息名称:终端上传音视频属性
(2)消息Id:0x1003
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑终端接收到业务平台下发的“9003”消息后,立即上传该消息应答业务平台。业务平台接收到该消息之后,可根据自身业务进行处理。
消息体定义
字段名
类型
描述
audioCoding
Int
输入音频编码方式,见协议文档表12
inputChlNum
Int
输入音频声道数量
samplingRate
Int
输入音频采样率
0:8 kHz;
1:22.05 kHz;
2:44.1 kHz;
3:48 kHz
samplingNum
Int
输入音频采样位数
0:8位
1:16位
2:32位
frameLen
Int
音频帧长度
output
boolean
是否支持音频输出
0:不支持;
l:支持
videoCoding
Int
视频编码方式,见协议文档表19
maxAudioChlNum
Int
最大音频物理通道数量
maxVideoChlNum
Int
最大视频物理通道数量
消息示例
{ "message":{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"1003", "messageSeq":323, "protocol":"jt808", "protocolVersion":"1078_2011",
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"deviceSn":"013100000000" }, "messageBody":{ "audioCoding":0, "inputChlNum":2, "samplingRate":1, "samplingNum":2, "frameLen":320, "output":true, "videoCoding":28, "maxAudioChlNum":4, "maxVideoChlNum":8 } } }}
3.6 终端上传乘客流量0x1005
消息概述
(1)消息名称:终端上传乘客流量
(2)消息Id:0x1005
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑:车载终端主动上传该消息通知业务平台当前车辆的乘客流量情况。
消息体定义
字段名
类型
描述
startTime
String
起始时间
endTime
String
结束时间
inCar
Int
上车人数
offCar
Int
下车人数
消息示例
{ "message":{ "exchangeId":"36", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "messageId":"1005", "messageSeq":323,
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"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 } } }}
3.7 终端上传音视频资源列表0x1205
消息概述
(1)消息名称:终端上传音视频资源列表
(2)消息Id:0x1205
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑车载终端在接收到9205指令之后,应答该消息把音视频资源记录上传至平台。
消息体定义
字段名
类型
描述
messageSeq
String
应答流水号
resourceList
List
资源列表
channelId
Int
逻辑通道号
startTime
String
起始时间
endTime
String
结束时间
alarm
Long
报警标志位,定义见JT/T808协议表24
videoAlarm
Long
视频报警标志,按位设置,见协议文档表13
resourceType
Int
音视频资源类型
0:音视频
1:音频,
2:视颊
streamType
Int
码流类型
1:主码流
2:子码流
storeType
Int
存储器类型
l:主存储器,
2:灾备存储器
fileSize
Long
文件大小, 单位字节(BYTE)
消息示例
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
{ "exchangeId":"7", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"1205", "messageSeq":7 }, "messageBody":{ "messageSeq":586, "resourceList":[ { "channelId":4, "startTime":"2023-02-09 00:00:00", "endTime":"2023-02-09 00:30:00", "alarm":0, "videoAlarm":0, "resourceType":0, "streamType":0, "storeType":0, "fileSize":2465792 }, { "channelId":4, "startTime":"2023-02-09 00:30:00", "endTime":"2023-02-09 01:00:00", "alarm":0, "videoAlarm":0, "resourceType":0, "streamType":0, "storeType":0, "fileSize":3698688 } ] } }, "createTime":1675989607550}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.8 文件上传完成通知0x1206
消息概述
(1)消息名称:文件上传完成通知
(2)消息Id:0x1206
(3)消息方向:车载终端设备->车联网网关->业务平台
(4)业务逻辑终端在接收到9206指令之后,在文件上传完毕之后向业务平台发送该消息告知平台文件已上传完毕,业务平台接收到该消息后可根据自身的业务需求进行相关的处理。
消息体定义
字段名
类型
描述
messageSeq
Int
消息流水号
result
Int
结果
0:成功
1:失败
消息示例
{ "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}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.9 设置终端参数0x8103
消息概述
(1)消息名称:设置终端参数
(2)消息Id:0x8103
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑平台通过发送设置终端参数消息设置终端音视频相关的参数,终端回复终端通用应答消息。平。
消息体定义
字段名
类型
描述
paramList
Object
参数项列表,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" } } }}
3.10 查询终端音视频属性0x9003
消息概述
(1)消息名称:查询终端音视频属性
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
(2)消息Id:0x9003
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑查询终端音视频属性,平台通过向车载终端设备发送该指令,车载终端应答1003消息上传终端当前音视频属性信息。
消息体定义
字段名
类型
描述
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9003", "messageSeq":7 }, "messageBody":{ } }}
3.11 实时音视频传输请求0x9101
消息概述
(1)消息名称:实时音视频传输请求
(2)消息Id:0x9101
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑实时音视频传输请求,平台通过向车载终端设备发送该指令,车载终端调用摄像头把车内的实时录像上传至业务平台,业务平台进行实时视频监控。
消息体定义
字段名
类型
描述
ip
String
服务器IP地址
tcpPort
int
tcp端口号
udpPort
int
udp端口号
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
channelId
int
逻辑通道号
dataType
int
数据类型
0:音视频,
1:视顿,
2:双向对讲,
3:监听,
4:中心广播,
5:透传
streamType
int
码流类型
0:主码流,
1:子码流
消息示例
{ "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 } }}
3.12 音视频实时传输控制0x9102
消息概述
(1)消息名称:音视频实时传输控制
(2)消息Id:0x9102
(3)消息方向:业务平台->车联网网关->车载终端设备
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
(4)业务逻辑平台通过发送终端控制消息对终端进行实时音视频传输控制,可实现停止上传音视频数据等功能。
消息体定义
字段名
类型
描述
channelId
int
逻辑通道号
dataType
int
数据类型
0:关闭该通道有关的音视频数据;
l:只关闭该通道有关的音频,保留该通道有关的视频;
2:只关闭该通道有关的视频,保留该通道有关的音频
streamType
int
码流类型
将之前申请的码流切换为新申请的码流,音频与切换前保持一致。
新申请的码流为:
0:主码流;
1 :子码流
command
Int
控制指令
平台可以通过该指令对设备的实时音视频进行控制:
0:关闭音视频传输指令;
1:切换码流(增加暂停和继续);
2:暂停该通道所有流的发送;
3;恢复暂停前流的发送,与暂停前的流类型一致;
4:关闭双向对讲
0:关闭该通道有关的音视频数据;
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9102", "messageSeq":7 }, "messageBody":{ "channelId":1, "dataType":1, "streamType":0, "command":1
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
} }}
3.13 实时音视频传输状态通知0x9105
消息概述
(1)消息名称:实时音视频传输状态通知
(2)消息Id:0x9105
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑业务平台向车载终端设备发送该消息告知终端当前平台接收到的实时音视频数据的丢包率等状态。
消息体定义
字段名
类型
描述
channelId
int
逻辑通道号
lossRate
int
丢包率
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9105", "messageSeq":7 }, "messageBody":{ "channelId":1, "lossRate":10 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.14 平台下发远程录像回放请求0x9201
消息概述
(1)消息名称:平台下发远程录像回放请求
(2)消息Id:0x9201
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑平台下发远程录像回放请求,业务平台通过发送该指令给终端要求终端上传指定的音视频文件数据,业务平台进行实时音视频回放。
消息体定义
字段名
类型
描述
ip
String
服务器IP地址
tcpPort
int
tcp端口号,实时音视颊服务器端口号,不使用 TCP传输时置0
udpPort
int
udp端口号,实时音视频服务器端口号,不使用UDP传输时置0
channelId
int
逻辑通道号
dataType
int
数据类型
0:音视频,
1 :音顿,
2:视频,
3:视频或音视频
streamType
int
码流类型
0:主码流或子码流,
1:主码流,
2:子码流;
如果此通道只传输音频,此字段置0
storeType
int
存储器类型
0:主存储器或灾备存储器,
1 :主存储器,
2:灾备存储器
playbackType
int
回放方式
0:正常回放;
l :快进回放;
2:关键帧快退回放;
3:关键帧播放;
4:单帧上传
playTimes
int
快进或快退倍数
回放方式为1和2时,此字段内容有效,否则置0。
0:无效;
1 :1倍;
2 :2倍
3:4倍;
4:8倍;
5: 16倍
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
startTime
String
起始时间,回放方式为4时,该字段表示单帧上传时间
endTime
String
结束时间,为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 } }}
3.15 平台下发远程录像回放控制0x9202
消息概述
(1)消息名称:平台下发远程录像回放控制
(2)消息Id:0x9202
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑平台下发远程录像回放控制,平台在进行远程录像回放时可以发送平台下发远程录像回放控制指令,控制车载终端设备音视频的播放速度/进度等。
消息体定义
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
字段名
类型
描述
channelId
int
逻辑通道号
playbackType
int
回放方式
0:开始回放;
1 :暂停回放;
2:结束回放;
3:快进回放;
4:关键帧快退回放;
5:拖动回放;
6:关键帧播放
playTimes
int
快进或快退倍数
回放控制为3和4时,此字段内容有效,否则置0。
0:无效;
1:1倍;
2:2倍;
3:4倍;
4:8倍;
5:16倍
startTime
String
起始时间,回放控制为5时,此字段有效
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9202", "messageSeq":7 }, "messageBody":{ "channelId":1, "startTime":"2010-11-01 08:00:00", "playbackType":5, "playTimes":1 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.16 查询资源列表0x9205
消息概述
(1)消息名称:查询资源列表
(2)消息Id:0x9205
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑查询资源列表,平台发送该指令给车载终端设备查询指定的音视频资源列表,终端通过应答1205消息上传相关的音视频资源列表。
消息体定义
字段名
类型
描述
channelId
int
逻辑通道号
streamType
int
码流类型
0:所有码流,
1:主码流,
2:子码流
storeType
int
存储器类型
0:所有存储器,
l :主存储器,
2:灾备存储器
alarm
Long
报警标志位,定义见JT/T808协议表24
0表示无报警类型条件
videoAlarm
Long
视频报警标志,按位设置,见协议文档表13
0表示无报警类型条件
resourceType
int
音视频资源类型
0:音视频,
1:音顿,
2:视频,
3:视顿或音视频
startTime
String
起始时间,全0表示无起始时间条件
endTime
String
结束时间,全0表示无结束时间条件
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9205", "messageSeq":7
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
}, "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 } }}
3.17 文件上传指令0x9206
消息概述
(1)消息名称:文件上传指令
(2)消息Id:0x9206
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑文件上传指令,平台通过向车载终端设备发送该消息要求上传指定的音视频文件到指定的ftp服务器。
消息体定义
字段名
类型
描述
ip
String
ftp服务器IP地址
port
int
ftp端口号
userName
String
用户名
password
String
密码
filePath
String
文件路径
channelId
int
逻辑通道号
streamType
int
码流类型
0:所有码流,
1:主码流,
2:子码流
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
storeType
int
存储器类型
0:所有存储器,
l :主存储器,
2:灾备存储器
alarm
Long
报警标志位,定义见JT/T808协议表24
0表示无报警类型条件
videoAlarm
Long
视频报警标志,按位设置,见协议文档表13
0表示无报警类型条件
resourceType
int
音视频资源类型
0:音视频,
1:音顿,
2:视频,
3:视顿或音视频
condition
int
执行条件
用bit位表示:
bitO : WIFI,为1时表示WI-FI下可下载;
bit1 ; LAN,为1时表示LAN连接时可下载;
bit2 :3G/4G,为1时表示3G/4G连接时可下载
startTime
String
起始时间
endTime
String
结束时间
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9206", "messageSeq":7 }, "messageBody":{ "ip":"217.0.0.1", "port":6078, "userName":"test", "password":"123456", "filePath":"/user/local/test/", "channelId":1, "dataType":1, "streamType":0, "storeType":1, "startTime":"2010-11-01 08:00:00", "endTime":"2010-11-01 09:00:00",
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"videoAlarm":0, "alarm":0, "resourceType":1, "condition":7 } }}
3.18 文件上传控制0x9207
消息概述
(1)消息名称:文件上传控制
(2)消息Id:0x9207
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑文件上传控制,平台通过向车载终端设备发送该消息实现对正在上传的音视频文件暂停/取消等操作的控制。
消息体定义
字段名
类型
描述
flag
int
上传控制类型
0:暂停
1:继续
2:取消
messageSeq
int
消息流水号,对应平台文件上传消息的流水
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9207", "messageSeq":7 }, "messageBody":{ "messageSeq":2, "flag":1 } }
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
}
3.19 云台旋转0x9301
消息概述
(1)消息名称:云台旋转
(2)消息Id:0x9301
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑云台旋转,平台通过向车载终端设备发送该消息实现对车载摄像头进行旋转控制以调整摄像头的角度。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
direction
int
方向
0:停止
1:上
2:下
3:左
4:右
speed
int
速度,0-255
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9301", "messageSeq":7 }, "messageBody":{ "channelId":1, "direction":1, "speed":10 } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.20 云台调整焦距控制0x9302
消息概述
(1)消息名称:云台调整焦距控制
(2)消息Id:0x9302
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑云台调整焦距控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小焦距控制。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
direction
int
方向
0:焦距调大
1:焦距调小
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9302", "messageSeq":7 }, "messageBody":{ "channelId":1, "direction":1 } }}
3.21 云台调整光圈控制0x9303
消息概述
(1)消息名称:云台调整光圈控制
(2)消息Id:0x9303
(3)消息方向:业务平台->车联网网关->车载终端设备
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
(4)业务逻辑云台调整光圈控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小光圈控制。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
type
int
光圈调整方式
0:调大
1:调小
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9303", "messageSeq":7 }, "messageBody":{ "channelId":1, "type":1 } }}
3.22 云台雨刷控制0x9304
消息概述
(1)消息名称:云台雨刷控制
(2)消息Id:0x9304
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑云台雨刷控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行雨刷控制。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
flag
int
启停标识
0:停止
1:启动
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9304", "messageSeq":7 }, "messageBody":{ "channelId":1, "flag":1 } }}
3.23 红外补光控制0x9305
消息概述
(1)消息名称:红外补光控制
(2)消息Id:0x9305
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑红外补光控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行红外补光控制。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
flag
int
启停标识
0:停止
1:启动
消息示例
{
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002", "messageId":"9305", "messageSeq":7 }, "messageBody":{ "channelId":1, "flag":1 } }}
3.24 云台变倍控制0x9306
消息概述
(1)消息名称:云台变倍控制
(2)消息Id:0x9306
(3)消息方向:业务平台->车联网网关->车载终端设备
(4)业务逻辑云台变倍控制,平台通过向车载终端设备发送该消息实现对车载摄像头进行放大或者缩小控制。
消息体定义
字段名
类型
描述
channelId
Int
逻辑通道号
type
int
变倍控制
0:调大
1:调小
消息示例
{ "exchangeId":"36", "messageId":"8000", "message":{ "messageHeader":{ "protocol":"jt808", "protocolVersion":"1078_2011", "deviceSn":"013100000002",
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"messageId":"9305", "messageSeq":7 }, "messageBody":{ "channelId":1, "type":1 } }}
3.25 视频鉴权消息0x0102
消息概述
(1)消息名称:视频鉴权
(2)消息Id:0x0102
(3)消息方向:流媒体网关->业务平台
(4)业务逻辑车载设备在连接流媒体网关进行推流时,流媒体网关会模拟一条鉴权消息给业务平台,业务平台根据设备信息校验设备的合法性后,应答“平台应答视频鉴权消息”。
消息体定义
字段名
类型
描述
authCode
String
鉴权码
消息示例
{ "exchangeId":"1073170776284332033", "messageId":"0000", "gatewayId":"elink-iov-message-gateway", "message":{ "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000", "messageId":"0102", "messageSeq":323 }, "messageBody":{ "authCode":"123456" } }
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
}
3.26 平台应答视频鉴权消息
消息概述
(1)消息名称:平台应答视频鉴权消息
(2)消息描述:业务平台向流媒体网关发送终端鉴权应答消息
(3)消息方向:业务平台 ->车联网网关
(4)业务逻辑业务平台接收到流媒体网关的终端鉴权消息(“0102”消息)后,对车载终端设备的信息进行校验之后,需要按照规定格式应答,消息格式见下文。
消息体定义
字段名
类型
描述
result
int
鉴权结果,0是通过鉴权,1鉴权失败
messageHeader
Object
平台通用应答消息头
messageHeader. protocol
String
协议名称,如jt10782016Live
messageHeader. protocolVersion
String
协议版本,如2016
messageHeader. deviceSn
String
设备ID,终端设备唯一标识
消息示例
{ "exchangeId":"1073170776284332033", "messageId":"8102", "gatewayId":"elink-iov-message-gateway", "message":{ "result":0, "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000000" } }}
3.27 视频状态消息0x0002
消息概述
(1)消息名称:视频状态消息
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
(2)消息Id:0x0002
(3)消息方向:流媒体网关->业务平台
(4)业务逻辑终端实时视频或者历史视频推流流媒体网关时,若网关开启了视频录制功能,在终端推流结束时,网关发送消息通知平台录制文件的存储路径。
消息体定义
字段名
类型
描述
channelId
int
通道id
eventCode
int
事件项编码
9:平台录制
mediaDataId
String
多媒体数据id
mediaFormatCode
int
多媒体格式编码
9: flv
mediaType
int
多媒体类型
1:音频
2:视频
filePath
String
录制文件存放路径(网关所在服务器路径)
消息示例
{ "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}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
3.28 视频录制完成通知0x1801
消息概述
(1)消息名称:视频录制完成通知
(2)消息Id:0x1801
(3)消息方向:流媒体网关->业务平台
(4)业务逻辑终端实时视频或者历史视频推流流媒体网关时,若网关开启了视频录制功能,在终端推流结束时,网关发送消息通知平台录制文件的存储路径。
消息体定义
字段名
类型
描述
channelId
int
通道id
eventCode
int
事件项编码
9:平台录制
mediaDataId
String
多媒体数据id
mediaFormatCode
int
多媒体格式编码
9: flv
mediaType
int
多媒体类型
1:音频
2:视频
filePath
String
录制文件存放路径(网关所在服务器路径)
消息示例
{ "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" } },
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
"createTime":1540915278102}
3.29 JT809平台拉流鉴权信息下发
消息概述
(1)消息名称 JT809平台拉流鉴权信息下发
(2)消息Id无(注消息的最外层的“messageId”固定为“8009”,消息示例红色加粗部"messageId":"8009"
(3)消息方向:业务平台->流媒体网关
(4)业务逻辑:流媒体网关需要支持JT809平台拉流时,业务平台在接收到设备推流上线消息时,需要把JT809平台拉流鉴权信息下发给网关。
消息体定义
字段名
类型
描述
deviceSn
String
逻辑通道号
plateColor
int
车牌颜色
plateNumber
String
车牌号
authorizeCode
String
时效口令
消息示例
{ "exchangeId":"36", "messageId":"8009", "message":{ "messageHeader":{ "protocol":"jt10782016Live", "protocolVersion":"2016", "deviceSn":"013100000002" }, "messageBody":{ "deviceSn":"013100000002", "plateColor":1, "plateNumber":"车牌号", "authorizeCode":"时效口令" } }}
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
4.二次开发
4.1 音视频直播
音视频直播目前支持基于JT/T1078协议的音视频直播功能,具体业务流程如下图:
1业务平台在开始音视频直播前,首先需要明确知道车载设备支持几路摄像头,具体是哪几个通道,摄像头安装时最好是统一按通道顺序安装以方便平台观看视频;
2在发送启动视频直播指令之前,首先检查设备是否在线,并按照文档定义的9101消息”格式封装业务数据,调用平台接口发布给消息网关中间件;
3消息网关中间件接收到“9101消息”经过编码之后,下发给车载设备;
4车载设备接收到指令后,启动音视频直播,开始推流至指定的流媒体网关中间件,同时应该消息网关中间件成功开启音视频直播;
5开启播放器拉流指定的音视频流URl进行播放音视频;
6对于同一车载设备同一路视频,若是存在多个客户端同时观看的情况,流媒体网关中间件支持共享直播流,支持流复用,业务平台不必重复下发音视频直播指令;
7在音视频直播过程中,可能由于网络信号等原因,音视频直播出现不稳定或者卡顿是时常发生的,业务平台需根据具体情况判断是否需要重新发送开启音视频指令,因为有些车载设备在与平台之间的连接断开之后即使网络信号恢复了,也不会重新连接推流;
8业务平台在不需要观看音视频直播时,需要发送指令给车载设备,通知其停止音视频直播,此处需要注意多客户端同时观看音视频的情况以及浏览器异常关闭等情况,后台需
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
对此类情况做处理决定是否需要自动发送停止音视频直播指令,否则会有可能导致车载设备不停止直播一直推流的情况。
4.2 音视频回放
对于基于JT/T1078协议的音视频回放功能,其流程基本同音视频直播流程一致,其业务处理流程如下图:
音视频回放与音视频直播不同点主要有:
1在开始音视频回放之前,首先需要发送9205消息”查看当前车载设备的历史音视频资源列表,然后根据车载设备返回资源列表,下发9201消息”开始回放指定的音视频资源;
2对于音视频回放,是以独占通道的方式进行的,也就是说,对于同一车载设备同一音视频通道,同一时刻只能有一个人观看,不支持多人同时回放不同的音视频。
乐高易软件 乐高易车联网网关中间件 技术支持:78772895QQ
4.3 对讲流程
对于基于JT/T1078协议的对讲功能,其业务流程在音视频直播流程的基础上多了一个平台音频推流至车载设备的流程,其业务流程如下图:
1对于车载设备的声音推流平台部分,其业务流程是与直播一样的;
2业务平台在推流声音到车载设备时,需要等待车载设备先连接流媒体网关之后,才能进行推流。
4.4 其他
参考《乐高易车联网网关中间件使用手册(JT808-2013)》文档对应章节。