【GA公共安全标准】 单警执法视音频记录系统第4部分:数据接口

ICS35.240.99
中华人民共和国公共安全行业标准GA/T947.4—2015
单警执法视音频记录系统
第4部分：数据接口
Video/audio recording systems for the individual enforcing policeman-Part4:Datainterface
2015-07-10发布
中华人民共和国公安部
2015-12-01实施
规范性引用文件
术语、定义和缩略语·
数据接口要求
试验方法
附录A（资料性附录）SDK检测软件附录B（资料性附录）
管理服务器数据接口检测软件
GA/T947.4—2015
GA/T947《单警执法视音频记录系统》分为四个部分：第1部分：基本要求；
第2部分：执法记录仪：
—第3部分：管理平台；
——第4部分：数据接口。
本部分为GA/T947的第4部分。
本部分按照GB/T1.1一2009给出的规则起草。本部分由公安部社会公共安全应用基础标准化技术委员会提出并归口。GA/T947.4—2015
本部分主要起草单位：公安部第一研究所、公安部特种警用装备质量监督检验中心、南京市公安局建邺分局。
本部分参与起草单位：深圳市银翔科技有限公司、济南致业电子有限公司、深圳市警圣电子科技有限公司。
本部分起草人：张翔、卢玉华、郑征、谢峰、杜伟、张哲、刘芷伊、朱振普、曹亮、章志勇、何国强、曹永军、韩武鹏、王鑫、吕军、崔乘刚、陈东雨、夏平、代松、刘军、苏智睿、周红春、白剑峰、袁瑛、陈勇、杨硕、谢越芳、陈泉斌、李东。
1范围
单警执法视音频记录系统
第4部分：数据接口
GA/T947.4—2015
GA/T947的本部分规定了单警执法视音频记录系统各组成单元中的软硬件接口、协议、数据格式及单警执法视音频记录系统与其他公安业务系统间的数据接口规范。本部分适用于单警执法视音频记录系统。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GA/T543.1—2011
公安数据元（1）
GA/T543.6-2015
GA/T543.7--2015
公安数据元（6）
公安数据元（7）
GA/T947.1—2015
单警执法视音频记录系统第1部分：基本要求GA/T947.2—2015
GA/T947.3--2015
GA/T1183—2014
3术语、定义和缩略语
3.1术语和定义
单警执法视音频记录系统第2部分：执法记录仪单警执法视音频记录系统第3部分：管理平台数据交换格式标准编写要求
GA/T947.1—2015，GA/T947.2-—2015和GA/T947.3—2015界定的术语和定义适用于本文件。为了便于使用，以下重复列出了GA/T947.1—2015、GA/T947.3—2015中的一些术语和定义。3.1.1
数据接口
data interface
执法记录仪接入执法数据采集设备后实现充电、时间同步并自动上传视音频、音频、照片等文件等功能所应具备的访问接口，包括但不限于执法记录仪和执法数据采集设备之间连接与信息交互的接口，执法数据采集设备和管理服务器之间连接与信息交互的接口及管理服务器和其他公安业务系统的接口。
[GA/T947.1—2015定义3.5］
managerpassword
管理员密码
系统对执法记录仪预置的对数据进行读取，删除等操作的最高权限密码，[GA/T947.3—2015定义3.3]
单位编号
使用执法记录仪的民警所属单位的组织机构代码。［GA/T947.3—2015定义3.4]
GA/T947.4—2015
单位名称
unitname
使用执法记录仪的民警所属单位的正式名称。[GA/T947.3—2015定义3.5]
3.2缩略语
下列缩略语适用于本文件。
USB，通用串行总线（Universal SerialBus）SDK：软件开发工具包（SoftwareDevelopmentKit）DLL：动态链接库（DynamicLinkLibrary）Lib:库(Library)
HTTP：超文本传输协议（HypertextTransferProtocol)FTP：文件传输协议（FileTransferProtocol)4通则
4.1接口关系
执法记录仪与执法数据采集设备、执法数据采集设备与管理服务器数据接口关系参见GA/T947.1一2015的图1。
4.2功能要求
数据接口应能实现执法记录仪与执法数据采集设备、执法数据采集设备与管理服务器互联互通，不同生产厂的执法记录仪、执法数据采集设备及管理软件相互兼容。5数据接口要求
5.1执法记录仪与执法数据采集设备数据接口要求5.1.1硬件接口要求
执法记录仪与执法数据采集设备的硬件接口应采用USBMiniB型接口或USBMicroB型接口。5.1.2软件接口要求
执法记录仪与执法数据采集设备的软件接口应符合如下要求：接口通过SDK形式提供
执法记录仪中的数据及基本信息，如产品序号、警员编号（以下简称警号）、管理员密码、电池电量、单位名称、使用者姓名等可以被执法数据采集设备通过SDK调用。生产厂应提供对应不同驱动版本的SDK文件。DLL版SDK采用C风格的编译，适用于CIC++等开发语言。SDK应提供DLL、Lib、h等二次开发需要的库及源文件。
SDK实现的函数和数据结构
SDK应提供下列函数和数据接口，所有函数应提供函数名称，参数，调用函数后的返回值，参数类型、返回值类型、参数及返回值的描述说明、调用函数的错误信息说明。软件函数接口和数据结构至少应包括表1的内容。2
丽数名称
Init_Device
GetIDCode
GetZFYInfo
WriteZFYInfo
SyncDevTime
SetMSDC
ReadDevice
Resolution
ReadDevice
BatteryDump
Energy
初始化连接
获取生产厂
代码及产品
型号代码
获取记录
仪信息
写人记录
仅信息
同步执法
记录仪时间
设置为移动
磁盘模式
读取当前录
像分辨率
读取电量
软件函数接口和数据结构表
IDCode
Height
Battery
参数类型
字符串
无符号短
字符串
无符号短
ZFY_INFO
字符串
无符号短
ZFY_INFO
字符串
无符号短
字符串
无特号短
字符串
无符号短
整型指针
整型指针
字符串
无符号短
整型指针
字符串
无符号短
参数描述
识别码
错误代码
识别码
错误代码
执法记录仪
管理员密码
错误代码
执法记录仪
管理员密码
错误代码
管理员密码
错误代码
管理员密码
错误代码
分辨率宽
分辨率高
管理员密码
错误代码
电量百分比
值×100
取值范围：
管理员密码
错误代码
返回值
GA/T947.42015
返回值
布尔型
布尔型
布尔型
布尔型
布尔型
布尔型
布尔型
布尔型
返回值描
述说明
是否连接
是否成功
获取识
是否成功
获取记录
仪信息
是否成功
写人记录
仅信息
是否成功
同步记录
仪时间
是否成功
设置为移
动磁盘
是否成功
获取到录
像分辨率
是否成功
获取电量
GA/T947.4-2015
丽数名称
表1(续）
参数类型
参数描述
1）参数类型中的\ZFY_INFO\的数据结构如下：typedef struct
char cSerial[7];
char userNo[6]:
返回值
/*执法记录仪产品序号，不可为空*//*执法记录仪使用者警号，不可为空*/返回值
返回值描
述说明
charuserName[32]；/*执法记录仪使用者姓名，管理平台使用警号关联时可为空*/charunitNo[12]；/*执法记录仪使用者单位编号，管理平台使用警号关联时可为空*/charunitName[32]/*执法记录仪使用者单位名称，管理平台使用警号关联时可为空*/ZFY INFO:
2）参数描述说明中的“错误代码\的数据结构如下：typedef enum _RESULT_FLAG
CONNECT_SUCCESS=OxO1，/*执法记录仪连接成功*CONNECT_FAILED,
CHECK_PWD_SUCCESS，
CHECK_PWD_FAILED，
/*执法记录仪连接失败*/
/*执法记录仪管理员密码校验成功*//*执法记录仪管理员密码校验失败*/SET_SYSTEMTIME_SUCCESS，/*执法记录仪系统时间同步成功*/SET_SYSTEMTIME_FAILED,
MSDC_SUCCESS.
MSDC_FAILED
RESULT_FLAG;
5.1.3数据通讯要求
/*执法记录仪系统时间同步失败*//*执法记录仪转换移动磁盘模式成功//*执法记录仪转换移动磁盘模式失败*/执法记录仪与执法数据采集设备间的数据通讯应采用USB通讯协议，应为USB2.0或者以上，USB接口实际传输速率不应低于40Mbps。5.2执法数据采集设备与管理服务器数据接口要求5.2.1硬件接口要求
执法数据采集设备与管理服务器的硬件接口应具有符合RJ45协议的网络接口，接口应能支持100Mbps以上的网络传输。
管理服务器应为专业网络服务器或专用设备，具有接入局域网的能力，应能支持1Gbps的网络接口。
5.2.2软件接口要求
5.2.2.1概要
执法数据采集设备与管理服务器通过软件接口进行数据传输，应至少包括表2中所示的接口，其中接口1、2是查询类接口，是执法数据采集设备从执法记录仪及本地查询数据的接口，接口3、4是上传类接口，是执法数据采集设备向管理服务器上传数据的接口。4
接口名称
执法数据采集设备与管理服务器传输数据接口接口定义
执法记录仪信息查询
执法数据采集设备信息查询
执法记录仪信息上传
执法数据采集设备信息上传
5.2.2.2工作方式
［[1]执法记录仪基本信息查询QUERYDSJINFO［2]
执法记录仪日志信息查询CXDSJLOG执法数据采集设备基本信息查询QUERYS[]
TATIONINFO
执法数据采集设备日志信息查询QUERYS［2]
TATIONLOG
执法记录仪基本信息上传WRITEDSJINFO执法记录仪日志信息上传WRITEDSJLOG执法数据采集设备基本信息上传WRITES-TATIONINFO
执法数据采集设备日志信息上传WRITES-［2]
TATIONLOG
GA/T947.4—2015
提供者
执法记录仪
执法数据采
集设备
执法记录仪
执法数据采
集设备
执法数据采集设备与管理服务器间交换索引文件应采用HTTP协议，要求如下接口类型
查询类
查询类
上传类
上传类
请求方式为POST请求。通过简单的name=value\的形式提交内容或响应请求内容；a
b）交换数据统一使用UTF-8编码；安全验证使用32位认证密钥方式，宜采用MD5加密；c
d）为确保数据传输完整性，每次请求都应有响应。执法数据采集设备与管理服务器间传输视音频等文件应采用FTP协议，使用有用户授权的方式传输。
5.2.2.3访问地址
HTTP请求接口访问地址示例为：http：//IP：port/OpenApi/，其中IP为WEB服务器地址，port对应系统应用服务端口号。
FTP访间地址示例为：ftp：//用户名：密码?IP：port/路径/，其中用户名和密码为FTP服务器授权用户的用户名和密码，IP为FTP服务器地址，Port对应服务端口号。5.2.2.4请求响应格式
执法数据采集设备与管理服务器间请求响应格式应参照GA/T1183—2014的要求，参数项应参照GA/T543.1-2011、GA/T543.6——2015.GA/T543.7—2015的相关要求，应采用标准XML，示例如下：
查询类接口
请求响应即每次向服务器提交请求后的返回值格式为XML：《？xmlversion=\1.o\encoding=\UTF-8\?)(data name=\xxx\code=\1\)(message)[message《record参数名1=”返回值1”参数名2=”返回值2”.../）5
GA/T947.4—2015
(/data)
/*name
message
record
上传类接口
为提交的接口名
为返回的状态码，0查询失败1查询成功为响应消息内容
为查询结果
请求响应即每次向服务器提交请求后的返回值格式为XML：<？xmlversion=1.o”encoding=\UTF-8\?)(message)[message]
/*name
为提交的接口名
为返回的状态码，0上传失败1上传成功为响应消息内容
message
5.2.2.5格式定义
5.2.2.5.1
执法记录仪信息查询接口
执法记录仪信息查询接口应能实现查询执法记录仪基本信息、执法记录仪日志信息，并获取根据查询条件和查询类型返回的查询结果：执法记录仪基本信息查询
查询条件参数如表3所示，查询结果参数如表4所示。执法记录仪基本信息查询条件参数表表3
参数项
authKey
参数名
文件编号
使用者姓名
单位编号
单位名称
拍摄日期
认证密钥
varchar
varchar
varchar
varchar
varchar
datetime
varchar
参数描述
文件编号
文件别名
拍摄时间
是香可空
可以为空
GA/T543.1—2011：数据元DE00002GA/T543.7—2015：数据元DE00893GA/T543.1—2011数据元DE00060GA/T543.1—2011：数据元DE00065YYYY-MM-DD
MD5加密
执法记录仪基本信息查询结果参数表类型
varchar
varchar
varchar
是否可空
YYYY-MM-DDhh:mm:ss
参数名
gzz_xh
gzz_ipdz
参数描述
文件大小
文件类型
使用者姓名
单位编号
单位名称
产品序号
存储位置
播放位置
物理位置
上传时间
标注类型
执法数据采
集设备产品
执法数据
采集设备IP
varchar
varchar
varchar
varchar
varchar
varchar
varchar
varchar
varchar
varchar
datetime
varchar
varchar
varchar
执法记录仪日志信息查询
表4（续）
是否可空
查询条件参数如表5所示，查询结果参数如表6所示。GA/T947.4—2015
单位：字节
GA/T543.1-2011：数据元DE00002GA/T543.7—2015：数据元DE00893GA/T543.1-—2011：数据元DE00060GA/T543.1-2011：数据元DE000657位数字
文件相对路径
HTTP访间路径
本机存储路径
YYYY-MM-DDhh:mm:ss
GA/T54.3.6—2015：数据元DE00650执法记录仪日志信息查询条件参数表表5
参数项
authKey
参数名
产品序号
日志时间
认证密钥
产品序号
日志类型
文件名称
日志时间
varchar
datetime
varchar
是否可空
前两个条件必须一个不为空；7位数字前两个条件必须一个不为空
YYYY-MM-DD hh:mm+ss
MD5加密
执法记录仪日志信息查询结果参数表类型
warchar
warchar
varchar
datetime
是香可空
7位数字
YYYY-MM-DDhh:mm:ss
GA/T947.4—2015
执法数据采集设备信息查询接口5.2.2.5.2
执法数据采集设备信息查询接口应能实现查询执法数据采集设备基本信息、执法数据采集设备日志信息，并获取根据查询条件和查询类型返回的查询结果：执法数据采集设备基本信息查询a)
查询条件参数如表7所示，查询结果参数如表8所示。表7
参数项
gzz_xh
gzz_ipdz
quthKey
参数名
gzz_xh
gzz_ipdz
ybkjdxwww.bzxz.net
jssykjdx
执法数据采
集设备产品
执法数据
采集设备IP
认证密钥
执法数据采
集设备产品
执法数据
采集设备IP
在线状态
启用状态
硬盘空间
即时剩余
空间大小
执法数据采集设备基本信息查询条件参数表类型
varchar
warehar
varehar
是否可空
GA/T543.6—2015：数据元DE00650MD5加密
执法数据采集设备基本信息查询结果参数表类型
varehar
warchar
varchar
varchar
执法数据采集设备日志信息查询b）
是否可空
查询条件参数如表9所示，查询结果参数表如表10所示。表9
参数项
gzz_xh
authKey
执法数据采
集设备产品
日志时间
认证密钥
GA/T543.6—2015：数据元DE006500，不在线；1，在线
0，未启用：1，启用
单位为：字节
单位为：字节
执法数据采集设备日志信息查询条件参数表类型
varehar
datetime
varchar
是否可空
前两个条件必须一个不为空
前两个条件必须一个不为空
YYYY-MM-DDhh:mm:$s
MD5加密
参数名
5.2.2.5.3
执法数据采
集设备产品
日志类型
对象编号
日志时间
执法记录仪信息上传
执法数据采集设备日志信息查询结果参数表类型
varchar
varchar
varchar
datetime
是否可空
GA/T947.4—2015
执法记录仪或文件编号
YYYY-MM-DD hh;mm:$s
执法记录仪信息上传接口应能实现上传执法记录仪基本信息与执法记录仪日志信息，具体如下：a)
执法记录仪基本信息上传
上传数据参数如表11所示，返回结果如表12所示，表11
执法记录仪基本信息上传参数表参数项
gzz_xh
authKey
文件编号
文件别名
拍摄时间
文件大小
文件类型
使用者姓名
产品序号
单位编号
单位名称
存储服务器
存储位置
播放位置
物理位置
执法数据采
集设备产品
上传时间
标注类型
认证密钥
varchar
varchar
datetime
varchar
varchar
varchar
varchar
Varchar
warchar
varchar
varchar
varchar
warchar
varchar
varchar
datetime
varchar
varchar
是否可空
YYYY-MM-DDhh:mm:ss
单位为：字节
GA/T543.1—2011数据元DE00002GA/T543.7—2015：数据元DE008937位数字
GA/T543.1-2011：数据元DE00060GA/T543.1-2011：数据元DE00065文件相对路径
HTTP访问路径
本机存储路径
YYYY-MM-DD hh:mm.ss
MD5加密
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。