二次开发接口文档

接口开发文档

一、开发包目录结构

1.1demo文件夹

包含了sdk接口调用源代码，可供二次开发参考。使用C++开发的MFC程序。

1.2dll文件夹

包含了二次开发所需的所有动态库，demo编译好的exe文件需要放在该文

件夹内才可以运行。

1.3include文件夹

包含了二次开发所需要的头文件。

1.4lib文件夹

包含了二次开发所需要的lib静态库。

1.5DSS二次开发指南(C++).pdf

指导二次开发用户如何新建VS2005工程运行demo文件夹中的demo。

1.6Version.xml

dpsdk开发包的程序版本信息。

1.7常见问题解答.pdf

二次开发常见问题以及解决方式。

1.8大华平台SDK开发手册(C++版).chm

二次开发接口使用说明。

二、术语和缩略语

1、DPSDK：DSS平台二次开发SDK包

2、CMS：中心管理服务

5、web管理员端：在浏览器中输入DSS平台的ip即可打开管理员端

6、CameraID：通道id，形如：10000010$1$0$0

7、DeviceID：设备id

三、Demo操作方法

3.1运行demo

把“demo/bin/”目录下面的3个文件，如下图所示

拷贝到“dll”文件夹下面，运行Test_DPSDK_Core.exe。

3.2登陆平台

图 1 登陆界面

登陆界面如图 1 所示，

其中： IP：DSS 平台

ip 地址；端口：9000；

用户名：web 管理员端配置的用户；

密码：web管理员端配置的用户对应的密码。

点击“登录”按钮，登陆平台。登陆成功的界面如图2所示：

1

23

5

图2 主界面

上图选中的 5个模块分别是：1、组织树；2、实时视频；3、本地录像；4、云

台操作；5、执行结果。

3.3主界面功能介绍

3.3.1、组织树

操作步骤：点击“加载所有组织结构”按钮加载组织结构是其他操作的前提，是为了获取 DSS平台上所有的设备信息。

3.3.2、实时视频模块

操作步骤：1）确保已经成功加载组织结构。2）输入CamID(通道ID)。3）

点击“打开视频”按钮，即可打开视频。如果打开视频失败会在“模块5”的位

置提示错误码。

注释1:CamID(通道ID)的获取方式有1）展开模块1组织树，寻找到对应的

编码器通道，即可看到该通道对应的通道ID；2）登陆web管理员端，选择基本配置-设备管理-编码器界面，看到“编码”列给出的是“设备ID”。使用设备ID组成通道ID即：设备ID$1$0$0。$1代表编码器，$0代表单元序号，默认为0，$0代表通道号。具体信息参考“常见问题解答”。

3.3.3、本地录像模块

操作步骤：1）确保已经成功加载组织结构。2）确保已经成功打开实时视频。3）点击“开始录像”按钮即可开始本地录像。在打开实时视频以后可以录像，并保存到本地磁盘。

3.3.4、云台控制模块

操作步骤：1）确保已经成功加载组织结构。2）确保已经成功打开实时视频。

打开实时视频以后，针对球机设备可以操作八方向、调节球机镜头、设置预置点等。

3.3.5、执行结果模块

将所有操作的结果输出。并输出对应的操作失败错误码。

3.4 回放界面功能介绍

3.4.1录像查询

操作步骤：1）确保已经成功加载组织结构。2）输入 CameraID（通道 ID）。3）选择查询的开始和结束时间。4）选择录像来源。5）选择录像类型。点击“查询录像”按钮查询录像。

3.4.2录像回放

操作步骤：1）确保已经成功加载组织结构。2）确保已经查询到录像文件。3）选中录像文件，点击“按文件回放”按钮。

3.4.2录像下载

操作步骤：1）确保已经成功加载组织结构。2）确保已经查询到录像文件。3）选中录像文件，点击“按文件下载”按钮。

3.5报警功能

3.5.1查询报警

操作步骤：1）确保已经成功加载组织结构。2）输入CamID（通道ID）。3）选择报警类型，点击“查询”按钮。

需要注意的是查询视频类报警（即：视频丢失/移动侦测/视频遮挡）时CamID 为1000001$1$0$0，查询其他报警（除上述3种报警类型）的时候CamID为1000001$3$0$0。因为视频类报警是由“视频通道”产生，其他报警是由“报警输入通道”产生。

3.5.2报警布控

操作步骤：1）确保已经成功加载组织结构。2）输入设备 ID。3）输入通道号，（视频类报警使用“视频通道号”，其他报警使用“报警通道号”）。4）选择报警类型，点击“布控” 按钮即可。

注释：视频类报警类型包含1）视频丢失2）移动侦测3）视频遮挡。

3.6语音对讲

3.6.1打开语音对讲

操作步骤：1）确保已经成功加载组织结构。2）输入 CamID（通道 ID），选择对讲参数， 3）点击“开始语音对讲”按钮。

如果参数错误会弹窗提示正确参数信息。

3.6.2关闭语音对讲

操作步骤：1）确保已经成功打开语音对讲。2）点击“根据序列号停止语音

对讲”或者“根据通道号停止语音对讲”按钮。

3.7电视墙

目前Demo不能新建电视墙任务，只能获取平台配置好的电视墙信息。电视

墙的任务需要在平台客户端添加。