DB3311∕T 32─2019 视频监控卡口数据传输技术规范(丽水市).pdf

视频监控卡口数据传输技术规范ICS 13.310 A 91 DB3311 浙江省丽水市地方标准 2019 -12 - 26 发布 2020 - 01 - 26 实施 丽 水 市 市 场 监督 管 理 局 发 布 DB3311/T 322019 代替 DB3311/T 322014 DB3311/T 322019 I 目 次 前 言 . 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 DB3311/ T 322019 II 前 言 本标准按照GB/T 1.12009给出的规则起草。 本标准与DB3311/T 322014相比主要技术变化如下： 修改标准名称 治安视频监控卡口数据传输技术规范 为 视频监控卡口数据传输技术规范 ； “7.5 发送卡口记录(设备平台)”增加发送电警卡口记录接口相关内容； “4 通信方式”、 “5.2 消息类型”、 “6 协议流程”、 “7.2 前端认证 V2(设备平台)” 增加前端主动注册接口相关内容。 本标准由丽水市公安局提出并归口。 本标准起草单位：丽水市公安局科技信息化局。 本标准起草人：赵日新、诸葛智翔、魏剑新、林智龙、徐经纬、孔维生、吕泓涛。 本标准所代替标准的历次版本发布情况为DB3311/T 322014治安视频监控卡口数据传输技术规范，本次修订为第一次修订。DB3311/T 322019 1 视频监控卡口数据传输技术规范 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 通信方式 DB3311/ T 322019 2 前端与平台间的通讯应采用TCP协议。当前端作为TCP Server时，默认侦听端口为41022。当平台作为TCP Server时，应支持注册重定向，默认侦听端口为42022，主要适用于前端无固定IP应用场景。前端与平台连接成功之后，卡口记录、心跳保活等数据应由前端主动发送平台。前端发送短视频数据应与卡口记录关联匹配。 5 消息组成 5.1 消息结构 平台发往前端的消息以及前端返回平台的回应采用统一格式，如表2所示。 表2 消息结构 消息头消息头 整体数据字节数整体数据字节数 消息体消息体 UINT32 UINT32 数据长度可变 注：整体数据字节数为消息总的长度（按字节记），包括消息头、整体数据字节数和消息体 5.2 消息头 消息头的内容应采用规范表述，如表3所示。 表3 消息头内容类型 消息标识消息标识 说明说明 数据流方向数据流方向 是否需要回复是否需要回复 0 xefff0001 前端验证 平台前端 是 0 xefff0002 前端向平台反馈包 前端平台 否 0 xefff0004 卡口记录V1 前端平台 是 0 xefff0005 接收数据反馈包 平台前端 否 0 xefff0007 心跳信号 前端平台 否 0 xefff0008 卡口记录V2 前端平台 是 0 x3fff000a 前端验证V2 前端平台 是 0 x3fff000b 平台向前端反馈包 平台前端 否 6 协议流程 前端与平台之间的协议交互流程如图1所示。 DB3311/T 322019 3 前端前端平台平台身份认证认证结果心跳保活上传卡口记录确认结果身份认证认证结果 图1 协议交互流程 7 接口协议 7.1 前端认证（平台设备） 平台连接前端时，应携带用户名和验证码进行身份认证。认证包格式见表4，反馈包格式见表5。身份认证不成功，应返回认证失败消息且断开连接不提供服务。 认证码由前端进行管理，前端应可以配置。 表4 认证包格式 平台平台向向前端前端发出验证包发出验证包 消息头：消息头： 验证 0 xefff0001 整体数据长度：整体数据长度：96字节 消息体：消息体： 数据内容 1 Char44 用户名 2 Char44 认证码 DB3311/ T 322019 4 表5 反馈包格式 前端前端向向平台平台反馈包反馈包 消息头：消息头： 认证状态 0 xefff0002 整体数据长度：整体数据长度：12字节 消息体：消息体： 数据内容 1 UINT32 0：认证成功、1：用户名错误、2：认证码错误 7.2 前端认证 V2（设备平台） 前端连接平台时，应携带通道编号和验证码进行身份认证。认证包格式见表6，反馈包格式见表7。身份认证不成功，应返回认证失败消息且断开连接不提供服务。 认证码由平台进行管理，平台应可以配置。 表6 认证包格式 前端向平台发送验证包前端向平台发送验证包 消息头：消息头： 验证 0 xefff000a 整体数据长度：整体数据长度：8+结构化信息长度+结构化信息 消息体：消息体： 描述描述 名称名称 类型类型 备注备注 结构化信息长度 结构化信息长度 Integer 说明后面的结构化信息 JSON 的长度 结构化信息 结构化信息 String JSON 封装的结构化信息 结构化信息JSON如下，编码格式采用UTF-8。 DeviceID: 通道编号, Password: 认证码 表7 反馈包格式 平台向前端反馈包平台向前端反馈包 消息头：消息头： 认证状态 0 xefff000b 整体数据长度：整体数据长度：8+结构化信息长度+结构化信息 消息体：消息体： 描述描述 名称名称 类型类型 备注备注 结构化信息长度 结构化信息长度 Integer 说明后面的结构化信息JSON的长度 结构化信息 结构化信息 String JSON封装的结构化信息 结构化信息JSON如下，编码格式采用UTF-8。 Result: 0, /0：认证成功；1：用户名错误；2：认证码错误；3：重定向 RedirectAddress: 10.33.214.126:42022 DB3311/T 322019 5 7.3 心跳保活信号（设备平台） 前端在通讯空闲时，应每5秒钟向平台发送一次心跳保活信号，心跳包格式见表8。 如果平台在11秒钟内未收到前端发送的任何信息，应该断开连接，并重新建立连接。平台收到前端发送的心跳保活信号后，不应回复消息。 表8 心跳包格式 前端前端向向平台平台发送心跳包发送心跳包 消息头：消息头： 心跳头 0 xefff0007 整体数据长度：整体数据长度：8字节 7.4 发送卡口记录（设备平台） 前端向平台发送卡口识别数据包见表10。平台向前端发送接收数据反馈包格式见表9。 表9 接受数据反馈包 平台向前端反馈接收数据反馈包 消息头：消息头： 接收数据成功 0 xefff0005 整体数据长度：整体数据长度：64字节 消息体：消息体： 数据内容 1 UINT64 数据编号(在设备上的数据编号) 2 UINT32 回复接收数据状态： 0入库成功 1解析第一步失败 2解析第二步失败 3入库失败 3 Char44 通道编号 DB3311/ T 322019 6 表10 识别数据包格式 前端向平台发送卡口识别数据包 消息头：消息头： 卡口识别数据头 0 xefff0004 整体数据长度：整体数据长度：8+关于全景图的信息长度+图片数据长度+n*识别数据长度 消息体消息体： 关于全景图的信息 1 UINT64 图片编号，填默认值填0 2 UINT32 图片字节数 3 UINT32 关于图片的识别数据个数n条 4 UINT32 图片宽度 5 UINT?2 图片高度 6 Char48 通道编号 7 Char48 图片存储路径，填默认值”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 U?NT32 车辆颜色 (见附录A.5) 15 UINT32 车牌结构 (见附录A.4) 16 UINT32 在全景图中的特征图坐标x1如无填99999999 17 UINT32 在全景图中的特征图坐标y1如无填99999999 18 UINT32 在全景图中的特征图坐标x2如无填99999999 19 UINT32 在全景图中的特征图坐标y2如无填99999999 20 Char20 车牌号（“00000000”表示未识别出、行人或非机动车，“11111111”表示无牌车） 7.5 发送卡口记录 V2（设备平台） 前端向平台发送卡口识别数据包格式见表11。平台向前端反馈接收数据反馈包格式见表13。 DB3311/T 322019 7 表11 识别数据包格式 前端向平台发送卡口识别数据包 消息头：消息头： 卡口识别数据头 0 xefff0008 整体数据长度：整体数据长度：8+结构化信息长度+结构化信息+图像数据 消息体：消息体： 描述描述 名称名称 类型类型 备注备注 结构化信息长度 结构化信息长度 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/图像信息 DB3311/ T 322019 8 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 位代码，编码规则按公安的相关规定，整个系统中违法代码统一，同时在前端可自定义配置违法代码 DB3311/T 322019 9 表 12 结构化信息（续） 名称名称 字字段名段名 类型类型 备注备注 抓拍时间 PassTime timestamp 精度为毫秒（YYYYMMDDHHMMSSMMM） 时间按 24 小时制。第一组 MM 表示月，第二组 MM 表示分，第三组 MMM表示毫秒。 图像序号 ImageNo Integer 图像类型 ImageType Integer 见附录 A.8 图像宽度 ImageWidth Integer 图像高度 ImageHeight Integer 表13 接受数据反馈包 平台向前端反馈接收数据反馈包 消息头：消息头： 接收数据成功 0 xefff0005 整体数据长度：64字节 消息体：消息体： 数据内容 1 UINT64 数据编号 2 UINT32 回复接收数据状态： 0入库成功 1解析第一步失败 2解析第二步失败 3入库失败 3 Char44 通道编号 DB3311/ T 322019 10 附录 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 应急号牌 DB3311/T 322019 11 表 A.1 车牌类型代码（续） 代码代码 代码名代码名 备注备注 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 DB3311/ T 322019 12 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 DB3311/T 322019 13 表 A.6 车标代码（续） 代码代码 代码名代码名 备注备注 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 DB3311/ T 322019 14 表 A.6 车标代码（续） 代码代码 代码名代码名 备注备注 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 DB3311/T 322019 15 表 A.6 车标代码（续） 代码代码 代码名代码名 备注备注 85 普利茅斯 NULL 86 俊朗 NULL 87 极品 NULL 88 水星 NULL 89 土星 NULL 90 蓝旗亚 NULL 91 西亚特 NULL 92 双龙 NULL 93 本特利 NULL 94 绅宝 NULL 95 庞蒂克 NULL 96 奥士莫比 NULL 97 兰博基尼 NULL 98 奥斯汀 NULL 99 陕汽重卡 NULL 100 北奔重卡 NULL 101 宇通客车 NULL 102 羊城汽车 NULL 103 福迪汽车 NULL 104 广汽 NULL 105 华德 NULL 106 楚风 NULL 107 春兰 NULL 108 大运 NULL 109 东风柳州 NULL 110 佛山飞驰 NULL 111 日野 NULL 112 红岩 NULL 113 华菱 NULL 114 金旅 NULL 115 联合 NULL 116 曼 NULL 117 青年 NULL 118 日产 NULL 119 神野 NULL 120 十通 NULL 121 斯堪尼亚 NULL 122 五征 NULL 123 徐工 NULL DB3311/ T 322019 16 表 A.6 车标代码（续） 代码代码 代码名代码名 备注备注 124 中通 NULL 125 王牌 NULL 126 宝骏 NULL 127 理念 NULL 128 宾利 NULL 129 启辰 NULL 130 传祺 NULL 131 迷你 NULL 132 哈佛 NULL 133 纳智捷 NULL 134 斯玛特 NULL 135 汇众 NULL 136 一汽 NULL 137 开瑞 NULL 138 南汽 NULL 139 跃进 NULL 140 解放 NULL 141 金龙 NULL 142 罗福 NULL 143 中兴 NULL 144 瑞麒 NULL 145 曙光 NULL 146 迈巴赫 NULL 147 布加迪 NULL 148 中国罗浮 NULL 149 时代 NULL 150 吉利英伦 NULL 151 瑞沃 NULL 152 海格 NULL 153 英国TVR NULL 154 永源UFO NULL 155 申龙 NULL 156 雷克萨斯 NULL 157 南京 NULL 158 精灵 NULL 159 凯马 NULL 160 亚星客车 NULL 161 三一 NULL 162 南骏 NULL DB3311/T 322019 17 表 A.6 车标代码（续） 代码代码 代码名代码名 备注备注 163 安凯客车 NULL 164 牡丹花都 NULL 165 蜀都公交 NULL 166 唐骏 NULL 167 轻骑微卡 NULL 168 黄海客车 NULL 169 川汽野马 NULL 170 新凯 NULL 171 时风 NULL 172 三环 NULL 173 百路佳 NULL 174 北方客车 NULL 175 上海申通 NULL 176 北汽 NULL 177 海马郑州 NULL 178 中国重汽 NULL 179 舒驰客车 NULL 180 九龙 NULL 181 江南 NULL 182 北京 NULL 9999 其它车标 其它车标 A.7 车辆类型代码 车辆类型代码见表A.7。 表A.7 车辆类型代码(识别类型代码) 代码代码 代码名代码名 备注备注 1000 小车 小车车型 1001 小型客车 小型客车 1002 小型货车 小型货车 2000 中车 中车车型 2001 中型客车 中型客车 2002 中型货车 中型货车 3000 大车 大车车型 3001 大型客车 大型客车 3002 大型货车 大型货车 9000 其它 其它车型 9001 两轮车 两轮车 DB3311/ T 322019 18 表 A.7 车辆类型代码(识别类型代码) （续） 代码代码 代码名代码名 备注备注 9002 三轮车 三轮车 9003 行人 行人 A.8 图像类型代码 图像类型代码见表A.8。 表A.8 图像类型代码 代码代码 代码名代码名 备注备注 0 原始图 NULL 1 合成图 NULL 2 车牌抠图 NULL 3 主驾驶员图 NULL 4 辅驾驶员图 NULL 5 缩略图 NULL 6 车辆抠图 NULL 7 车辆底盘图 NULL 10 身份证人脸图 NULL 11 抓拍人脸图 NULL 12 抓拍人体（人员）图 NULL 20 物品（比如箱包）抠图 NULL 99 其他 NULL