二次开发接口文档

一、开发包目录结构

1.1demo 文件夹

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

1.2dll 文件夹

包含了二次开发所需的所有动态库，demo 编译好的exe 文件需要放在该文件夹内才可以运行。

1.3include 文件夹

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

1.4lib 文件夹

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

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

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

1.6

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

1.7常见问题解答.pdf

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

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

二次开发接口使用说明。

二、术语和缩略语

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

2、CMS：中心管理服务

3、DMS：设备管理模块

4、demo：程序示例（功能类似DSS 平台客户端）

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

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

7、DeviceID：设备id

三、Demo 操作方法

运行demo

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

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

登陆平台

图 1 登陆界面

登陆界面如图 1 所示，

其中： IP：DSS 平台

ip 地址；端口：9000；

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

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

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

图2 主界面

上图选中的 5个模块分别是：1、组织树；2、实时视频；3、本地录像；4、云台操作；5、执行结果。

主界面功能介绍

、组织树

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

、实时视频模块

操作步骤：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 代表通道号。具体信息参考“常见问题解答”。

、本地录像模块

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

3）点击“开始录像”按钮即可开始本地录像。在打开实时视频以后可以录像，并保存到本地磁盘。

、云台控制模块

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

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

、执行结果模块

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

回放界面功能介绍

录像查询

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

录像回放

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

录像下载

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

报警功能

查询报警

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

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

报警布控

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

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

语音对讲

打开语音对讲

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

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

关闭语音对讲

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

电视墙

目前Demo不能新建电视墙任务，只能获取平台配置好的电视墙信息。电视墙的任务需要在平台客户端添加。

电视墙操作

操作步骤：1）确保已经成功加载组织树。2）点击“获取电视墙总数”按钮。3）点击“获取电视墙信息”按钮。4）选择电视墙ID。5）点击“获取电视墙布局”按钮。即可显示电视墙对应的屏幕分割信息。

上图显示ID 为3 的电视墙的名字是tt 状态是1（代表启用）。电视墙有4 块屏幕，屏id、屏名称、屏坐标、是否绑定解码器（1_1000943 代表绑定解码器，解码器id 为1000943）。

屏幕分割和开窗操作

操作步骤：1）确保已经成功获取到电视墙屏幕信息。2）选择一个屏幕。3）执行分割和开窗操作。所有的融合屏都只做开窗。非融合和融合的NVD 都只做分割。

开窗操作（left，上）代表窗口左上角坐标，width 和Height 代表宽和高的比例，范围是0-100。例如：（left，上）为（0,0）；（width,Height）为

（50,50）。

设置视频源操作

操作步骤：1）确保已经成功获取到电视墙屏幕信息。2）输入编码器通道ID。3）输入窗口号（分割和开窗操作的窗口号从0开始）。4）点击“设置”按钮。5）点击“关闭”按钮清除窗口视频源。6）点击“清屏”按钮清除所有屏幕上的窗口和视频源。