視頻監(jiān)控卡口數(shù)據(jù)傳輸技術規(guī)范

DB3311/T32—2019

視頻監(jiān)控卡口數(shù)據(jù)傳輸技術規(guī)范

1范圍

本標準規(guī)定了視頻卡口前端與平臺之間的通信方式、消息組成、協(xié)議流程和接口協(xié)議等技術要求。

本標準適用于視頻監(jiān)控卡口系統(tǒng)的方案設計、系統(tǒng)檢測、驗收以及與之相關的程序研發(fā)。

2規(guī)范性引用文件

下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

UTF-8信息交換用UTF8編碼字符集

3基本要求

3.1數(shù)據(jù)編號

文檔中所用的數(shù)據(jù)編號（在設備上的數(shù)據(jù)編號采用8字節(jié)UINT64），表示每個前端從1開始計數(shù)一直

累加。前端保存的數(shù)據(jù)編號應不會因為停電或重啟后產(chǎn)生重復。

3.2傳輸規(guī)則

協(xié)議應使用網(wǎng)絡字節(jié)序傳輸數(shù)據(jù)。字符串數(shù)據(jù)應使用UTF-8格式編碼，傳輸中的字符串存儲格式為C

語言格式，以“\0”結尾。傳輸中的圖片數(shù)據(jù)應使用JPEG格式。傳輸中的視頻數(shù)據(jù)應使用MP4格式。設

備應支持數(shù)據(jù)重傳機制。

3.3數(shù)據(jù)類型

協(xié)議中使用的數(shù)據(jù)類型見表1。

表1數(shù)據(jù)類型

數(shù)據(jù)類型描述及要求

8字節(jié)，表示從1970年1月1日0時到指定時間所經(jīng)歷的秒數(shù)（格林威治時間）。如

time_t

無特殊說明，文檔中所用的時間都是time_t類型。

UINT32無符號整型，4字節(jié)。

UINT64無符號整型，8字節(jié)。

Float浮點型，4字節(jié)。

String字符串

4通信方式

1

DB3311/T32—2019

前端與平臺間的通訊應采用TCP協(xié)議。當前端作為TCPServer時，默認偵聽端口為41022。當平臺作

為TCPServer時，應支持注冊重定向，默認偵聽端口為42022，主要適用于前端無固定IP應用場景。前

端與平臺連接成功之后，卡口記錄、心跳保活等數(shù)據(jù)應由前端主動發(fā)送平臺。前端發(fā)送短視頻數(shù)據(jù)應與

卡口記錄關聯(lián)匹配。

5消息組成

5.1消息結構

平臺發(fā)往前端的消息以及前端返回平臺的回應采用統(tǒng)一格式，如表2所示。

表2消息結構

消息頭整體數(shù)據(jù)字節(jié)數(shù)消息體

UINT32UINT32數(shù)據(jù)長度可變

注：整體數(shù)據(jù)字節(jié)數(shù)為消息總的長度（按字節(jié)記），包括消息頭、整體數(shù)據(jù)字節(jié)數(shù)和消息體

5.2消息頭

消息頭的內容應采用規(guī)范表述，如表3所示。

表3消息頭內容類型

消息標識說明數(shù)據(jù)流方向是否需要回復

0xefff0001前端驗證平臺→前端是

0xefff0002前端向平臺反饋包前端→平臺否

0xefff0004卡口記錄V1前端→平臺是

0xefff0005接收數(shù)據(jù)反饋包平臺→前端否

0xefff0007心跳信號前端→平臺否

0xefff0008卡口記錄V2前端→平臺是

0x3fff000a前端驗證V2前端→平臺是

0x3fff000b平臺向前端反饋包平臺→前端否

6協(xié)議流程

前端與平臺之間的協(xié)議交互流程如圖1所示。

2

DB3311/T32—2019

身份認證

認證結果

身份認證

認證結果

前前平平

端端臺臺

心跳保活

上傳卡口記錄

確認結果

圖1協(xié)議交互流程

7接口協(xié)議

7.1前端認證（平臺→設備）

平臺連接前端時，應攜帶用戶名和驗證碼進行身份認證。認證包格式見表4，反饋包格式見表5。身

份認證不成功，應返回認證失敗消息且斷開連接不提供服務。

認證碼由前端進行管理，前端應可以配置。

表4認證包格式

平臺向前端發(fā)出驗證包

消息頭：

驗證0xefff0001

整體數(shù)據(jù)長度：96字節(jié)

消息體：

1Char[44]用戶名

數(shù)據(jù)內容

2Char[44]認證碼

3

DB3311/T32—2019

表5反饋包格式

前端向平臺反饋包

消息頭：

認證狀態(tài)0xefff0002

整體數(shù)據(jù)長度：12字節(jié)

消息體：

數(shù)據(jù)內容1UINT320：認證成功、1：用戶名錯誤、2：認證碼錯誤

7.2前端認證V2（設備→平臺）

前端連接平臺時，應攜帶通道編號和驗證碼進行身份認證。認證包格式見表6，反饋包格式見表7。

身份認證不成功，應返回認證失敗消息且斷開連接不提供服務。

認證碼由平臺進行管理，平臺應可以配置。

表6認證包格式

前端向平臺發(fā)送驗證包

消息頭：

驗證0xefff000a

整體數(shù)據(jù)長度：8+結構化信息長度+結構化信息

消息體：

描述名稱類型備注

結構化信息長度結構化信息長度Integer說明后面的結構化信息JSON的長度

結構化信息結構化信息StringJSON封裝的結構化信息

結構化信息JSON如下，編碼格式采用UTF-8。

{

"DeviceID":"通道編號",

"Password":"認證碼"

}

表7反饋包格式

平臺向前端反饋包

消息頭：

認證狀態(tài)0xefff000b

整體數(shù)據(jù)長度：8+結構化信息長度+結構化信息

消息體：

描述名稱類型備注

結構化信息長度結構化信息長度Integer說明后面的結構化信息JSON的長度

結構化信息結構化信息StringJSON封裝的結構化信息

結構化信息JSON如下，編碼格式采用UTF-8。

{

"Result":0,//0：認證成功；1：用戶名錯誤；2：認證碼錯誤；3：重定向

"RedirectAddress":"10.33.214.126:42022"

4

DB3311/T32—2019

}

7.3心跳?；钚盘枺ㄔO備→平臺）

前端在通訊空閑時，應每5秒鐘向平臺發(fā)送一次心跳?；钚盘?，心跳包格式見表8。

如果平臺在11秒鐘內未收到前端發(fā)送的任何信息，應該斷開連接，并重新建立連接。平臺收到前端

發(fā)送的心跳?；钚盘柡?，不應回復消息。

表8心跳包格式

前端向平臺發(fā)送心跳包

消息頭：

心跳頭0xefff0007

整體數(shù)據(jù)長度：8字節(jié)

7.4發(fā)送卡口記錄（設備→平臺）

前端向平臺發(fā)送卡口識別數(shù)據(jù)包見表10。平臺向前端發(fā)送接收數(shù)據(jù)反饋包格式見表9。

表9接受數(shù)據(jù)反饋包

平臺向前端反饋接收數(shù)據(jù)反饋包

消息頭：

接收數(shù)據(jù)成功0xefff0005

整體數(shù)據(jù)長度：64字節(jié)

消息體：

1UINT64數(shù)據(jù)編號(在設備上的數(shù)據(jù)編號)

回復接收數(shù)據(jù)狀態(tài)：

0入庫成功

數(shù)據(jù)內容2UINT321解析第一步失敗

2解析第二步失敗

3入庫失敗

3Char[44]通道編號

5

DB3311/T32—2019

表10識別數(shù)據(jù)包格式

前端向平臺發(fā)送卡口識別數(shù)據(jù)包

消息頭：

卡口識別數(shù)據(jù)頭0xefff0004

整體數(shù)據(jù)長度：8+關于全景圖的信息長度+圖片數(shù)據(jù)長度+n*識別數(shù)據(jù)長度

消息體：

1UINT64圖片編號，填默認值填0

2UINT32圖片字節(jié)數(shù)

3UINT32關于圖片的識別數(shù)據(jù)個數(shù)n條

關于全景圖的

4UINT32圖片寬度

信息

5UINT

2圖片高度

6Char[48]通道編號

7Char[48]圖片存儲路徑，填默認值”\0”

圖片數(shù)據(jù)1Char[]保存的實際圖片

1UINT64數(shù)據(jù)編號，填默認值0

2UINT64在設備上的數(shù)據(jù)編號8字節(jié)

3time_t過卡口時間8字節(jié)

4UINT64關聯(lián)的圖片信息編號，填默認

0

5UINT32過卡口時間毫秒

6float車輛速度單位公里

7UINT32車道號

8float識別精度

9UINT3

方向代碼(見附錄A.2)

10UINT32車牌類型(見附錄A.1)

總數(shù)n條識別

11UINT32車牌顏色(見附錄A.3)

數(shù)據(jù)

12UINT32車輛類型(見附錄A.7)

13UINT32車輛logo(見附錄A.6)

14U

NT32車輛顏色(見附錄A.5)

15UINT32車牌結構(見附錄A.4)

16UINT32在全景圖中的特征圖坐標x1如無填99999999

17UINT32在全景圖中的特征圖坐標y1如無填99999999

18UINT32在全景圖中的特征圖坐標x2如無填99999999

19UINT32在全景圖中的特征圖坐標y2如無填99999999

車牌號（“00000000”表示未識別出、行人或非機動車，

20Char[20]

“11111111”表示無牌車）

7.5發(fā)送卡口記錄V2（設備→平臺）

前端向平臺發(fā)送卡口識別數(shù)據(jù)包格式見表11。平臺向前端反饋接收數(shù)據(jù)反饋包格式見表13。

6

DB3311/T32—2019

表11識別數(shù)據(jù)包格式

前端向平臺發(fā)送卡口識別數(shù)據(jù)包

消息頭：

卡口識別數(shù)據(jù)頭0xefff0008

整體數(shù)據(jù)長度：8+結構化信息長度+結構化信息+圖像數(shù)據(jù)

消息體：

描述名稱類型備注

結構化信息長度結構化信息長度Integer說明后面的結構化信息JSON的長度

結構化信息結構化信息StringJSON封裝的結構化信息，見表12

總共N個圖像UINT32圖

個數(shù)。

圖像1大小UINT32圖像數(shù)據(jù)的數(shù)據(jù)長度由圖像大小確定。

圖像1數(shù)據(jù)Char[]保存的實際圖片

圖像2大小UINT32

圖像數(shù)據(jù)

圖像2數(shù)據(jù)Char[]保存的實際圖片

?

圖像N大小UINT32

圖像N數(shù)據(jù)Char[]保存的實際圖片

結構化信息JSON如下，編碼格式采用UTF-8。

{

"SeqID":"在設備上的數(shù)據(jù)編號",

"VehicleInfo":{

"RecordID":"記錄唯一ID",

"DeviceID":"通道編號",

"PlateNo":"車牌號碼",

"VehicleType":"車輛類型",

"VehicleColor":"車輛顏色",

"VehicleBrand":"車輛品牌",

"VehicleModel":"車輛型號",

"VehicleStyles":"車輛年款",

"PlateType":"車牌種類",

"PlateColor":"車牌顏色",

"PlateStructure":車牌結構,

"LaneNo":"車道號",

"Speed":"車速",

"MaxSpeed":"速度上限",

"MinSpeed":"速度下限",

"Direction":"行駛方向",

"VioCode":"違法代碼",

"PassTime":"抓拍時間",

"ImageList":[{

"ImageInfo"{//圖像信息

7

DB3311/T32—2019

"ImageNo":圖像序號,

"ImageType":圖像類型,

"ImageWidth":圖像寬度,

"ImageHeight":圖像高度

}

"VehicleCoordinate":[{//車牌坐標信息

"X1":車牌坐標X1,

"Y1":車牌坐標Y1,

"X2":車牌坐標X2,

"Y2":車牌坐標Y2

}],

"FaceCoordinate":[{//人臉坐標信息，依次主駕駛人臉、副駕駛人臉

"X1":人臉坐標X1,

"Y1":人臉坐標Y1,

"X2":人臉坐標X2,

"Y2":人臉坐標Y2

}],

}],

}

表12結構化信息

名稱字段名類型備注

數(shù)據(jù)編號SeqIDString在設備上的數(shù)據(jù)編號，唯一編號。

RecordID記錄IDString編碼規(guī)則：通道ID+時間（YYYYMMDDHHMMSS）+流水號

設備編號DeviceIDString通道編號。

車牌號（“00000000”表示未識別出、行人或非機動車，“11111111”

車牌號碼PlateNoString

表示無牌車）

車牌類型PlateTypeInteger見附錄A.1

方向代碼DirectionString見附錄A.2

車牌顏色PlateColorInteger見附錄A.3

車牌結構PlateStructureInteger見附錄A.4

車輛顏色VehicleColorInteger見附錄A.5

車輛品牌VehicleBrandInteger見附錄A.6

車輛類型*VehicleTypeIntege見附錄A.7

車輛型號VehicleModelString品牌下的型號，如奧迪A4L，中文描述。

車輛年款VehicleStylesString車型下的年份信息，汽車行業(yè)慣例，中文描述。

車道號LaneNoInteger車輛行駛方向最左車道為1，由左向右順序編號。

車速SpeedInteger每小時公里數(shù)。

速度上限MaxSpeedInteger每小時公里數(shù)。

速度下限MinSpeedInteger每小時公里數(shù)。

5位代碼，編碼規(guī)則按公安的相關規(guī)定，整個系統(tǒng)中違法代碼統(tǒng)一，

違法代碼VioCodeString

同時在前端可自定義配置違法代碼

8

DB3311/T32—2019

表12結構化信息（續(xù)）

名稱字段名類型備注

精度為毫秒（YYYYMMDDHHMMSSMMM）

抓拍時間PassTimetimestamp時間按24小時制。第一組MM表示月，第二組MM表示分，第三組MMM

表示毫秒。

圖像序號ImageNoInteger

圖像類型ImageTypeInteger見附錄A.8

圖像寬度ImageWidthInteger

圖像高度ImageHeightInteger

表13接受數(shù)據(jù)反饋包

平臺向前端反饋接收數(shù)據(jù)反饋包

消息頭：

接收數(shù)據(jù)成功0xefff0005

整體數(shù)據(jù)長度：64字節(jié)

消息體：

1UINT64數(shù)據(jù)編號

回復接收數(shù)據(jù)狀態(tài)：

0入庫成功

數(shù)據(jù)內容2UINT321解析第一步失敗

2解析第二步失敗

3入庫失敗

3Char[44]通道編號

9

DB3311/T32—2019

附錄A（規(guī)范性附錄）

代碼表規(guī)范

A.1車牌類型代碼

車牌類型代碼見表A.1。

表A.1車牌類型代碼

代碼代碼名備注

1大型汽車號牌黃底黑字（含02式號牌部分）

2小型汽車號牌藍底白字（含02式號牌部分）

3使館汽車號牌黑底白字、紅“使”字

4領館汽車號牌黑底白字、紅“領”字

5境外汽車號牌黑底白／紅字

6外籍汽車號牌黑底白字

7兩、三輪摩托車號牌黃底黑字

8輕便摩托車號牌藍底白字

9使館摩托車號牌黑底白字、紅“使”字

10領館摩托車號牌黑底白字、紅“領”字

11境外摩托車號牌黑底白字

12外籍摩托車號牌黑底白字

黃底黑字黑框線，已按《道路交通安全法》取消農(nóng)用

13農(nóng)用運輸車號牌

運輸車，不再發(fā)放

14拖拉機號牌黃底黑字

15掛車號牌黃底黑字黑框線

16教練汽車號牌黃底黑字黑框線

17教練摩托車號牌黃底黑字黑框線

18試驗汽車號牌

19試驗摩托車號牌

20臨時入境汽車號牌白底紅字黑“臨時入境”

21臨時入境摩托車號牌白底紅字黑“臨時入境”

22臨時行駛車號牌白底黑字黑框線

23警用汽車號牌

24警用摩托車號牌

25原農(nóng)機號牌

26香港入出境車

27澳門入出境車

31武警號牌

32軍隊號牌

33應急號牌

10

DB3311/T32—2019

表A.1車牌類型代碼（續(xù)）

代碼代碼名備注

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

11

DB3311/T32—2019

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現(xiàn)代NULL

4奔馳NULL

5本田NULL

12

DB3311/T32—2019

表A.6車標代碼（續(xù)）

代碼代碼名備注

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

13

DB3311/T32—2019

表A.6車標代碼（續(xù)）

代碼代碼名備注

45雙環(huán)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大發(fā)NULL

61捷豹NULL

62歐寶NULL

63克萊斯勒