CCTV程序开发文档-基于海康设备网络SDK使用手册 V4.1.0

1、cctv程序开发文档基于海康设备网络sdk使用手册 v4.1.02012/1/17概述设备网络sdk是基于设备私有网络通信协议开发的，为后端设备（嵌入式网络硬盘录像机、视频服务器）、前端设备（网络摄像机、网络球机、ip模块）等产品服务的配套模块，用于远程访问和控制设备软件的二次开发。 适用于以下产品型号：1. ds-95xx、ds-96xxnvr； ds-90xx混合型硬盘录像机； 2. ds-91xx、ds-81xx、ds-80xx、ds-70xx、ds-71xx、ds-7116、ds-72xx硬盘录像机；3. ds-60xx、ds-61xx视频服务器、编/解码器；4. ids-6002hf

2、/b双摄像机跟踪、ids-6101hf智能设备（行为分析）、ids52xx智能分析仪、ids90xx、ids91xx；5. ds630x_d、ds-6401hd多路解码器；6. ip摄像机（以下简称“ipc”）：ds-2cd71xx、ds-2cd81xx、ds-2cd7xx、ds-2cd8xx、ds-2cd9xx；7. 其他ip设备：包含ip模块、ip快球等。由于某些功能在此sdk版本中做了扩展，同时设备程序也做了相应的更新扩展，为了方便下文说明，此处将以上设备归为两类：l 如ds-7116、ds-81xx、ds-90xx、ds-91xx、ds-95xx、ds-96xx等系列设备称为v3.0以

3、上版本支持的设备；l 如ds-80xx、ipc等设备称为v3.0以下版本支持的设备。设备网络sdk主要功能 序号功能备注1.图像预览2.文件回放和下载3.云台控制、布防/撤防4.语音对讲5.日志管理6.解码卡7.远程升级8.远程重启/关闭9.格式化硬盘10.参数配置（系统配置、通道配置、串口配置、报警配置、用户配置）11.多路解码器12.智能设备功能和获取设备能力集设备网络sdk包含网络通讯库、软解码库、硬解码库等功能组件，我们提供windows和linux两个版本的sdk，各自所包含的组件如下： windows下设备网络sdk： 网络通讯库hcnetsdk.h头文件hcnetsdk.lib

4、lib库文件hcnetsdk.dll dll库文件hpr库hpr.lib lib库文件hpr.dll dll库文件rtsp通讯库streamtransclient.dll dll库文件软解码库playm4.h头文件playctrl.lib lib库文件playctrl.dll dll库文件转封装库systemtransform.dll dll库文件硬解码库datatype.hdecodecardsdk.h头文件dssdk.lib lib库文件dssdk.dll dll库文件linux下设备网络sdk库： 网络通讯库hcnetsdk.h头文件libhcnetsdk.soso库文件hpr库libh

5、pr.soso库文件rtsp通讯库libstreamtransclient.soso库文件软解码库playsdkpu.h头文件libm4play.soso库文件转封装库libsystemtransform.soso库文件本版本的设备网络sdk开发包中包含以上各个组件，除网络通讯库和hpr库这两个组件为必须项外，用户可以根据需要选择其中的一部分组件，以下将对各个组件在sdk中的作用和使用条件分别说明。网络通讯库是设备网络sdk的主体，主要用于网络客户端与各类产品之间的通讯交互，负责远程功能调控、远程参数配置及码流数据的获取和处理等。 hpr库是网络通讯库的依赖库。 rtsp通讯库是支持rtsp传

6、输协议的网络库。当需要对支持rtsp协议的产品进行取流等操作时就必须加载该项组件。 软解码库主要用于对实时码流数据进行解码显示（实现预览功能）和对录像文件进行回放解码等。用户如果需要在sdk内部进行对实时流和录像码流播放显示时（即net_dvr_realplay_v30接口的第二个结构体参数的播放句柄设置成有效句柄时）必须加载该组件，而如果用户仅需要用网络通讯库捕获到数据后再外部自行处理就不需要加载该组件，这种情况下用户在外部自行解码将更灵活，可参见软解码库函数说明播放器sdk编程指南。 转封装库的功能可以分为两种：一种是将标准码流转换成采用我们公司封装格式的码流。当用户需要对支持rtsp协议

7、的产品捕获采用本公司封装格式的码流数据时（即当设置net_dvr_realplay_v30接口中的回调函数捕获数据或者调用net_dvr_setrealdatacallback接口捕获数据时）必须加载该组件。另一种功能是能将标准码流转换成其他格式的封装，如3gpp、ps等。例如，当用户需要对支持rtsp协议的产品实时捕获指定封装格式的码流数据（对应的sdk接口为net_dvr_saverealdata）时必须加载该项组件。 硬解码库需在配备硬解码卡（md卡）的前提下使用，通过解码卡的解码与输出功能实现实时流的解码显示及向监视器上矩阵输出的功能。用户如果需要在sdk内部对实时流码流播放显示时必须

8、加载该项组件。为更方便灵活地调用硬解码的相关功能，建议用户通过捕获数据在外部处理解码。相关硬解码库的功能函数可参见板卡sdk编程指南中解码卡api相关介绍。linux下无硬解功能。通用接口介绍接口功能支持的产品备注net_dvr_init初始化sdk全部net_dvr_cleanup释放sdk资源全部net_dvr_setconnecttime设置sdk网络连接超时时间和连接尝试次数全部net_dvr_setreconnect设置sdk重连功能全部net_dvr_getdvripbyresolvesvr通过解析服务器，获取设备的动态ip地址全部net_dvr_setdvrmessage注册接收

9、异常、重连等消息的窗口句柄全部net_dvr_setexceptioncallback_v30注册接收异常、重连等消息的窗口句柄或回调函数全部net_dvr_getsdkversion获取sdk的版本信息全部net_dvr_getsdkbuildversion获取sdk的版本号和build信息全部net_dvr_getsdkstate获取当前sdk的状态信息全部net_dvr_getsdkability获取当前sdk的功能信息全部net_dvr_setlogtofile启用sdk写日志文件全部net_dvr_getlasterror返回最后操作的错误码全部net_dvr_geterrormsg

10、返回最后操作的错误码信息全部net_dvr_login_v30注册全部net_dvr_logout_v30注销全部编程引导sdk主动注册模式sdk接口调用的主要流程其中虚线框的流程是可选部分，不会影响其他流程和模块的功能使用。按实现功能的不同可以分成十个模块，实现每个模块的功能时初始化sdk、用户注册设备、注销设备和释放sdk资源这4个流程是必不可少的。1) 初始化sdk（net_dvr_init）：对整个网络sdk系统的初始化，内存预分配等操作。2) 设置连接超时时间（net_dvr_setconnecttime）：这部分为可选，用于设置sdk中的网络连接超时时间，用户可以根据自己的需要设置

11、该值。在不调用此接口设置超时时间的情况下，将采用sdk中的默认值。 3) 设置接收异常消息的回调函数（net_dvr_setdvrmessage或net_dvr_setexceptioncallback_v30）：由于sdk中大部分模块的功能都是由异步模式实现，所以我们提供此接口用于接收预览、报警、回放、透明通道和语音对讲等模块发生异常信息。用户可以在初始化sdk后就设置该回调函数，在应用层对各个模块异常消息的接收和处理。 4) 从解析服务器获得设备的ip地址（net_dvr_getdvripbyresolvesvr）：该接口提供一种在仅知道设备名称和序列号的情况下，从解析服务器获得设备ip地

12、址的方法。如：当前设备是通过拨号上网方式获取到动态ip地址，而运行了我公司ipserver软件的服务器即为解析服务器，我们可以通过此接口输入解析服务器的地址、设备的名称和序列号等信息查询该设备的ip地址。ipserver是我公司提供的一款域名解析服务器软件。 5) 用户注册设备（net_dvr_login_v30）：实现用户的注册功能，注册成功后，返回的用户id作为其他功能操作的唯一标识，sdk允许最大注册用户数为512个。就设备而言，v3.0以上版本支持的设备允许有32个注册用户名，而且同时最多允许128个用户注册；v3.0以下版本支持的设备允许有16个注册用户名，而且同时最多允许128个用

13、户注册。6) 预览模块：从前端服务器取实时码流，解码显示以及播放控制等功能，同时支持软解码和解码卡解码。具体流程详见预览模块流程。7) 回放和下载模块：可以通过按时间和按文件名的方式远程回放或者下载前端服务器的录像文件，后续可以进行解码或者存储。同时还支持断点续传功能。具体流程详见回放和下载模块流程。8) 参数配置模块：设置和获取前端服务器的参数，主要包括设备参数、网络参数、通道压缩参数、串口参数、报警参数、异常参数、交易信息和用户配置等参数信息。具体流程详见参数配置模块流程。9) 远程设备维护模块：实现关闭设备、重启设备、恢复默认值、远程硬盘格式化、远程升级和配置文件导入/导出等维护工作。具

14、体流程详见远程设备维护模块流程。10) 语音对讲转发模块：实现和前端服务器的语音数据对讲和语音数据获取，音频编码格式可以指定。具体流程详见语音对讲转发模块流程。11) 报警模块：处理前端服务器上传的各种报警信号。报警分为“布防”和“监听”两种方式，在采用监听方式并且不需要获取用户id的情况下，报警模块可以无需进行“用户注册”操作步骤。具体流程详见报警模块流程。12) 透明通道模块：透明通道是将ip数据报文解析后直接发送到串行口的一种技术。实际上起到了延伸串行设备控制距离的作用。可利用ip网络控制多种串行设备，如控制解码器、矩阵、报警主机、门禁、仪器仪表等串行设备，对用户来说，只看到点对点传输，

15、无须关心网络传输过程，所以称为串口透明通道。 sdk提供485和232串口作为透明通道功能，其中要将232串口作为透明通道使用，首先必须在232串口的配置信息（net_dvr_rs232cfg）中将工作模式选为透明通道，这样232串口才可作为透明通道使用。具体流程详见透明通道模块流程。 13) 云台控制模块：实现对云台的基本操作、预置点、巡航、轨迹和透明云台的控制。sdk将云台控制分为两种模式：一种是通过图像预览返回的句柄进行控制；另一种是无预览限制，通过用户注册id号进行云台控制。 14) 解码器功能模块：实现解码器设备的配置、解码控制等功能。sdk支持单路解码器和多路解码器，但目前以多路解

16、码器为主流产品。具体流程详见多路解码器功能模块流程。 15) 智能行为分析功能模块：实现对智能产品的参数配置、报警上传和能力集获取等功能。具体流程详见智能行为分析功能模块流程。 注：本手册下文提供的代码都是在vc环境下编译的，其他语言版本的demo可在我们提供的多语言版本demo资源中找到。预览模块流程l 实时预览支持tcp、udp、rtp、multicast网络传输模式。 l 实时预览时，ds-80xx、ds-70xx、ds-71xx、ds-72xx、 ds-60xx、ds-61xx系列设备每个通道最多支持6路同时连接，每台设备最多支持24路同时连接；ds-81xx、ds-71xxhv、72

17、xxhv等系列设备每个通道最多支持6路同时连接，每台设备最多支持18路同时连接；ds-90xx混合型硬盘录像机每个通道最多支持6路同时连接，每台设备最多支持64路同时连接；ds-91xx系列设备每个通道最多支持6路同时连接，每台设备最多支持64路同时连接；ip设备每个通道最多支持6路同时连接；ds-91xx-st系列通道连接数没有限制，每台设备最多支持128路同时连接。 预览和与预览相关的模块流程图图中虚线框部分的模块是与预览模块相关，必须在启动预览后才能调用，这些模块之间是并列的关系，各自完成相应的功能。l 声音控制功能主要实现独占、共享声音的打开和关闭；音量的控制。相关接口有：net_dv

18、r_opensound、net_dvr_closesound、net_dvr_opensoundshare、net_dvr_closesoundshare、net_dvr_volume等。l 实时流数据捕获和录像模块主要实现数据回调和本地录像的功能，可以供用户后续处理。相关接口有：net_dvr_setrealdatacallback、net_dvr_setstandarddatacallback、net_dvr_saverealdata等。l 抓图功能主要实现对当前解码图像的捕获，保存格式为bmp。相关接口有：net_dvr_capturepicture。l 云台控制模块主要是在开启预览的前

19、提下实现对云台控制的操作功能，包括云台预置点、巡航、轨迹和透明云台等。相关接口有：net_dvr_ptzcontrol、net_dvr_ptzcontrol_ex、net_dvr_ptzpreset、net_dvr_ptzpreset_ex、net_dvr_ptzcruise、net_dvr_ptzcruise_ex、net_dvr_ptztrack、net_dvr_ptztrack_ex、net_dvr_transptz、net_dvr_transptz_ex。实时流解码方式l 方式一：在预览接口net_dvr_realplay_v30中预览参数的播放窗口句柄赋成有效句柄，则由sdk实现解码

20、功能。在初始化sdk和注册设备两步骤后，直接调用启动预览和停止预览接口。l 方式二：用户可以通过设置预览接口net_dvr_realplay_v30中预览参数的播放窗口句柄为空值，并通过调用捕获数据的接口（即设置net_dvr_realplay_v30接口中的回调函数或调用net_dvr_setrealdatacallback、net_dvr_setstandarddatacallback接口），获取码流数据进行后续解码播放处理。下面示例代码以设置net_dvr_realplay_v30()接口中的回调为例进行说明。 示例代码方式一(由sdk实现解码显示) #include #include

21、#include windows.h#include hcnetsdk.h#include using namespace std;void callback g_exceptioncallback(dword dwtype, long luserid, long lhandle, void *puser) char tempbuf256 = 0; switch(dwtype) case exception_reconnect: /预览时重连 printf(-reconnect-%dn, time(null); break;default: break; void main() /- / 初始

22、化 net_dvr_init(); /设置连接时间与重连时间 net_dvr_setconnecttime(2000, 1); net_dvr_setreconnect(10000, true); /- / 注册设备 long luserid; net_dvr_deviceinfo_v30 strudeviceinfo; luserid = net_dvr_login_v30(192.0.0.64, 8000, admin, 12345, &strudeviceinfo); if (luserid 0) printf(login error, %dn, net_dvr_getlasterror

23、(); net_dvr_cleanup(); return; /- /设置异常消息回调函数 net_dvr_setexceptioncallback_v30(0, null,g_exceptioncallback, null); /- /启动预览并设置回调数据流 long lrealplayhandle; hwnd hwnd = getconsolewindow(); /获取窗口句柄 net_dvr_clientinfo clientinfo = 0; clientinfo.hplaywnd = hwnd; /需要sdk解码时句柄设为有效值，仅取流不解码时可设为空 clientinfo.lch

24、annel = 1; /预览通道号 clientinfo.llinkmode = 0; /最高位(31)为0表示主码流，为1表示子码流030位表示连接方式：0tcp方式；1udp方式；2多播方式；3rtp方式; clientinfo.smulticastip = null; /多播地址，需要多播预览时配置 bool bpreviewblock = false; /请求码流过程是否阻塞，0：否，1：是 lrealplayhandle = net_dvr_realplay_v30(luserid, &clientinfo, null, null, 0); if (lrealplayhandle 0

25、) printf(net_dvr_realplay_v30 errorn); net_dvr_logout(luserid); net_dvr_cleanup(); return; /- /关闭预览 net_dvr_stoprealplay(lrealplayhandle); /注销用户 net_dvr_logout(luserid); /释放sdk资源 net_dvr_cleanup(); return;方式二（由用户自行处理回调得到的码流数据，此处以软解显示为例，代码中带有playm4_的函数参见软解码库说明文档播放器sdk编程指南）#include #include #include w

26、indows.h#include hcnetsdk.h#include plaympeg4.h#include using namespace std;long lport; /全局的播放库port号void callback g_realdatacallback_v30(long lrealhandle, dword dwdatatype, byte *pbuffer,dword dwbufsize,void* dwuser) hwnd hwnd=getconsolewindow();switch (dwdatatype)case net_dvr_syshead: /系统头if (!play

27、m4_getport(&lport) /获取播放库未使用的通道号break;/m_iport = lport; /第一次回调的是系统头，将获取的播放库port号赋值给全局port，下次回调数据时即使用此port号播放if (dwbufsize 0)if (!playm4_setstreamopenmode(lport, streame_realtime) /设置实时流播放模式break;if (!playm4_openstream(lport, pbuffer, dwbufsize, 1024*1024) /打开流接口break;if (!playm4_play(lport, hwnd) /播

28、放开始break;case net_dvr_streamdata: /码流数据if (dwbufsize 0 & lport != -1)if (!playm4_inputdata(lport, pbuffer, dwbufsize)break; void callback g_exceptioncallback(dword dwtype, long luserid, long lhandle, void *puser) char tempbuf256 = 0; switch(dwtype) case exception_reconnect: /预览时重连 printf(-reconnect-

29、%dn, time(null); break;default: break; void main() /- / 初始化 net_dvr_init(); /设置连接时间与重连时间 net_dvr_setconnecttime(2000, 1); net_dvr_setreconnect(10000, true); /- / 注册设备 long luserid; net_dvr_deviceinfo_v30 strudeviceinfo; luserid = net_dvr_login_v30(172.0.0.100, 8000, admin, 12345, &strudeviceinfo); i

30、f (luserid 0) printf(login error, %dn, net_dvr_getlasterror(); net_dvr_cleanup(); return; /- /设置异常消息回调函数 net_dvr_setexceptioncallback_v30(0, null,g_exceptioncallback, null); /- /启动预览并设置回调数据流 long lrealplayhandle; net_dvr_clientinfo clientinfo = 0; clientinfo.hplaywnd = null; /需要sdk解码时句柄设为有效值，仅取流不解码时

31、可设为空 clientinfo.lchannel = 1; /预览通道号 clientinfo.llinkmode = 0; /最高位(31)为0表示主码流，为1表示子码流030位表示连接方式：0tcp方式；1udp方式；2多播方式；3rtp方式; clientinfo.smulticastip = null; /多播地址，需要多播预览时配置 bool bpreviewblock = false; /请求码流过程是否阻塞，0：否，1：是 lrealplayhandle = net_dvr_realplay_v30(luserid, &clientinfo, g_realdatacallback

32、_v30, null, 0); if (lrealplayhandle 0) printf(net_dvr_realplay_v30 errorn); net_dvr_logout(luserid); net_dvr_cleanup(); return; /- /关闭预览 net_dvr_stoprealplay(lrealplayhandle); /注销用户 net_dvr_logout_v30(luserid); net_dvr_cleanup(); return;回放和下载模块流程l 按文件回放或下载需要通过查找录像文件功能先获取文件信息（相关接口net_dvr_findfile_v30

33、、net_dvr_findnextfile_v30），然后根据获取到的文件名开始回放或下载（相关接口net_dvr_playbackbyname、net_dvr_getfilebyname），特别提醒在调用了回放或下载的接口后，还必须调用控制接口（net_dvr_playbackcontrol）的开始播放命令（net_dvr_playstart）。l 按时间回放或下载文件时，用户可以无需调用查找录像文件的相关接口，只要在接口中指定开始和结束时间，调用回放或下载接口（相关接口net_dvr_playbackbytime、net_dvr_getfilebytime）后，还必须调用控制接口（net_

34、dvr_playbackcontrol）的开始播放命令（net_dvr_playstart）。此时，将按照指定时间范围内最近的有录像的时间段开始回放或下载。用户也可以通过调用查找录像文件的相关接口，获取文件的开始和结束时间后，按这个时间范围指定回放或下载接口中的时间参数，最后还必须调用控制接口（net_dvr_playbackcontrol）的开始播放命令（net_dvr_playstart）。l linux下，按文件回放和按时间回放时，若回放的窗口句柄不为null（即需要sdk解码显示），需要调用初始化窗口接口（net_dvr_drawareainit）进行sdl窗口的初始化才能正常的解码显

35、示，在停止回放时，需要调用释放窗口资源接口（net_dvr_drawarearelease）释放窗口资源。 示例代码示例一：查找录像文件并下载#include #include #include windows.h#include hcnetsdk.husing namespace std;int saverecordfile(int userid,char * srcfile,char * destfile) int bres = 1; int hplayback = 0; if( (hplayback = net_dvr_getfilebyname(userid, srcfile, des

36、tfile) 0 ) printf( getfilebyname failed. error%dn, net_dvr_getlasterror(); bres= -1; return bres; if(!net_dvr_playbackcontrol(hplayback, net_dvr_playstart, 0, null) printf(play back control failed %dn,net_dvr_getlasterror(); bres=-1; return bres; int npos = 0; for(npos = 0; npos =0; npos = net_dvr_g

37、etdownloadpos(hplayback) sleep(5000); /millisecond printf(have got %dn, npos); if(!net_dvr_stopgetfile(hplayback) printf(failed to stop get file %dn,net_dvr_getlasterror(); bres = -1; return bres; printf(%sn,srcfile); if(npos100) printf(download err %dn,net_dvr_getlasterror(); bres=-1; return bres;

38、else return 0; void main() /- / 初始化 net_dvr_init(); /设置连接时间与重连时间 net_dvr_setconnecttime(2000, 1); net_dvr_setreconnect(10000, true); /- / 注册设备 long luserid; net_dvr_deviceinfo_v30 strudeviceinfo; luserid = net_dvr_login_v30(192.0.0.64, 8000, admin, 12345, &strudeviceinfo); if (luserid 0) printf(logi

39、n error, %dn, net_dvr_getlasterror(); net_dvr_cleanup(); return; net_dvr_filecond strufilecond; strufilecond.dwfiletype = 0xff; strufilecond.lchannel = 1; strufilecond.dwislocked = 0xff; strufilecond.dwusecardno = 0; strufilecond.strustarttime.dwyear = 2011; strufilecond.strustarttime.dwmonth = 3; s

40、trufilecond.strustarttime.dwday = 1; strufilecond.strustarttime.dwhour = 10; strufilecond.strustarttime.dwminute = 6; strufilecond.strustarttime.dwsecond =50; strufilecond.strustoptime.dwyear = 2011; strufilecond.strustoptime.dwmonth = 3; strufilecond.strustoptime.dwday = 1; strufilecond.strustoptim

41、e.dwhour = 11; strufilecond.strustoptime.dwminute = 7; strufilecond.strustoptime.dwsecond = 0; /- /查找录像文件 int lfindhandle = net_dvr_findfile_v30(luserid, &strufilecond); if(lfindhandle 0) net_dvr_findclose_v30(lfindhandle); /注销用户 net_dvr_logout(luserid); /释放sdk资源 net_dvr_cleanup(); return;示例二：按时间播放录

42、像文件#include #include #include windows.h#include hcnetsdk.husing namespace std;void main() /- / 初始化 net_dvr_init(); /设置连接时间与重连时间 net_dvr_setconnecttime(2000, 1); net_dvr_setreconnect(10000, true); /- / 注册设备 long luserid; net_dvr_deviceinfo_v30 strudeviceinfo; luserid = net_dvr_login_v30(192.0.0.64, 8

43、000, admin, 12345, &strudeviceinfo); if (luserid 0) printf(login error, %dn, net_dvr_getlasterror(); net_dvr_cleanup(); return; net_dvr_time strustarttime, strustoptime; strustarttime.dwyear = 2011; strustarttime.dwmonth = 3; strustarttime.dwday = 1; strustarttime.dwhour = 9; strustarttime.dwminute

44、= 0; strustarttime.dwsecond =0; strustoptime.dwyear = 2011; strustoptime.dwmonth = 3; strustoptime.dwday = 1; strustoptime.dwhour = 10; strustoptime.dwminute = 7; strustoptime.dwsecond = 0; hwnd hwnd = getconsolewindow(); /获取窗口句柄 /- /按时间回放 int hplayback; hplayback = net_dvr_playbackbytime(luserid, 1

45、, &strustarttime, &strustoptime, hwnd); if(hplayback 0) printf(net_dvr_getfilebytime fail,last error %dn,net_dvr_getlasterror(); net_dvr_logout(luserid); net_dvr_cleanup(); return; /- /开始 if(!net_dvr_playbackcontrol(hplayback, net_dvr_playstart, 0, null) printf(play back control failed %dn,net_dvr_getlasterror(); net_dvr_logout(luserid); net_dvr_cleanup(); return; sleep(15000); /millisecond if(!net_dvr_stopplayback(hplayback) printf(failed to stop file %dn,net_dvr_getlasterror(); net_dvr_logout(luserid); net_dvr_cleanup(); return; /注销用户 net_dvr_logout(luserid);