二次开发接口资料文档

1、接口开发文档、开发包目录结构d e-mo"dll,.Includelib隹D券二次幵炭指敢匚卄gdf貧 Verslonjcinl箜常见闾讎骞pTf塑大些平台EDK开岌手册（0 4版Mhm1.1 demo 文件夹包含了 sdk接口调用源代码，可供二次开发参考。使用 C+开发的M FC程序。1.2 dll文件夹包含了二次开发所需的所有动态库，demo编译好的exe文件需要放在该文件夹内才可以运行。1.3 include 文件夹包含了二次开发所需要的头文件。1.4 lib文件夹包含了二次开发所需要的lib静态库。1.5 DSS 二次开发指南(C+).pdf指导二次开发用户如何新建 VS20

2、05工程运行demo文件夹中的demo 。1.6 Version.xmldpsdk开发包的程序版本信息。1.7常见问题解答.pdf二次开发常见问题以及解决方式。1.8大华平台SDK开发手册（C+版）.chm二次开发接口使用说明。、术语和缩略语DPSDK: DSS平台二次开发SDK包CMS :中心管理服务DMS :设备管理模块demo :程序示例（功能类似DSS平台客户端）5、web管理员端：在浏览器中输入DSS平台的ip即可打开管理员端6、CameralD :通道 id，形如：10000010$1$0$07、DevicelD :设备 id 、Demo操作方法3.1 运行 demo把“ demo

3、/bin/ ”目录下面的3个文件，如下图所示J, language也 ConHgJniifii Te5t_&PSDK_C口g占M拷贝到“ dll”文件夹下面，运行 Test DP SDK Core.exe 。3.2登陆平台IP；揣口匸qiYIA登陆界面如图1所示,其中：IP: DSS平台ip 地址；端口： 9000 ；tyattm夺出图1登陆界面用户名：web管理员端配置的用户;A Trr点击“:登录”按钮，登陆平台。登陆成功的界面如图 2所示:功空".Sq1肝占替SWJi'銘 0 电蜒直手'骨匕'PLl虽 1' ff-TOira-K-LlMf

4、flL t灵初畔ff:E绘ft1- j*g5US IDCflDJMlJTSO討比 STn?«s1Sfb号削祂A切F帀：EXi.H«1囂Q占应：1侶丹内冃HP丽ja(I =1151 iS&JH-1虫赳工111虽4册4世SPSS尹卅ft* SS丨SSffl*业1海些土 H眄i H吒+.】叫 r IB 4,冋.r ihHisrSF£».时 iririt.LE1 半 173,7-56.15"”步民,T 一凿删| 1持止1 75.!1m /I f 05 ”|.”114到5制亍 'ZC3CWL27teMDflUJlH护iTZr.iZLiJ

5、丄创捕着陽？*.2UtTztiTJ '”233*151ri_MlL1th y 1硫trt IliC i M覘应 vrn密码：web管理员端配置的用户对应的密码。sa曲 I <jT图2主界面上图选中的5个模块分别是：1、组织树；2、实时视频；3、本地录像；4、云 台操作；5、执行结果。3.3主界面功能介绍 331、组织树操作步骤：点击“加载所有组织结构”按钮 加载组织结构是其他操作的前提，是为了获取DSS平台上所有的设备信息。3.3.2、实时视频模块操作步骤：1 ）确保已经成功加载组织结构。2）输入CamlD（通道ID）。 3） 点击“打开 视频”按钮，即可打开视频。如果打开视频失

6、败会在“模块 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、

7、云台控制模块操作步骤：1 ）确保已经成功加载组织结构。2 ）确保已经成功打开实时视频。打开实时视频以后，针对球机设备可以操作八方向、调节球机镜头、设置预置点等。335、执行结果模块 将所有操作的结果输出。并输出对应的操作失败错误码。3.4回放界面功能介绍H&制I Kj«blI阿*I 土衍kI 171*1.1'i；l注 申注I 17丄龙*；,inj 筑 iQ 申 IT2.7 sa 口I ITJ.电 U1 -+11 申 172.- 37. IBI理y沁WMII rtCHrtM6MS3SItT1?®+ Bti去悸隔讲I电利自I亘m 卡口卜Btl忡卜az«

8、理ngM旧丄 £,1 L 昨则Tjftc(a；陀 I k片*牺目：ansj則吐I 电MM = 劭林乩i即H a：».M昭斗g".| tl;阖乂EtktftSF?辭na育一 -jKBSSJ J&ft：I HAfiTt.山ih<Ld t m.U.T.LBSdJ就ItrW有局預1'?P+ ,1歼T'ff讯amn-ni-i 莎“許rntHH 12； 13：*-.JJ B.*Sfid主zgph咸力卄出KH孔Mtn TrtMCcJt t IDLT341录像查询操作步骤：1 ）确保已经成功加载组织结构。2）输入 CameralD （通道ID ）。3

9、）选择查 询的开始和结束时间。4）选择录像来源。5）选择录像类型。点击“查询录像”按钮查询录像。3.4.2录像回放操作步骤：1 ）确保已经成功加载组织结构。2）确保已经查询到录像文件。3）选中录像文件，点击“按文件回放”按钮。3.4.2录像下载操作步骤：1 ）确保已经成功加载组织结构。2）确保已经查询到录像文件。3）选中录像文件，点击“按文件下载”按钮。3.5报警功能TeH&制I LLilI刊*I 土nkI皿/丄4 lil两I血y111 1魂"盜和 丰 172.7 sa 口I钿I|e1N fl* 刃讲I电利自I迴用 卡口 Fufrka.s"冇！IKI待1 I *1L

10、申 IR.F SZ IBI *ZLE>L：W«II 吨 CHWffflOCD芳I mfl! ITLWU? i. krnttS1 :esfl ；i :空c1 F djBrtli；MU1 ICSI FUKIt m.U.T.LH3.5.1查询报警*rJ£C：T听按呷*fft呼Iftla 'fl时良VW-fcBiL操作步骤：1 ）确保已经成功加载组织结构。2）输入 CamID （通道 ID ）。3）选择报警类型，点击“查询”按钮。需要注意的是查询视频类报警（即:视频丢失/移动侦测/视频遮挡CamID为 1000001 $1 $0$0，查询其他报警（除上述3种报警类型）

11、的时候CamID为1000001 $3$0$0 。因为视频类报警是由“视频通道”产生,其他报警是由“报警输入通道”产生。3.5.2报警布控操作步骤：1 ）确保已经成功加载组织结构。2）输入设备ID。 3）输入通道号，（视频类报警使用“视频通道号”，其他报警使用“报警通道号”）。选择报警类型，点击“布控”按钮即可。注释：视频类报警类型包含1 ）视频丢失2 ）移动侦测3）视频遮挡。3.6语音对讲ten丹題匕押k laFI *rFI H用+闪# AIl砧!_侃嗓*i gg wH 1JZ7.S5l12；17工，孟13T加+ U2.7.sr.iai 氓CXwi；?OOM y iOlJK9QCCS5-WD

12、+ mI，罰i fU.isU+ FCPJ初国i UKI LPSi* aanrECT轴1| H些 主怪I茁# .更观l#i用田 卡口【FUfr H恥乩5远EZsnrU:L»«35LSDKsflsai 1 心血： |«设吕却：L卅色磺JB创吗1|止|5益訂I*科冃5； W；H 0OtS-fl(.-1 15: fQ：?it戟無詁tiric护361打开语音对讲操作步骤：1 ）确保已经成功加载组织结构。2）输入 CamID （通道ID），选择对讲参数,3 ）点击“开始语音对讲”按钮。如果参数错误会弹窗提示正确参数信息。3.6.2关闭语音对讲操作步骤：1）确保已经成功打开语音

13、对讲。2）点击“根据序列号停止语音对讲”或者“根据通道号停止语音对讲”按钮。3.7电视墙目前Demo不能新建电视墙任务，只能获取平台配置好的电视墙信息。电视墙的任务需要在平台客户端添加。! LLilI旳*II.已，山时 j曲I H；.173.7*11) 申 IZ3.7 sa 口I 17丄丄比U1如申 IRC S7. UI JCX>L：W«；l吃C3神WfiMKi站I WOI 17LWJ53i. krnttSt血II册c1、djxtI W；WifllsI (CfiI FlicsI科amn-ni-i lo- hp：?* mm 16： iD：K KEMK Id aft.3.7.1电视

14、墙操作吐和闵F«即电即a去ft. w取电居fl i&pjEiz 3J 电loyfttre： >=<"22MwmuE布勺Jtifflt- f F1T n上flE1 sfi 1gfl魁ii, I曲S_|1 I:i 毎樺'荷讲亘Ml* |匡用卡J旌询*fljBLz.LFL9JI-VWtfW-5T：S-IlOLKOHd EkPCRXEAnocoaHfUKK)】 tr nrmy. H 1立 REHRSQ-DdOCDOLW&KiJJOfD 护1L操作步骤：1）确保已经成功加载组织树。2）点击“获取电视墙总数”按钮。3）点击“获取电视墙信息”按钮。4）

15、选择电视墙ID。5）点击“获取电视墙布局”按钮。即可显示电视墙对应的屏幕分割信息。上图显示ID为3的电视墙的名字是tt状态是1 （代表启用）。电视墙有4块屏幕，屏id、屏名称、屏坐标、是否绑定解码器（1_1000943代表绑定解码器,解码器id为1 000943 ）。3.7.2屏幕分割和开窗操作操作步骤：1）确保已经成功获取到电视墙屏幕信息。2 ）选择一个屏幕。3）执行分割和开窗操作。所有的融合屏 VNVD除外 > 都只做开窗。非融合和融合的NVD都只做分割。开窗操作（left，上）代表窗口左上角坐标，width和Height代表宽和高的比例，范围 是 0-100。例如：（left，上）

16、为（0,0）； （width,Height ）为(50,50 )。3.7.3设置视频源操作ID。操作步骤：1）确保已经成功获取到电视墙屏幕信息。 2 ）输入编码器通道3）输入窗口号（分割和开窗操作的窗口号从 0开始）。4）点击“设置”按钮。5）点击“关闭”按钮清除窗口视频源。 6）点击“清屏”按钮清除所有屏幕上的窗口和视频源。四、常见问题1概述本文档列出了使用大华 SDK 进行二次开发时出现的常见问题以及对应的解决方法。方 便第三方开发者快速定位问题，提高二次开发效率。2冋题列表2.1 WebDemo 问题汇总2.1.1在IE浏览器中打开 webDemo 视频窗口显示 因为没有注册OCX。在O

17、CX文件夹中双击reg.bat只有提示注册成功才可以。2.2 OCX控件问题汇总2.2.1 OCX无法注册 1、OCX控件时微软推出已久的技术，其注册方法及出错原因可在微软官方文 档上查询，或 者可以自行在网上查找解决方法。OCX注册问题本不属于DP SDK支持范畴。2、不过我们还是提供一些建议，以便您快速排除问题:(1 )用“管理员权限”打开“开始”-“附件”-“命令提示符”，输入“regsvr32 ocx的全路径”即可。(2)我们提供的OCX控件是32位程序，请确保系统有32位兼容库，具体判断方法为 C:WindowsSysWOW64这个文件夹下是否有“ regsvr32.exe ”这个文

18、件，若没有，请重新安 装系统。若有，请按(1)中的方式打开命令提示符,输入“ c:windowsSysWOW64regsvr32ocx全路径”即可，如c:wi ndowsSysWOW64regsvr32Z:D PSDK_OCXocxD PSDK_OCX.ocx 如以上2 点仍然没有能够成功注册，请在网上，根据自己的系统信息自行搜 索解决方案。3、在注册dll或者ocx的时候，经常会遇到这么一个问题：模块已加载，但对dllregisterServer的调用失败，错误代码为0x8004* 解决方法：在批处理的第一行加入：cd /d %d pO 然后在批处理上右键选择使 用管理员权限运行4、Wind

19、ows7出现:应用程序无法启动，因为应用程序的并行配置不正确有 关详细信息，请参 阅应用程序事件日志，或使用命令行sxstrace.exe工具。”解决方法：出现这个问题是因为安装 windows7 后，或使用ghost版本安装后,库所以到微软官方网站下载：Microsoft VisualC+2005SP1Redistributable P ackage(x86)windows7 没有安装Visual C+ 库，而有些软件需要Visual C+htt p: / nl oads/details.as px?familyid=200B2FD9-AE1A-4A14安装-984D-389C36F8564

20、7&dis playla ng=zh-cn2.2.2 64位系统下OCX无法使用目前OCX控件只有32位的程序，所以在64位系统下，需要下载32位的IE,用32位的IE加载OCX控件即可。2.2.3 Ocx注册成功但是在页面加载失败运行IE,工具->1 nternet 选项-> 安全，确保In ternet和本地Intran et和可信站点的自定义级别中 的ActiveX选项都不是禁止状态，将禁止状态改为提示状态。2.2.4 Ocx开发包demo程序运行不起来DPSDK_OCX.ocx 未注册，可以采用一下两种方法注册：运行->CMD，regsvr32DPSDK OC

21、X.ocx绝对路径运行ocx开发包文件夹里面的reg.bat批处理，注意：DPSDK_OCX.ocx必须要和reg.bat放 在同一个路径。如果仍旧注册失败需要安装VS 发布包，vcredist_x86.exe，可以从微软官网上直接下载2.2.5 如何获通道 ID( CameraID )在浏览器输入DSS平台的ip打开web管理员端，用管理员身份登录平台,找到“基本设置”-“设备管理”-“编码器”页面的“编码”列是所有的设备ID。而CameralD 的格式 为:"设备ID$1$0$通道号",如设备ID为“1000000 ”，且设备下有3个视频通道，那么这 3个CameraI

22、D"1000000$1$0$0" 、 "1000000$1$0$1" 、 "1000000$1$0$2"。2.2.6是否可以不加载组织结构不调用DP SDK_LoadDGrou pinfo也是可以的，但仅限于实时视频、录像回放，其他操作，如操作云台等功能无法使用。方法是n RightGet_RealStream _Info_tDP SDK CORE NOT CHECK RIGHT 即可。2.2.7 OCX无法保存抓图或创建文件夹失败win7系统的安全控制导致OCX控件无法创建文件夹。需要使用admi ni strator 账号登陆wi

23、n7系统开发使用（有管理员权限的普通账户也不行）。2.2.8 OCX控件收不到报警1）需要先调用布控报警 DPSDK_EnableAlarm。2）其次平台或者设备触发报警。2.2.9 OCX请求视频没有声音需要打开音频(DPSDK_OpenAudioByWndNoDP SDK_ Open AudioByHWND )2210加载监控视频成功时浏览器会死掉浏览器兼容问题，目前OCX控件主要针对IE8/IE9环境。2.2.11 IE浏览器加载视频成功，其他浏览器无法加载浏览器兼容问题，其他基于IE内核或者多核模式的浏览器（遨游,360，搜狗浏览器等）需要选择兼容模式浏览。2.2.12 OCX操作导致

24、IE崩溃目前OCX中我们已经集成了在崩溃时生成 crash dump的功能，OCX崩溃时会弹出对话 框提示dum P生成的位置，用户只需在此位置下找到.dmp文件，然后将对应的pdb文件一同发送给我们即可。2.2.13目前OCX只支持ie8 32位浏览器在页面中加上 vmeta http-equiv="X-UA-Compatible"content="IE=EmulatelE8" />， 让IE浏览器以兼容IE8方式运行。2.2.14一路视频对应两路音频情况缺少音频通道标识DP SDK_OCX之前的开发包中已经提供了多音频通道的接口,获取音频通道数

25、/获取某个音频通道的状态DP SDK_GetAudioCha nn elsByWndNo /DP SDK_GetAudioCha nn elStateByWndNoDP SDK_SetAudioCha nn elByWndNo /打开某个音频通道界面上的按钮只是单纯的音频开关，客户如需切换声道，需要手动调用以上几个接口。无法定位海康录像2.2.15 DP SDK_Seek PlaybackBySeqByWndNo底层播放库不支持海康录像的定位操作，不过可以通过以下操作替代,以实现一个进度条为例:拖动进度条时，直接先关闭回放，再以进度条的当前时间重新按时间请求回放。此时由 于重新请求，DPSDK

26、_GetPIaybackPosByWndNo等接直接获口获取的 进度不 准确，改用DPSDK_GetFrameTimeByWndNo取帧时间，然后保存下最初的开始和结束时间，即可计算正确的进度。2216 DPSDK断线重连，不能打开视频中，当收到重连成功的设备在线，不一定需要重新加载组织结构（即在OnDevStatusEvent事件后，调用 DP SDK_LoadDGrou pInfo)。2.2.17 NVR设备状态和通道状态不同NVR的通道状态需要通过订阅才能实时返回通道状态。通道在线。OCX : ChannelStatusCallback2.2.18 YUV码流接口不支持海康设备Ext层的

27、YUV码流的相关接口，只支持大华设备。不支持海康设备。2.2.19接口返回某个错误码的含义1 ）接口返回1010错误是因为超时时间太短可以尝试增加接口超时时间，特别是广域网上操作。2）调用DPSDK_StartRealplayByWndNo返回3502，3600错误 未选中窗口或者窗口失去焦点。3 ）返回其它错误码我们开发文档里面有针对错误码的介绍。搜索一下错误码即可。2.3 DPSDK DLL版本问题汇总2.3.1 通道 ID( CameralD )介绍通道 ID (CameralD )形如：1000010$1$0$0 ，其中1) 1000010是设备ID，该设备ID可以在平台web管理员端

28、“基本配置-设备管理”页面的 “编码”列查询。2) $1代表的是单兀类型。1是编码单兀、2是解码单兀、3是报警输入单兀、4是报警输出 单元。实时视频都是$1。3) $0默认全写0，代表的是单元类型的序号。4) $0这个代表的是通道序号。从0开始计算。比如一个设备有8个通道，则通道序号是0- 如何获通道 ID (CameralD )1) DPSDK_DLL开发包中，有demo程序，demo程序中登录后，选择“分级加载组织结构”，即可看到组织和设备树。双击直到最后一层即为CameraId。demo我们提供了源码，你可以 根据源码进行开发，源码中涉及到的函数在开发文档中都有详细说明。2

29、)在浏览器中，用管理员身份登录平台，可以看到所有的设备ID。而编码器CameraID的格式为:"设备ID$1$0$通道号",如设备ID为“ 1000000 ”，且设备下有3个通道，那么这3个CameraID 为"1000000$1$0$0"、"1000000$1$0$1""1000000$1$0$2"。2.3.3 NVR设备状态和通道状态不同NVR的通道状态需要通过订阅才能实时返回通道状态。设备在线，不一定通道在线。dll : DPSDK_SetDPSDKNVRChnIStatusCallback2.3.4登录之后

30、打开视频返回rtsP建立失败如果是内外网环境，可能网络环境不正确。2.4 An droid SDK问题汇总2.5 IOS SDK问题汇总2.5.1点击实时预览崩溃可能是播放库太老，需要更新播放库。2.6其它 2.6.1设备通道ID (CameralD )如何获取?获取方式:方法1打开DPSDK对应的Demo，加载组织树，展开对应的组织节点,找到设备即可看到通道ID方法2.通道ID格式为：“设备ID $1$0$通道号”比如设备ID为1000001，对应第一 个视频通道ID为1000001$1$0$0，对应第二个视频通道为1000001$1$0$1 ，依次类推。设备ID可以从DSS管理员端“设备管

31、理”页面获取。在管理员模式下,使用system用户登陆进入：基本设置-> 设备管理查看设备ID。通道号：对于IPC设备，只有一个通道，通道号只有 0;对于DVR设备,有多个通道，具体的通道个数是在web管理员平台上配的，比如配了 4个通道，通道号依次为0,1,2,3。2.6.1模拟器实时预览花屏播放库对模拟器支持不全，实时和回放需要在真机上运行。2.6.2目前DPSDK不接受UI界面相关的定制开发，用户需要自己实现UI界面 263目前提供的DPSDK相关Demo只有C+版暂不提供研发2.6.4 DPSDK 二次开发邮箱 dh_dss_sdk 手机号码2.6.5现在只维护平台是3.0以后的

32、dpsdk2.X平台的dpsdk已经不再维护。2.6.6打开视频的接口有两种打开视频的接口:1）使用ext层，用户不需要关心码流，VaxPlayer库解析之。2）不使用ext层，设置码流回调函数，客户可以拿到码流。DP SDK_GetRealStream() p Dlg-> PostMessage(WM_MEDIADATA_CB,nSeq, 0)CWnd Player:O nMediaDataCallback(W PARAM wP aram, L PARAMlP aram)2.6.7按时间回放功能bug。1）按时间回放平台录像，由于平台存在问题，相关功能会出现不建议用户使用该功能。2）按时间回放设备录像没有问题。2.6.8平台回调上来的码流平台回调上来的码流是PS流+大华头。直接使用vaxPlayer播放。如果前端是海康设备回调上来的码流是大华头+海康流。需要使用 media Parser库去掉大华头在用vaxPlayer播放或者使用海康的播放库播放。269组织树xml中status字段不准确加载组织树以后可以拿到组织树xml，设备信息中的status字段无法正确显示设备的状 态。需要注册设备状态回调函数来实时获取设备的状态。接口： DP SDK_SetD PSDKDeviceStatusCallback（）初始化设置回调。在登陆平台的时候会