DB3311T 32视频监控卡口数据传输技术规范.docx
《DB3311T 32视频监控卡口数据传输技术规范.docx》由会员分享，可在线阅读，更多相关《DB3311T 32视频监控卡口数据传输技术规范.docx（33页珍藏版）》请在冰豆网上搜索。
DB3311T32视频监控卡口数据传输技术规范
DB3311
浙江省丽水市地方标准
DB3311/T32—2019
代替DB3311/T32—2014
视频监控卡口数据传输技术规范
2019-12-26发布2020-01-26实施
丽水市市场监督管理局发布
目次
前言II
1范围1
2规范性引用文件1
3基本要求1
4通信方式1
5消息组成2
5.1消息结构2
5.2消息头2
6协议流程2
7接口协议3
7.1前端认证（平台→设备）3
7.2前端认证V2（设备→平台）4
7.3心跳保活信号（设备→平台）5
7.4发送卡口记录（设备→平台）5
7.5发送卡口记录V2（设备→平台）6
附录A（规范性附录）代码表规范10
前言
本标准按照GB/T1.1—2009给出的规则起草。
本标准与DB3311/T32—2014相比主要技术变化如下：
——修改标准名称《治安视频监控卡口数据传输技术规范》为《视频监控卡口数据传输技术规范》；
——“7.5发送卡口记录（设备→平台）”增加发送电警卡口记录接口相关内容；
——“4通信方式”、“5.2消息类型”、“6协议流程”、“7.2前端认证V2（设备→平台）”增加前端主动注册接口相关内容。
本标准由丽水市公安局提出并归口。
本标准所代替标准的历次版本发布情况为DB3311/T32—2014《治安视频监控卡口数据传输技术规范》，本次修订为第一次修订。
视频监控卡口数据传输技术规范
1范围
本标准规定了视频卡口前端与平台之间的通信方式、消息组成、协议流程和接口协议等技术要求。
本标准适用于视频监控卡口系统的方案设计、系统检测、验收以及与之相关的程序研发。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。
凡是注日期的引用文件，仅所注日期的版本适用于本文件。
凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
UTF-8信息交换用UTF8编码字符集
3基本要求
3.1数据编号
文档中所用的数据编号（在设备上的数据编号采用8字节UINT64），表示每个前端从1开始计数一直累加。
前端保存的数据编号应不会因为停电或重启后产生重复。
3.2传输规则
协议应使用网络字节序传输数据。
字符串数据应使用UTF-8格式编码，传输中的字符串存储格式为C语言格式，以“\0”结尾。
传输中的图片数据应使用JPEG格式。
传输中的视频数据应使用MP4格式。
设备应支持数据重传机制。
3.3数据类型
协议中使用的数据类型见表1。
表1数据类型
数据类型
描述及要求
time_t
8字节，表示从1970年1月1日0时到指定时间所经历的秒数（格林威治时间）。
如无特殊说明，文档中所用的时间都是time_t类型。
UINT32
无符号整型，4字节。
UINT64
无符号整型，8字节。
Float
浮点型，4字节。
String
字符串
4通信方式
前端与平台间的通讯应采用TCP协议。
当前端作为TCPServer时，默认侦听端口为41022。
当平台作为TCPServer时，应支持注册重定向，默认侦听端口为42022，主要适用于前端无固定IP应用场景。
前端与平台连接成功之后，卡口记录、心跳保活等数据应由前端主动发送平台。
前端发送短视频数据应与卡口记录关联匹配。
5消息组成
5.1消息结构
平台发往前端的消息以及前端返回平台的回应采用统一格式，如表2所示。
表2消息结构
消息头
整体数据字节数
消息体
UINT32
UINT32
数据长度可变
注：
整体数据字节数为消息总的长度（按字节记），包括消息头、整体数据字节数和消息体
5.2消息头
消息头的内容应采用规范表述，如表3所示。
表3消息头内容类型
消息标识
说明
数据流方向
是否需要回复
0xefff0001
前端验证
平台→前端
是
0xefff0002
前端向平台反馈包
前端→平台
否
0xefff0004
卡口记录V1
前端→平台
是
0xefff0005
接收数据反馈包
平台→前端
否
0xefff0007
心跳信号
前端→平台
否
0xefff0008
卡口记录V2
前端→平台
是
0x3fff000a
前端验证V2
前端→平台
是
0x3fff000b
平台向前端反馈包
平台→前端
否
6协议流程
前端与平台之间的协议交互流程如图1所示。
前端
平台
身份认证
认证结果
身份认证
认证结果
心跳保活
上传卡口记录
确认结果
图1协议交互流程
7接口协议
7.1前端认证（平台→设备）
平台连接前端时，应携带用户名和验证码进行身份认证。
认证包格式见表4，反馈包格式见表5。
身份认证不成功，应返回认证失败消息且断开连接不提供服务。
认证码由前端进行管理，前端应可以配置。
表4认证包格式
平台向前端发出验证包
消息头：
验证0xefff0001
整体数据长度：
96字节消息体：
数据内容
1
Char[44]
用户名
2
Char[44]
认证码
表5反馈包格式
前端向平台反馈包
消息头：
认证状态0xefff0002
整体数据长度：
12字节消息体：
数据内容
1
UINT32
0：
认证成功、1：
用户名错误、2：
认证码错误
7.2前端认证V2（设备→平台）
前端连接平台时，应携带通道编号和验证码进行身份认证。
认证包格式见表6，反馈包格式见表7。
身份认证不成功，应返回认证失败消息且断开连接不提供服务。
认证码由平台进行管理，平台应可以配置。
表6认证包格式
前端向平台发送验证包
消息头：
验证0xefff000a
整体数据长度：
8+结构化信息长度+结构化信息消息体：
描述
名称
类型
备注
结构化信息长度
结构化信息长度
Integer
说明后面的结构化信息JSON的长度
结构化信息
结构化信息
String
JSON封装的结构化信息
结构化信息JSON如下，编码格式采用UTF-8。
{
"DeviceID":
"通道编号",
"Password":
"认证码"
}
表7反馈包格式
平台向前端反馈包
消息头：
认证状态0xefff000b
整体数据长度：
8+结构化信息长度+结构化信息消息体：
描述
名称
类型
备注
结构化信息长度
结构化信息长度
Integer
说明后面的结构化信息JSON的长度
结构化信息
结构化信息
String
JSON封装的结构化信息
结构化信息JSON如下，编码格式采用UTF-8。
{
"Result":
0,//0：
认证成功；1：
用户名错误；2：
认证码错误；3：
重定向
"RedirectAddress":
"10.33.214.126:
42022"
}
7.3心跳保活信号（设备→平台）
前端在通讯空闲时，应每5秒钟向平台发送一次心跳保活信号，心跳包格式见表8。
如果平台在11秒钟内未收到前端发送的任何信息，应该断开连接，并重新建立连接。
平台收到前端发送的心跳保活信号后，不应回复消息。
表8心跳包格式
消息头：
心跳头
0xefff0007
7.4发送卡口记录（设备→平台）
前端向平台发送卡口识别数据包见表10。
平台向前端发送接收数据反馈包格式见表9。
表9接受数据反馈包
平台向前端反馈接收数据反馈包
消息头：
接收数据成功0xefff0005整体数据长度：
64字节
消息体：
数据内容
1
UINT64
数据编号（在设备上的数据编号）
2
UINT32
回复接收数据状态：
0入库成功
1解析第一步失败
2解析第二步失败
3入库失败
3
Char[44]
通道编号
表10识别数据包格式
前端向平台发送卡口识别数据包
消息头：
卡口识别数据头0xefff0004
整体数据长度：
8+关于全景图的信息长度+图片数据长度+n*识别数据长度消息体：
关于全景图的信息
1
UINT64
图片编号，填默认值填0
2
UINT32
图片字节数
3
UINT32
关于图片的识别数据个数n条
4
UINT32
图片宽度
5
UINT2
图片高度
6
Char[48]
通道编号
7
Char[48]
图片存储路径，填默认值”\0”
图片数据
1
Char[]
保存的实际图片
总数n条识别数据
1
UINT64
数据编号，填默认值0
2
UINT64
在设备上的数据编号8字节
3
time_t
过卡口时间8字节
4
UINT64
关联的图片信息编号，填默认0
5
UINT32
过卡口时间毫秒
6
float
车辆速度单位公里
7
UINT32
车道号
8
float
识别精度
9
UINT3
方向代码（见附录A.2）
10
UINT32
车牌类型（见附录A.1）
11
UINT32
车牌颜色（见附录A.3）
12
UINT32
车辆类型（见附录A.7）
13
UINT32
车辆logo（见附录A.6）
14
UNT32
车辆颜色（见附录A.5）
15
UINT32
车牌结构（见附录A.4）
16
UINT32
在全景图中的特征图坐标x1如无填99999999
17
UINT32
在全景图中的特征图坐标y1如无填99999999
18
UINT32
在全景图中的特征图坐标x2如无填99999999
19
UINT32
在全景图中的特征图坐标y2如无填99999999
20
Char[20]
车牌号（“00000000”表示未识别出、行人或非机动车，“11111111”表示无牌车）
7.5发送卡口记录V2（设备→平台）
前端向平台发送卡口识别数据包格式见表11。
平台向前端反馈接收数据反馈包格式见表13。
表11识别数据包格式
消息头：
卡口识别数据头
0xefff0008
描述
名称
类型
备注
结构化信息长度
结构化信息长度
Integer
说明后面的结构化信息JSON的长度
结构化信息
结构化信息
String
JSON封装的结构化信息，见表12
图像数据
总共N个图像
UINT32
图个数。
图像1大小
UINT32
图像数据的数据长度由图像大小确定。
图像1数据
Char[]
保存的实际图片
图像2大小
UINT32
图像2数据
Char[]
保存的实际图片
„
图像N大小
UINT32
图像N数据
Char[]
保存的实际图片
结构化信息JSON如下，编码格式采用UTF-8。
{
"SeqID":
"在设备上的数据编号","VehicleInfo":
{
"RecordID":
"记录唯一ID","DeviceID":
"通道编号",
"PlateNo":
"车牌号码","VehicleType":
"车辆类型","VehicleColor":
"车辆颜色","VehicleBrand":
"车辆品牌","VehicleModel":
"车辆型号","VehicleStyles":
"车辆年款","PlateType":
"车牌种类","PlateColor":
"车牌颜色",
"PlateStructure":
车牌结构,"LaneNo":
"车道号",
"Speed":
"车速",
"MaxSpeed":
"速度上限",
"MinSpeed":
"速度下限",
"Direction":
"行驶方向",
"VioCode":
"违法代码",
"PassTime":
"抓拍时间",
"ImageList":
[{
"ImageInfo"{//图像信息
"ImageNo":
图像序号,
"ImageType":
图像类型,
"ImageWidth":
图像宽度,
"ImageHeight":
图像高度
}
"VehicleCoordinate":
[{//车牌坐标信息
"X1":
车牌坐标X1,
"Y1":
车牌坐标Y1,
"X2":
车牌坐标X2,
"Y2":
车牌坐标Y2
}],
"FaceCoordinate":
[{//人脸坐标信息，依次主驾驶人脸、副驾驶人脸
"X1":
人脸坐标X1,
"Y1":
人脸坐标Y1,
"X2":
人脸坐标X2,
"Y2":
人脸坐标Y2
}],
}],
}
表12结构化信息
名称
字段名
类型
备注
数据编号
SeqID
String
在设备上的数据编号，唯一编号。
RecordID
记录ID
String
编码规则：
通道ID+时间（YYYYMMDDHHMMSS）+流水号
设备编号
DeviceID
String
通道编号。
车牌号码
PlateNo
String
车牌号（“00000000”表示未识别出、行人或非机动车，“11111111”表示无牌车）
车牌类型
PlateType
Integer
见附录A.1
方向代码
Direction
String
见附录A.2
车牌颜色
PlateColor
Integer
见附录A.3
车牌结构
PlateStructure
Integer
见附录A.4
车辆颜色
VehicleColor
Integer
见附录A.5
车辆品牌
VehicleBrand
Integer
见附录A.6
车辆类型*
VehicleType
Intege
见附录A.7
车辆型号
VehicleModel
String
品牌下的型号，如奥迪A4L，中文描述。
车辆年款
VehicleStyles
String
车型下的年份信息，汽车行业惯例，中文描述。
车道号
LaneNo
Integer
车辆行驶方向最左车道为1，由左向右顺序编号。
车速
Speed
Integer
每小时公里数。
速度上限
MaxSpeed
Integer
每小时公里数。
速度下限
MinSpeed
Integer
每小时公里数。
违法代码
VioCode
String
5位代码，编码规则按公安的相关规定，整个系统中违法代码统一，同时在前端可自定义配置违法代码
表12结构化信息（续）
名称
字段名
类型
备注
抓拍时间
PassTime
timestamp
精度为毫秒（YYYYMMDDHHMMSSMMM）
时间按24小时制。
第一组MM表示月，第二组MM表示分，第三组MMM表示毫秒。
图像序号
ImageNo
Integer
图像类型
ImageType
Integer
见附录A.8
图像宽度
ImageWidth
Integer
图像高度
ImageHeight
Integer
表13接受数据反馈包
消息头：
接收数据成功
0xefff0005
数据内容
1
UINT64
数据编号
2
UINT32
回复接收数据状态：
0入库成功
1解析第一步失败
2解析第二步失败
3入库失败
3
Char[44]
通道编号
附录A（规范性附录）代码表规范
A.1车牌类型代码
车牌类型代码见表A.1。
表A.1车牌类型代码
代码
代码名
备注
1
大型汽车号牌
黄底黑字（含02式号牌部分）
2
小型汽车号牌
蓝底白字（含02式号牌部分）
3
使馆汽车号牌
黑底白字、红“使”字
4
领馆汽车号牌
黑底白字、红“领”字
5
境外汽车号牌
黑底白／红字
6
外籍汽车号牌
黑底白字
7
两、三轮摩托车号牌
黄底黑字
8
轻便摩托车号牌
蓝底白字
9
使馆摩托车号牌
黑底白字、红“使”字
10
领馆摩托车号牌
黑底白字、红“领”字
11
境外摩托车号牌
黑底白字
12
外籍摩托车号牌
黑底白字
13
农用运输车号牌
黄底黑字黑框线，已按《道路交通安全法》取消农用运输车，不再发放
14
拖拉机号牌
黄底黑字
15
挂车号牌
黄底黑字黑框线
16
教练汽车号牌
黄底黑字黑框线
17
教练摩托车号牌
黄底黑字黑框线
18
试验汽车号牌
19
试验摩托车号牌
20
临时入境汽车号牌
白底红字黑“临时入境”
21
临时入境摩托车号牌
白底红字黑“临时入境”
22
临时行驶车号牌
白底黑字黑框线
23
警用汽车号牌
24
警用摩托车号牌
25
原农机号牌
26
香港入出境车
27
澳门入出境车
31
武警号牌
32
军队号牌
33
应急号牌
代码
代码名
备注
41
无号牌
42
假号牌
43
挪用号牌
51
大型新能源汽车号牌
黄绿底黑字，黑框线
52
小型新能源汽车号牌
渐变绿底黑字，黑框线
97
非机动车
用于自定义电动车号牌等
99
其他号牌
A.2方向代码
方向代码见表A.2。
表A.2方向代码
代码
代码名
备注
1
由东向西
NULL
2
由西向东
NULL
3
由南向北
NULL
4
由北向南
NULL
5
由北东向西南
NULL
6
由东南向西北
NULL
7
由西南向东北
NULL
8
由西北向东南
NULL
99
其它方向
NULL
A.3车牌颜色代码
车牌颜色代码见表A.3。
表A.3车牌颜色代码
代码
代码名
备注
1
蓝色
NULL
2
黑色
NULL
3
黄色
NULL
4
白色
NULL
5
绿色
NULL
6
渐变白绿色
新能源小型汽车
7
渐变黄绿色
新能源大型汽车
99
其他颜色
NULL
A.4车牌结构代码
车牌结构代码见表A.4。
表A.4车牌结构代码
代码
代码名
备注
1
单行
2
双行
99
其它
A.5车辆颜色代码
车牌颜色代码见表A.5。
表A.5车辆颜色代码
代码
代码名
备注
1
白色
NULL
2
银色
NULL
3
黑色
NULL
4
红色
NULL
5
紫色
NULL
6
蓝色
NULL
7
黄色
NULL
8
绿色
NULL
9
褐色
NULL
10
粉红色
NULL
11
灰色
NULL
12
混合色
NULL
99
其它颜色
NULL
A.6车标代码
车标代码见表A.6。
表A.6车标代码
代码
代码名
备注
1
奥迪
NULL
2
宝马
NULL
3
现代
NULL
4
奔驰
NULL
5
本田
NULL
代码
代码名
备注
6
大众
NULL
7
马自达
NULL
8
丰田
NULL
9
别克
NULL
10
雪弗兰
NULL
11
雪铁龙
NULL
12
标志
NULL
13
福特
NULL
14
凌志
NULL
15
尼桑
NULL
16
奇瑞
NULL
17
比亚迪
NULL
18
起亚
NULL
19
荣威
NULL
20
三菱
NULL
21
斯柯达
NULL
22
铃木
NULL
23
昌河
NULL
24
菲亚特
NULL
25
沃尔沃
NULL
26
吉普
NULL
27
路虎
NULL
28
通用
NULL
29
红旗
NULL
30
悍马
NULL
31
金杯
NULL
32
江淮
NULL
33
江铃
NULL
34
吉利
NULL
35
陆风
NULL
36
力帆
NULL
37
名爵
NULL
38
讴歌
NULL
39
英菲尼迪
NULL
40
中华
NULL
41
众泰
NULL
42
威麟
NULL
43
斯巴鲁
NULL
44
世爵
NULL
代码
代码名
备注
45
双环
NULL
46
萨博
NULL
47
威兹曼
NULL
48
全球鹰
NULL
49
吉奥
NULL
50
华泰
NULL
51
华普
NULL
52
哈飞
NULL
53
东南
NULL
54
帝豪
NULL
55
长安
NULL
56
长丰
NULL
57
长城
NULL
58
大宇
NULL
59
五十铃
NULL
60
大发
NULL
61
捷豹
NULL
62
欧宝
NULL
63
克莱斯勒
NULL
64
阿尔法-罗密欧
NULL
65
林肯
NULL
66
劳斯莱斯
NULL
67
法拉利
NULL
68
保时捷
NULL
69
莲花
NULL
70
阿斯顿马丁
NULL
71
皇冠
NULL
72
奔腾
NULL
73
东风
NULL
74
中顺
NULL
75
长安福田
NULL
76
五菱
NULL
77
凯迪拉克
NULL
78
玛莎拉蒂M3
NULL
79
富士
NULL
80
野马
NULL
81
玛莎拉蒂
NULL
82
雷诺
NULL
83
依维柯
NULL
84
道奇
NULL
代码
代码名
备注
85
普利茅斯
NULL
86
俊朗
NULL
87
极品
NULL
88
水星
NULL
89
土星
NULL
90
蓝旗亚
NULL
91
西亚特
NULL
92
双龙
NULL
93
本特利
NULL
94
绅宝
升级会员 