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

DB3311/T32—2019

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

1范圍

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

本標(biāo)準(zhǔn)適用于視頻監(jiān)控卡口系統(tǒng)的方案設(shè)計(jì)、系統(tǒng)檢測(cè)、驗(yàn)收以及與之相關(guān)的程序研發(fā)。

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

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

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

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

3基本要求

3.1數(shù)據(jù)編號(hào)

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

累加。前端保存的數(shù)據(jù)編號(hào)應(yīng)不會(huì)因?yàn)橥ｋ娀蛑貑⒑螽a(chǎn)生重復(fù)。

3.2傳輸規(guī)則

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

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

備應(yīng)支持?jǐn)?shù)據(jù)重傳機(jī)制。

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

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

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

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

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

time_t

無(wú)特殊說(shuō)明，文檔中所用的時(shí)間都是time_t類型。

UINT32無(wú)符號(hào)整型，4字節(jié)。

UINT64無(wú)符號(hào)整型，8字節(jié)。

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

String字符串

4通信方式

1

DB3311/T32—2019

前端與平臺(tái)間的通訊應(yīng)采用TCP協(xié)議。當(dāng)前端作為TCPServer時(shí)，默認(rèn)偵聽端口為41022。當(dāng)平臺(tái)作

為TCPServer時(shí)，應(yīng)支持注冊(cè)重定向，默認(rèn)偵聽端口為42022，主要適用于前端無(wú)固定IP應(yīng)用場(chǎng)景。前

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

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

5消息組成

5.1消息結(jié)構(gòu)

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

表2消息結(jié)構(gòu)

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

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

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

5.2消息頭

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

表3消息頭內(nèi)容類型

消息標(biāo)識(shí)說(shuō)明數(shù)據(jù)流方向是否需要回復(fù)

0xefff0001前端驗(yàn)證平臺(tái)→前端是

0xefff0002前端向平臺(tái)反饋包前端→平臺(tái)否

0xefff0004卡口記錄V1前端→平臺(tái)是

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

0xefff0007心跳信號(hào)前端→平臺(tái)否

0xefff0008卡口記錄V2前端→平臺(tái)是

0x3fff000a前端驗(yàn)證V2前端→平臺(tái)是

0x3fff000b平臺(tái)向前端反饋包平臺(tái)→前端否

6協(xié)議流程

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

2

DB3311/T32—2019

身份認(rèn)證

認(rèn)證結(jié)果

身份認(rèn)證

認(rèn)證結(jié)果

前前平平

端端臺(tái)臺(tái)

心跳?；?/p>

上傳卡口記錄

確認(rèn)結(jié)果

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

7接口協(xié)議

7.1前端認(rèn)證（平臺(tái)→設(shè)備）

平臺(tái)連接前端時(shí)，應(yīng)攜帶用戶名和驗(yàn)證碼進(jìn)行身份認(rèn)證。認(rèn)證包格式見表4，反饋包格式見表5。身

份認(rèn)證不成功，應(yīng)返回認(rèn)證失敗消息且斷開連接不提供服務(wù)。

認(rèn)證碼由前端進(jìn)行管理，前端應(yīng)可以配置。

表4認(rèn)證包格式

平臺(tái)向前端發(fā)出驗(yàn)證包

消息頭：

驗(yàn)證0xefff0001

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

消息體：

1Char[44]用戶名

數(shù)據(jù)內(nèi)容

2Char[44]認(rèn)證碼

3

DB3311/T32—2019

表5反饋包格式

前端向平臺(tái)反饋包

消息頭：

認(rèn)證狀態(tài)0xefff0002

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

消息體：

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

7.2前端認(rèn)證V2（設(shè)備→平臺(tái)）

前端連接平臺(tái)時(shí)，應(yīng)攜帶通道編號(hào)和驗(yàn)證碼進(jìn)行身份認(rèn)證。認(rèn)證包格式見表6，反饋包格式見表7。

身份認(rèn)證不成功，應(yīng)返回認(rèn)證失敗消息且斷開連接不提供服務(wù)。

認(rèn)證碼由平臺(tái)進(jìn)行管理，平臺(tái)應(yīng)可以配置。

表6認(rèn)證包格式

前端向平臺(tái)發(fā)送驗(yàn)證包

消息頭：

驗(yàn)證0xefff000a

整體數(shù)據(jù)長(zhǎng)度：8+結(jié)構(gòu)化信息長(zhǎng)度+結(jié)構(gòu)化信息

消息體：

描述名稱類型備注

結(jié)構(gòu)化信息長(zhǎng)度結(jié)構(gòu)化信息長(zhǎng)度Integer說(shuō)明后面的結(jié)構(gòu)化信息JSON的長(zhǎng)度

結(jié)構(gòu)化信息結(jié)構(gòu)化信息StringJSON封裝的結(jié)構(gòu)化信息

結(jié)構(gòu)化信息JSON如下，編碼格式采用UTF-8。

{

"DeviceID":"通道編號(hào)",

"Password":"認(rèn)證碼"

}

表7反饋包格式

平臺(tái)向前端反饋包

消息頭：

認(rèn)證狀態(tài)0xefff000b

整體數(shù)據(jù)長(zhǎng)度：8+結(jié)構(gòu)化信息長(zhǎng)度+結(jié)構(gòu)化信息

消息體：

描述名稱類型備注

結(jié)構(gòu)化信息長(zhǎng)度結(jié)構(gòu)化信息長(zhǎng)度Integer說(shuō)明后面的結(jié)構(gòu)化信息JSON的長(zhǎng)度

結(jié)構(gòu)化信息結(jié)構(gòu)化信息StringJSON封裝的結(jié)構(gòu)化信息

結(jié)構(gòu)化信息JSON如下，編碼格式采用UTF-8。

{

"Result":0,//0：認(rèn)證成功；1：用戶名錯(cuò)誤；2：認(rèn)證碼錯(cuò)誤；3：重定向

"RedirectAddress":"10.33.214.126:42022"

4

DB3311/T32—2019

}

7.3心跳?；钚盘?hào)（設(shè)備→平臺(tái)）

前端在通訊空閑時(shí)，應(yīng)每5秒鐘向平臺(tái)發(fā)送一次心跳?；钚盘?hào)，心跳包格式見表8。

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

發(fā)送的心跳?；钚盘?hào)后，不應(yīng)回復(fù)消息。

表8心跳包格式

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

消息頭：

心跳頭0xefff0007

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

7.4發(fā)送卡口記錄（設(shè)備→平臺(tái)）

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

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

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

消息頭：

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

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

消息體：

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

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

0入庫(kù)成功

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

2解析第二步失敗

3入庫(kù)失敗

3Char[44]通道編號(hào)

5

DB3311/T32—2019

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

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

消息頭：

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

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

消息體：

1UINT64圖片編號(hào)，填默認(rèn)值填0

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

3UINT32關(guān)于圖片的識(shí)別數(shù)據(jù)個(gè)數(shù)n條

關(guān)于全景圖的

4UINT32圖片寬度

信息

5UINT

2圖片高度

6Char[48]通道編號(hào)

7Char[48]圖片存儲(chǔ)路徑，填默認(rèn)值”\0”

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

1UINT64數(shù)據(jù)編號(hào)，填默認(rèn)值0

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

3time_t過(guò)卡口時(shí)間8字節(jié)

4UINT64關(guān)聯(lián)的圖片信息編號(hào)，填默認(rèn)

0

5UINT32過(guò)卡口時(shí)間毫秒

6float車輛速度單位公里

7UINT32車道號(hào)

8float識(shí)別精度

9UINT3

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

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

總數(shù)n條識(shí)別

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

數(shù)據(jù)

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

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

14U

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

15UINT32車牌結(jié)構(gòu)(見附錄A.4)

16UINT32在全景圖中的特征圖坐標(biāo)x1如無(wú)填99999999

17UINT32在全景圖中的特征圖坐標(biāo)y1如無(wú)填99999999

18UINT32在全景圖中的特征圖坐標(biāo)x2如無(wú)填99999999

19UINT32在全景圖中的特征圖坐標(biāo)y2如無(wú)填99999999

車牌號(hào)（“00000000”表示未識(shí)別出、行人或非機(jī)動(dòng)車，

20Char[20]

“11111111”表示無(wú)牌車）

7.5發(fā)送卡口記錄V2（設(shè)備→平臺(tái)）

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

6

DB3311/T32—2019

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

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

消息頭：

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

整體數(shù)據(jù)長(zhǎng)度：8+結(jié)構(gòu)化信息長(zhǎng)度+結(jié)構(gòu)化信息+圖像數(shù)據(jù)

消息體：

描述名稱類型備注

結(jié)構(gòu)化信息長(zhǎng)度結(jié)構(gòu)化信息長(zhǎng)度Integer說(shuō)明后面的結(jié)構(gòu)化信息JSON的長(zhǎng)度

結(jié)構(gòu)化信息結(jié)構(gòu)化信息StringJSON封裝的結(jié)構(gòu)化信息，見表12

總共N個(gè)圖像UINT32圖

個(gè)數(shù)。

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

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

圖像2大小UINT32

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

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

?

圖像N大小UINT32

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

結(jié)構(gòu)化信息JSON如下，編碼格式采用UTF-8。

{

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

"VehicleInfo":{

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

"DeviceID":"通道編號(hào)",

"PlateNo":"車牌號(hào)碼",

"VehicleType":"車輛類型",

"VehicleColor":"車輛顏色",

"VehicleBrand":"車輛品牌",

"VehicleModel":"車輛型號(hào)",

"VehicleStyles":"車輛年款",

"PlateType":"車牌種類",

"PlateColor":"車牌顏色",

"PlateStructure":車牌結(jié)構(gòu),

"LaneNo":"車道號(hào)",

"Speed":"車速",

"MaxSpeed":"速度上限",

"MinSpeed":"速度下限",

"Direction":"行駛方向",

"VioCode":"違法代碼",

"PassTime":"抓拍時(shí)間",

"ImageList":[{

"ImageInfo"{//圖像信息

7

DB3311/T32—2019

"ImageNo":圖像序號(hào),

"ImageType":圖像類型,

"ImageWidth":圖像寬度,

"ImageHeight":圖像高度

}

"VehicleCoordinate":[{//車牌坐標(biāo)信息

"X1":車牌坐標(biāo)X1,

"Y1":車牌坐標(biāo)Y1,

"X2":車牌坐標(biāo)X2,

"Y2":車牌坐標(biāo)Y2

}],

"FaceCoordinate":[{//人臉坐標(biāo)信息，依次主駕駛?cè)四?、副駕駛?cè)四?/p>

"X1":人臉坐標(biāo)X1,

"Y1":人臉坐標(biāo)Y1,

"X2":人臉坐標(biāo)X2,

"Y2":人臉坐標(biāo)Y2

}],

}],

}

表12結(jié)構(gòu)化信息

名稱字段名類型備注

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

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

設(shè)備編號(hào)DeviceIDString通道編號(hào)。

車牌號(hào)（“00000000”表示未識(shí)別出、行人或非機(jī)動(dòng)車，“11111111”

車牌號(hào)碼PlateNoString

表示無(wú)牌車）

車牌類型PlateTypeInteger見附錄A.1

方向代碼DirectionString見附錄A.2

車牌顏色PlateColorInteger見附錄A.3

車牌結(jié)構(gòu)PlateStructureInteger見附錄A.4

車輛顏色VehicleColorInteger見附錄A.5

車輛品牌VehicleBrandInteger見附錄A.6

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

車輛型號(hào)VehicleModelString品牌下的型號(hào)，如奧迪A4L，中文描述。

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

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

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

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

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

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

違法代碼VioCodeString

同時(shí)在前端可自定義配置違法代碼

8

DB3311/T32—2019

表12結(jié)構(gòu)化信息（續(xù)）

名稱字段名類型備注

精度為毫秒（YYYYMMDDHHMMSSMMM）

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

表示毫秒。

圖像序號(hào)ImageNoInteger

圖像類型ImageTypeInteger見附錄A.8

圖像寬度ImageWidthInteger

圖像高度ImageHeightInteger

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

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

消息頭：

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

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

消息體：

1UINT64數(shù)據(jù)編號(hào)

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

0入庫(kù)成功

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

2解析第二步失敗

3入庫(kù)失敗

3Char[44]通道編號(hào)

9

DB3311/T32—2019

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

代碼表規(guī)范

A.1車牌類型代碼

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

表A.1車牌類型代碼

代碼代碼名備注

1大型汽車號(hào)牌黃底黑字（含02式號(hào)牌部分）

2小型汽車號(hào)牌藍(lán)底白字（含02式號(hào)牌部分）

3使館汽車號(hào)牌黑底白字、紅“使”字

4領(lǐng)館汽車號(hào)牌黑底白字、紅“領(lǐng)”字

5境外汽車號(hào)牌黑底白／紅字

6外籍汽車號(hào)牌黑底白字

7兩、三輪摩托車號(hào)牌黃底黑字

8輕便摩托車號(hào)牌藍(lán)底白字

9使館摩托車號(hào)牌黑底白字、紅“使”字

10領(lǐng)館摩托車號(hào)牌黑底白字、紅“領(lǐng)”字

11境外摩托車號(hào)牌黑底白字

12外籍摩托車號(hào)牌黑底白字

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

13農(nóng)用運(yùn)輸車號(hào)牌

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

14拖拉機(jī)號(hào)牌黃底黑字

15掛車號(hào)牌黃底黑字黑框線

16教練汽車號(hào)牌黃底黑字黑框線

17教練摩托車號(hào)牌黃底黑字黑框線

18試驗(yàn)汽車號(hào)牌

19試驗(yàn)?zāi)ν熊囂?hào)牌

20臨時(shí)入境汽車號(hào)牌白底紅字黑“臨時(shí)入境”

21臨時(shí)入境摩托車號(hào)牌白底紅字黑“臨時(shí)入境”

22臨時(shí)行駛車號(hào)牌白底黑字黑框線

23警用汽車號(hào)牌

24警用摩托車號(hào)牌

25原農(nóng)機(jī)號(hào)牌

26香港入出境車

27澳門入出境車

31武警號(hào)牌

32軍隊(duì)號(hào)牌

33應(yīng)急號(hào)牌

10

DB3311/T32—2019

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

代碼代碼名備注

41無(wú)號(hào)牌

42假號(hào)牌

43挪用號(hào)牌

51大型新能源汽車號(hào)牌黃綠底黑字，黑框線

52小型新能源汽車號(hào)牌漸變綠底黑字，黑框線

97非機(jī)動(dòng)車用于自定義電動(dòng)車號(hào)牌等

99其他號(hào)牌

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藍(lán)色NULL

2黑色NULL

3黃色NULL

4白色NULL

5綠色NULL

6漸變白綠色新能源小型汽車

7漸變黃綠色新能源大型汽車

99其他顏色NULL

11

DB3311/T32—2019

A.4車牌結(jié)構(gòu)代碼

車牌結(jié)構(gòu)代碼見表A.4。

表A.4車牌結(jié)構(gòu)代碼

代碼代碼名備注

1單行

2雙行

99其它

A.5車輛顏色代碼

車牌顏色代碼見表A.5。

表A.5車輛顏色代碼

代碼代碼名備注

1白色NULL

2銀色NULL

3黑色NULL

4紅色NULL

5紫色NULL

6藍(lán)色NULL

7黃色NULL

8綠色NULL

9褐色NULL

10粉紅色NULL

11灰色NULL

12混合色NULL

99其它顏色NULL

A.6車標(biāo)代碼

車標(biāo)代碼見表A.6。

表A.6車標(biāo)代碼

代碼代碼名備注

1奧迪NULL

2寶馬NULL

3現(xiàn)代NULL

4奔馳NULL

5本田NULL

12

DB3311/T32—2019

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

代碼代碼名備注

6大眾NULL

7馬自達(dá)NULL

8豐田NULL

9別克NULL

10雪弗蘭NULL

11雪鐵龍NULL

12標(biāo)志NULL

13福特NULL

14凌志NULL

15尼桑NULL

16奇瑞NULL

17比亞迪NULL

18起亞NULL

19榮威NULL

20三菱NULL

21斯柯達(dá)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陸風(fēng)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車標(biāo)代碼（續(xù)）

代碼代碼名備注

45雙環(huán)NULL

46薩博NULL

47威茲曼NULL

48全球鷹NULL

49吉奧NULL

50華泰NULL

51華普NULL

52哈飛NULL

53東南NULL

54帝豪NULL

55長(zhǎng)安NULL

56長(zhǎng)豐NULL

57長(zhǎng)城NULL

58大宇NULL

59五十鈴NULL

60大發(fā)NULL

61捷豹NULL

62歐寶NULL

63克萊斯勒