二次开发接口文档Word格式.docx

二次开发接口文档Word格式.docx

《二次开发接口文档Word格式.docx》由会员分享，可在线阅读，更多相关《二次开发接口文档Word格式.docx（10页珍藏版）》请在冰豆网上搜索。

设备id

三、Demo操作方法

运行demo

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

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

登陆平台

登陆界面如图1所示，其中：

IP：

DSS平台

ip地址；

端口：

9000；

图1登陆界面

用户名：

web管理员端配置的用户；

密码：

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

点击“登录”按钮，登陆平台。

登陆成功的界面如图2所示：

1

2

3

5

图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代表通道号。

具体信息参考“常见问题解答”。

、本地录像模块

2）确保已经成功打开实时视频。

3）点击“开始录像”按钮即可开始本地录像。

在打开实时视频以后可以录像，并保存到本地磁盘。

、云台控制模块

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

、执行结果模块

将所有操作的结果输出。

并输出对应的操作失败错误码。

回放界面功能介绍

录像查询

2）输入CameraID（通道ID）。

3）选择查询的开始和结束时间。

4）选择录像来源。

5）选择录像类型。

点击“查询录像”按钮查询录像。

录像回放

2）确保已经查询到录像文件。

3）选中录像文件，点击“按文件回放”按钮。

录像下载

3）选中录像文件，点击“按文件下载”按钮。

报警功能

查询报警

3）选择报警类型，点击“查询”按钮。

需要注意的是查询视频类报警（即：

视频丢失/移动侦测/视频遮挡）时CamID为1000001$1$0$0，查询其他报警（除上述3种报警类型）的时候CamID为1000001$3$0$0。

因为视频类报警是由“视频通道”产生，其他报警是由“报警输入通道”产生。

报警布控

2）输入设备ID。

3）输入通道号，（视频类报警使用“视频通道号”，其他报警使用“报警通道号”）。

4）选择报警类型，点击“布控”按钮即可。

注释：

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

语音对讲

打开语音对讲

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除外>

都只做开窗。

非融合和融合的NVD都只做分割。

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

例如：

（left，上）为（0,0）；

（width,Height）为（50,50）。

设置视频源操作

2）输入编码器通道ID。

3）输入窗口号（分割和开窗操作的窗口号从0开始）。

4）点击“设置”按钮。

5）点击“关闭”按钮清除窗口视频源。

6）点击“清屏”按钮清除所有屏幕上的窗口和视频源。

四、常见问题

1概述

本文档列出了使用大华SDK进行二次开发时出现的常见问题以及对应的解决方法。

方便第三方开发者快速定位问题，提高二次开发效率。

2问题列表

WebDemo问题汇总

在IE浏览器中打开webDemo视频窗口显示

因为没有注册ocx。

在ocx文件夹中双击只有提示注册成功才可以。

OCX控件问题汇总

OCX无法注册

1、OCX控件时微软推出已久的技术，其注册方法及出错原因可在微软官方文档上查询，或者可以自行在网上查找解决方法。

OCX注册问题本不属于DPSDK支持范畴。

2、不过我们还是提供一些建议，以便您快速排除问题：

（1）用“管理员权限”打开“开始”-“附件”-“命令提示符”，输入“regsvr32ocx的全路径”即可。

（2）我们提供的OCX控件是32位程序，请确保系统有32位兼容库，具体判断方法为C:

\Windows\SysWOW64这个文件夹下是否有“”这个文件，若没有，请重新安装系统。

若有，请按

（1）中的方式打开命令提示符，输入“c:

\windows\SysWOW64\regsvr32ocx全路径”即可，如“c:

\windows\SysWOW64\regsvr32Z:

\DPSDK_OCX\ocx\”

如以上2点仍然没有能够成功注册，请在网上，根据自己的系统信息自行搜索解决方案。

3、在注册dll或者ocx的时候，经常会遇到这么一个问题：

模块已加载，但对dllregisterServer的调用失败，错误代码为0x8004*****

解决方法：

在批处理的第一行加入：

cd/d%~dp0然后在批处理上右键选择使用管理员权限运行

4、Windows7出现:

应用程序无法启动,因为应用程序的并行配置不正确有关详细信息，请参阅应用程序事件日志，或使用命令行工具。

”解决方法：

出现这个问题是因为安装windows7后，或使用ghost版本安装后，windows7没有安装VisualC++库，而有些软件需要VisualC++库所以到微软官方网站下载：

MicrosoftVisualC++2005SP1RedistributablePackage（x86）下载：

-984D-389C36F85647&

displaylang=zh-cn安装

64位系统下OCX无法使用

目前OCX控件只有32位的程序，所以在64位系统下，需要下载32位的IE，用32位的IE

加载OCX控件即可。

Ocx注册成功但是在页面加载失败

运行IE,工具->

Internet选项->

安全，确保Internet和本地Intranet和可信站点的自定义级别中的ActiveX选项都不是禁止状态，将禁止状态改为提示状态。

Ocx开发包demo程序运行不起来

未注册，可以采用一下两种方法注册：

运行->

CMD，regsvr32绝对路径

运行ocx开发包文件夹里面的批处理，注意：

必须要和放在同一个路径。

如果仍旧注册失败需要安装vs发布包，，可以从微软官网上直接下载

如何获通道ID（CameraID）

在浏览器输入DSS平台的ip打开web管理员端，用管理员身份登录平台，找到“基本设置”-“设备管理”-“编码器”页面的“编码”列是所有的设备ID。

而CameraID的格式为:

"

设备ID$1$0$通道号"

如设备ID为“1000000”，且设备下有3个视频通道，那么这3个CameraID为"

1000000$1$0$0"

、"

1000000$1$0$1"

1000000$1$0$2"

。

是否可以不加载组织结构

不调用DPSDK_LoadDGroupInfo也是可以的，但仅限于实时视频、录像回放，其他操作，如操作云台等功能无法使用。

方法是Get_RealStream_Info_t中的nRight设置为DPSDK_CORE_NOT_CHECK_RIGHT即可。

OCX无法保存抓图或创建文件夹失败

win7系统的安全控制导致OCX控件无法创建文件夹。

需要使用administrator账号登陆

win7系统开发使用（有管理员权限的普通账户也不行）。

OCX控件收不到报警

1）需要先调用布控报警DPSDK_EnableAlarm。

2）其次平台或者设备触发报警。

OCX请求视频没有声音

需要打开音频（DPSDK_OpenAudioByWndNo，DPSDK_OpenAudioByHWND）

加载监控视频成功时浏览器会死掉

浏览器兼容问题，目前ocx控件主要针对IE8/IE9环境。

IE浏览器加载视频成功，其他浏览器无法加载

浏览器兼容问题，其他基于IE内核或者多核模式的浏览器（遨游，360，搜狗浏览器等）需要选择兼容模式浏览。

OCX操作导致IE崩溃

目前OCX中我们已经集成了在崩溃时生成crashdump的功能，OCX崩溃时会弹出对话框提示dump生成的位置，用户只需在此位置下找到.dmp文件，然后将对应的pdb文件一同发送给我们即可。

目前OCX只支持ie832位浏览器

在页面中加上<

metahttp-equiv="

X-UA-Compatible"

content="

IE=EmulateIE8"

/>

，让IE浏览器以兼容IE8方式运行。

一路视频对应两路音频情况缺少音频通道标识

2.3.1DPSDK_OCX之前的开发包中已经提供了多音频通道的接口，DPSDK_GetAudioChannelsByWndNo如何获通道ID（CameraID）

1）DPSDK_DLL开发包中，有demo程序，demo程序中登录后，选择“分级加载组织结构”，即可看到组织和设备树。

双击直到最后一层即为CameraId。

demo我们提供了源码，你可以根据源码进行开发，源码中涉及到的函数在开发文档中都有详细说明。

2）在浏览器中，用管理员身份登录平台，可以看到所有的设备ID。

而编码器CameraID的格式为:

如设备ID为“1000000”，且设备下有3个通道，那么这3个CameraID为"

NVR设备状态和通道状态不同

NVR的通道状态需要通过订阅才能实时返回通道状态。

设备在线，不一定通道在线。

dll：

DPSDK_SetDPSDKNVRChnlStatusCallback。

登录之后打开视频返回rtsp建立失败

如果是内外网环境，可能网络环境不正确。

2.4AndroidSDK问题汇总

2.5IOSSDK问题汇总

点击实时预览崩溃

可能是播放库太老，需要更新播放库。

其它

设备通道ID（CameraID）如何获取？

获取方式：

方法1.打开DPSDK对应的Demo，加载组织树，展开对应的组织节点，找到设备即可看到通道ID

方法2.通道ID格式为：

“设备ID$1$0$通道号”。

比如设备ID为1000001，对应第一个视频通道ID为1000001$1$0$0，对应第二个视频通道为1000001$1$0$1，依次类推。

设备ID可以从DSS管理员端“设备管理”页面获取。

在管理员模式下，使用system用户登陆进入：

基本设置->

设备管理查看设备ID。

通道号：

对于IPC设备，只有一个通道，通道号只有0；

对于DVR设备，有多个通道，具体的通道个数是在web管理员平台上配的，比如配了4个通道，通道号依次为0,1,2,3。

模拟器实时预览花屏

播放库对模拟器支持不全，实时和回放需要在真机上运行。

目前DPSDK不接受UI界面相关的定制开发，用户需要自己实现UI

界面

目前提供的DPSDK相关Demo只有C++版

DPSDK二次开发邮箱暂不提供研发手机号码

现在只维护平台是以后的dpsdk

平台的dpsdk已经不再维护。

打开视频的接口

有两种打开视频的接口：

1）使用ext层，用户不需要关心码流，VaxPlayer库解析之。

2）不使用ext层，设置码流回调函数，客户可以拿到码流。

DPSDK_GetRealStream（）pDlg->

PostMessage（WM_MEDIADATA_CB,nSeq,0）

CWndPlayer:

:

OnMediaDataCallback（WPARAMwParam,LPARAMlParam）

按时间回放功能

1）按时间回放平台录像，由于平台存在问题，相关功能会出现bug。

不建议用户使用该功能。

2）按时间回放设备录像没有问题。

平台回调上来的码流

平台回调上来的码流是PS流+大华头。

直接使用vaxPlayer播放。

如果前端是海康设备回调上来的码流是大华头+海康流。

需要使用mediaParser库去掉大华头在用vaxPlayer播放或者使用海康的播放库播放。

组织树xml中status字段不准确

加载组织树以后可以拿到组织树xml，设备信息中的status字段无法正确显示设备的状态。

需要注册设备状态回调函数来实时获取设备的状态。

接口：

DPSDK_SetDPSDKDeviceStatusCallback（）初始化设置回调。

在登陆平台的时候会收到设备状态，任何设备状态改变后会再次回调上来。

NVR通道状态比较特殊，因为NVR设备在线的时候，通道状态可以是离线的。

需要使用接口：

DPSDK_SetDPSDKNVRChnlStatusCallback（）

设备状态和通道状态

1、设备在线状态需要设置回调函数：

DPSDK_SetDPSDKDeviceStatusCallback（）在登陆平台时DMS会推送设备状态，设备状态改变DMS也会推送设备状态上来。

2、大部分设备状态和通道状态是一致的。

只有NVR设备存在通道状态因为NVR设备在线，通道可能离线。

登陆平台DMS不会主动推送NVR通道状态，需要客户端主动查询。

登陆平台以后NVR通道状态变化DMS会主动推送上来进入回调函数。

使用接口：

1）通道状态改变回调DPSDK_SetDPSDKNVRChnlStatusCallback（）

2）查询通道状态DPSDK_QueryNVRChnlStatus（）

电视墙开窗和分割

NVD除外>

日志等级

ERROR>

WARNING>

INFO>

DEBUG

设置为INFO会显示error，warning，info

卡口过车数据和违章报警功能说明

1、违章报警只需要设置回调函数，不需要订阅DPSDK_SetDPSDKTrafficAlarmCallback（）DPSDK_CMD_BAY_DPALARM_NOTIFY,//违章报警

Alarm_4JT_PictureLink_Struct

2、卡口过车数据需要设置回调函数并订阅DPSDK_SetDPSDKGetBayCarInfoCallback（）DPSDK_SubscribeBayCarInfo（）

卡口过车图片数据是picSDK回调上来的

EAS_SetPictureCallBack（mPicCallBack,this）;

需要注意的是查询视频类报警（即：

视频丢失/移动侦测/视频遮挡）时CamID为1000001$1$0$0，查询其他报警（除上述3种报警类型）的时候CamID为1000001$3$0$0。

VLC使用URL拉流

-B之前的版本是不支持RTSPURL拉流的