设为首页收藏本站
开启辅助访问

海康威视SDK使用总结

 您所在的位置：网站首页 › 海康威视视频监控管理平台怎么用 › 海康威视SDK使用总结

海康威视SDK使用总结

2024-07-03 20:37| 来源: 网络整理| 查看: 265

海康威视SDK使用总结

公司的项目里使用到海康威视的摄像监控设备，然后项目要求在我们的B/S系统中集成摄像头的播放画面。因此通过和海康威视工作人员的沟通，和网上一些人的文章，实现了在自己的网页里进行预览和回放。

一、海康威视的SDK

海康威视的视频监控设备有网络摄像头、网络硬盘录像机（NVR）等。这些设备都自带一个小系统，可以通过在浏览器上输入设备的IP进行监控画面的查看和设备信息的修改。

如图所示。

海康摄像头播放页面

其实海康的网络摄像头自带的功能还是挺多的，但是就是当对很多网络摄像头进行批量管理的时候有些不方便，而且不符合项目要求因此还是得按照自己的需求自己来开发。

NVR最主要的功能是通过网络接收IPC（网络摄像机）设备传输的数字视频码流， 并进行存储、管理，从而实现网络化带来的分布式架构优势。 简单来说，通过Nvr，可以同时观看、浏览、回放、管理、存储多个网络摄像机。摆脱了电脑硬件的牵绊，再也不用面临安装软件的繁琐。如果所有摄像机网络化，那么必经之路就是有一个集中管理核心出现。http://http://www.elecfans.com/baike/yuyinshipin/anfangjiankong/20180102609985.html

NVR具有16/32/64路通道，也就是最多支持64路视频音频信号的接入。我们将摄像头通过网线和NVR的相连，就可以在NVR中通过添加设备的方式将该摄像头作为NVR的一个信号输入，该设备将会占用一个通道。至此我们只要通过NVR就可以实现对该摄像头的监控画面预览了。网络摄像头输出的是模拟信号，NVR将摄像头的模拟信号转换为数字信号。

此时通过浏览器输入NVR的IP进入NVR的系统，可以看到预览页和回放页都有设备列表，选中设备可以进行预览或者回放。在回放页面多了日历，有绿色标记的表示当天有视频信息的存储，可以进行播放。

为帮助客户实现定制化的监控视频实时预览功能的集成，海康威视提供了两种SDK分别用于C/S架构和B/S架构的开发。

1 C/S架构的SDK

海康威视在官网【下载】->【SDK开发】里提供了用于C/S架构的SDK，我下载的是“设备网络SDK_Win64”。下载页上这样说到：

设备网络SDK是基于设备私有网络通信协议开发的，为后端设备（嵌入式网络硬盘录像机、视频服务器）、前端设备（网络摄像机、网络球机、IP模块）等产品服务的配套模块，用于远程访问和控制设备软件的二次开发。

在解压好的文件夹中，库文件存放的是海康封装好的库文件，这些被Import（外部引入）到项目中，是SDK运行的条件，如果没有引入这些文件那么Demo程序中的SDK文件将引发错误。详情请参考SDK中的《HCNetSDKCom文件夹必须加载到工程.txt》

设备网络SDK_Win64

1.1 SDK的使用

包里有MFC、Java和C#的Demo。我用的是C#，这里就C#做一下介绍和总结。

Demo

1、是直接登录摄像头进行直接预览。 2、登录CVR、NVR，对此中的输入信号进行预览等

NVR设备预览界面

……

其他的功能就自己看一下代码吧，如果对属性或者作用不清晰的，可以对照开发文档和SDK使用手册，里面有说明。 SDK的基本使用方法是： 1、“CHCNetSDK.cs”。海康威视提供了一个静态类“CHCNetSDK.cs”，里面包含了针对各种设备的各种方法，以及各种适用于不同方法的数据结构体和属性。 2、在Winform后台代码中的使用方法（部分代码，只供解读） `

private uint iLastErr = 0; //错误代码 private Int32 m_lUserID = -1;//登录句柄 private bool m_bInitSDK = false;//sdk初始化结果 private bool m_bRecord = false;//是否录像 private Int32 m_lRealHandle = -1;//预览句柄 m_bInitSDK = CHCNetSDK.NET_DVR_Init();// 1初始化 m_lUserID = CHCNetSDK.NET_DVR_Login_V30(DVRIPAddress, DVRPortNumber, DVRUserName, DVRPassword, ref DeviceInfo); // 2登录设备 Login the device。登录前如要先定义参数。 其中DeviceInfo为引用传递。这样在Login方法中就把设备的信息获取出来并赋值给了DeviceInfo，包含的信息参考NET_DVR_DEVICEINFO_V30结构体；如果登录成功会返回一个大于零的值，否则返回-1。 if(m_lUserID < 0) //未登录 { MessageBox.Show("Please login the device firstly"); return; } if (m_lRealHandle < 0) //初始为-1，表示未预览 { CHCNetSDK.NET_DVR_PREVIEWINFO lpPreviewInfo = new CHCNetSDK.NET_DVR_PREVIEWINFO(); lpPreviewInfo.hPlayWnd = RealPlayWnd.Handle;//预览窗口 lpPreviewInfo.lChannel = Int16.Parse(textBoxChannel.Text);//预te览的设备通道 lpPreviewInfo.dwStreamType = 0;//码流类型：0-主码流，1-子码流，2-码流3，3-码流4，以此类推 lpPreviewInfo.dwLinkMode = 0;//连接方式：0- TCP方式，1- UDP方式，2- 多播方式，3- RTP方式，4-RTP/RTSP，5-RSTP/HTTP lpPreviewInfo.bBlocked = true; //0- 非阻塞取流，1- 阻塞取流 lpPreviewInfo.dwDisplayBufNum = 15; //播放库播放缓冲区最大缓冲帧数 CHCNetSDK.REALDATACALLBACK RealData = new CHCNetSDK.REALDATACALLBACK(RealDataCallBack);//预览实时流回调函数 IntPtr pUser = new IntPtr();//用户数据 //打开预览 Start live view m_lRealHandle = CHCNetSDK.NET_DVR_RealPlay_V40(m_lUserID, ref lpPreviewInfo, null/*RealData*/, pUser); if (m_lRealHandle < 0) { iLastErr = CHCNetSDK.NET_DVR_GetLastError(); str = "NET_DVR_RealPlay_V40 failed, error code= " + iLastErr; //预览失败，输出错误号 MessageBox.Show(str); return; } else { //预览成功 btnPreview.Text = "Stop Live View"; } } else { //停止预览 Stop live view if (!CHCNetSDK.NET_DVR_StopRealPlay(m_lRealHandle)) { iLastErr = CHCNetSDK.NET_DVR_GetLastError(); str = "NET_DVR_StopRealPlay failed, error code= " + iLastErr; MessageBox.Show(str); return; } m_lRealHandle = -1; btnPreview.Text = "Live View"; } return; }

` 代码中方法“NET_DVR_RealPlay_V40”是海康摄像头进行实时预览的方法，支持多码流播放。海康提供了这个方法调用，而我们使用时只需要定义好播放参数就行，如在哪个窗口播放

lpPreviewInfo.hPlayWnd = RealPlayWnd.Handle;//预览窗口 live view window

基本上就是上面的一个逻辑。挺简单的。但是针对不同的设备可能方法有不同，可以参照开发文档和SDK使用手册多搜索一下。比如，我在获取NVR的硬盘使用空间时就花了很长时间去找调用的方法。

//WorkStates是我自己定义的一个结构体，用来方便的获取我想要的结果。 WorkStates workStates = new WorkStates() { totalUsedSpace = 0, totalSpace = 0, HardDiskStatic = 0, AlarmOutStatic = 0, DeviceStatic = 0, iErrCode = 0, iLastErrStr = string.Empty }; var result = new CHCNetSDK.NET_DVR_WORKSTATE(); CHCNetSDK.NET_DVR_DISKSTATE[] struHardDiskStatic = new CHCNetSDK.NET_DVR_DISKSTATE[33]; if (!CHCNetSDK.NET_DVR_GetDVRWorkState(m_lUserID, ref result)) { iLastErr = CHCNetSDK.NET_DVR_GetLastError(); workStates.iErrCode = iLastErr; workStates.iLastErrStr = FetchDescription((GlobalErrorCode)iLastErr); return workStates; } 1.2 SDK在项目中的应用

C/S 架构SDk的使用主要用来做一下工作：

系统检测到异常时调用摄像头进行拍照定期查询NVR设备的硬盘存储空间，以确保视频文件的存储。

经过分析，上述两个需求要采用了后台服务的方式来实现。

但是海康的SDk适用于Winform控件，写WCF服务的时候，由于那些外部dll引用的原因导致无法直接进行调用，因此我们对海康控件进行了一次封装，生成了一个dll。我们在dll中用一个用户winform控件来代替winform窗体，来调用海康的各种方法。然后再项目中，搭建了一个线程服务，同事引用这个dll并进行调用。实现了定时获取NVR的硬盘存储空间的功能。

public class NVRSpaceMonitorFactory { public static void Start() { try { List nvrList = NVR.FindAllEnabled(); //这里NVR、Alarm都是项目中的一个EF实体， if (nvrList != null && nvrList.Count > 0) { UCHKVideo ucVideo = new UCHKVideo(); foreach (NVR nvr in nvrList) { int nvrid = nvr.ID; Alarm alarm = new Alarm() { DeviceID = nvr.ID, BusinessType = 8 }; UCHKVideo.LoginState loginResult = ucVideo.NVRLogin(nvr.IPAddress, nvr.ClientPort.ToString(), nvr.UserName, nvr.Password); if (loginResult.bInitSDK != -1) //插件登陆失败 { UCHKVideo.WorkStates result = ucVideo.GetNVRWorkState(); ucVideo.LogOut(); if (result.iErrCode == 0) //result.totalSpace!=0表示获取成功 { NVRSpaceHistory nvrSpaceRecord = new NVRSpaceHistory(); nvrSpaceRecord.NVRID = nvrid; nvrSpaceRecord.UsedSpace = result.totalUsedSpace; nvrSpaceRecord.UpdateTime = DateTime.Now; nvrSpaceRecord.Insert(); // if (nvr.TotalSpace != result.totalSpace) { nvr.IsEnable = true; //不设定true 就会被false掉，暂时处理 nvr.UsedSpace = result.totalUsedSpace; nvr.TotalSpace = result.totalSpace; nvr.AlarmOutStatic = (int)result.AlarmOutStatic; nvr.DeviceStatic = (int)result.DeviceStatic; nvr.HardDiskStatic = (int)result.HardDiskStatic; nvr.Update(); //将信息写入数据库报警表中（来自系统的报警） IP、名称、报警信息 List alarmRuleList = V_Alarm_Rule.FindAllBySubSystemName("视频监控"); if (alarmRuleList != null && alarmRuleList.Count > 0) { foreach (V_Alarm_Rule ar in alarmRuleList) { double thresholdValue = 0; double.TryParse(ar.Value, out thresholdValue); if (!string.IsNullOrEmpty(ar.AlarmCondition) && thresholdValue != 0) { int compareResult = (nvr.UsedSpace / nvr.TotalSpace).CompareTo((decimal)thresholdValue); var comperaResultEnum = (CompareResult)compareResult; var comperaResultStr = UCHKVideo.FetchDescription(comperaResultEnum); if (ar.AlarmCondition.Contains(comperaResultStr)) { alarm.Content = "NVR硬盘存储空间已不足" + (thresholdValue * 100).ToString() + "%"; alarm.AlarmTime = DateTime.Now; alarm.Insert(); } } } } } } else { //如果获取失败，将信息写入数据库报警表中（来自系统的报警）IP、名称、报警信息 Log4netHelper.Error(nvr.Name + "_" + nvr.IPAddress + "_" + result.iLastErrStr); //测试 alarm.Content = result.iLastErrStr; alarm.AlarmTime = DateTime.Now; alarm.Insert(); } } else { //如果登陆失败，将信息写入数据库报警表中（来自NVR的报警）IP、名称、报警信息 Log4netHelper.Error(nvr.Name+"_"+nvr.IPAddress+"_"+ loginResult.iLastErrStr); //测试 alarm.Content = loginResult.iLastErrStr; alarm.AlarmTime = DateTime.Now; alarm.Insert(); } } } } catch (Exception ex) { Log4netHelper.Error(ex.Message); } } }

关于后台的服务，我将在后面进行一个专门的总结，敬请期待。总之，海康的C#的SDK挺简单的。参照SDK和开发文档就能实现自己要的功能。容易有坑的地方是 一些方法的参数实例化。因为不知道参数如何设定，总会导致调用方法时出现异常，需要多了解跟这个方法相关的信息。

下面是一个使用MFC的实例。

海康威视网络摄像头SDK中Demo的二次开发（运行） - 土豪gold的博客 - CSDN博客https://blog.csdn.net/qq_15029743/article/details/79733960

B/S架构的SDK

浏览器实时预览摄像头画面的方法有好几种。

可以参考下面这篇博文吧（只是为了让文章显得完整 才加上）。

采集rtsp流摄像头到浏览器实时播放方案 - 书写人生 - CSDN博客 https://blog.csdn.net/yelin042/article/details/78134113/

我们在项目中做的就是在WEB系统中集成海康威视的实时预览和回放，因此在通过对海康设备的一番度娘研究之后，发现海康有JS语言的SDK，经过咨询，海康威视的技术人员提供了这份SDK。

海康威视JS语言的SDK

doc文件夹里放了SDK说明文档。建议先了解一下SDK的文档。 Demo里放的是实例。webVideoCtrl.js是海康威视的插件WebComponentsKit.exe控制硬件设备的API demo.js里面是封装了的方法，引入这个文件，就可以直接使用了。海康威视的API功能还是挺全的，就是需要安装插件。安装了插件就意味着需要使用IE的浏览器（Trident内核）。这个很不爽。Chrome认为插件不安全，已经全面停止了插件的安装，因此无法使用Chrome浏览器预览实时画面。 海康摄像头通过登录IP 就可以在Chrome上进行预览。我觉得这应该是采用了视频流转换。但我还没研究这种方法。

实例画面

整个api的调用顺序如下图所示。

函数调用顺序

var iRet = WebVideoCtrl.I_CheckPluginInstall();// 1 检查是否安装 // 2、初始化插件参数及插入插件。我在里面放入了一个返回结果，在调用的时候做一个判断 function clickInitPlugin(iWndowType, divPlugin) { var isSuccess = false; //用来返回的结果 WebVideoCtrl.I_InitPlugin("100%", "100%", { bWndFull: true, // 是否支持单窗口双击全屏，默认支持 true:支持 false:不支持 iPackageType: 2, // 2:PS 11:MP4 iWndowType: iWndowType, bNoPlugin: true, cbSelWnd: function (xmlDoc) { …… }, cbDoubleClickWnd: function (iWndIndex, bFullScreen) { …… }, cbEvent: function (iEventType, iParam1, iParam2) { …… }, cbRemoteConfig: function () { …… }, cbInitPluginComplete: function () { WebVideoCtrl.I_InsertOBJECTPlugin(divPlugin); // 检查插件是否最新 if (-1 == WebVideoCtrl.I_CheckPluginVersion()) { alert("检测到新的播放器版本，请安装最新的WebComponentsKit.exe升级！"); return isSuccess; } isSuccess = true; } }); return isSuccess; } ///3、登录 var iRet = WebVideoCtrl.I_Login(szIP, 1, szPort, szUsername, szPassword, { success: function (xmlDoc) { showOPInfo(szDeviceIdentify + " 登录成功！"); $("#ip").prepend("" + szDeviceIdentify + ""); setTimeout(function () { $("#ip").val(szDeviceIdentify); getChannelInfo();//获取通道 getDevicePort();//获取端口 }, 10); }, error: function (status, xmlDoc) { showOPInfo(szDeviceIdentify + " 登录失败！", status, xmlDoc); } }); // 4 按IP、端口号预览 function clickStartRealPlay(szIP, szPort, iChannelID) { var oWndInfo = WebVideoCtrl.I_GetWindowStatus(g_iWndIndex), szDeviceIdentify = szIP, iRtspPort = szPort, bZeroChannel = false, szInfo = "", iStreamType = 1;// 主码流 if ("undefined" === typeof iStreamType) { iStreamType = parseInt($("#streamtype").val(), 10); } var startRealPlay = function () { WebVideoCtrl.I_StartRealPlay(szDeviceIdentify, { iRtspPort: iRtspPort, iStreamType: iStreamType, iChannelID: iChannelID, bZeroChannel: bZeroChannel, success: function () { …… }, error: function (status, xmlDoc) { …… } }); }; if (oWndInfo != null) {// 已经在播放了，恢复；这个地方可以自己控制逻辑。如果正在播放就停止该播放窗口再播放。 WebVideoCtrl.I_Stop({ success: function () { startRealPlay(); } }); } else { startRealPlay(); } } }

其他的方法可以多看看说明文档和实例Demo。 我做的最终效果。可以实现预览和回放。回放的日历是仿造海康的系统写的，会默认查询最近一个月内是否有视频数据，如果有就标记绿色三角。 预览 回放 说几点js语言的sdk问题：

因为要装XActive插件，因此初始化后的播放器窗口的ZIndex最高。浏览器上的任何控件都会在它下面。是版本问题。一个webVideoCtrl.js里面都有一个版本号，必须和WebComponentsKit插件保持同一个版本。目前海康没有提供最新版本的api。同一个页面只能初始化一个播放器页面。因此如果在原页面上有播放窗口，那么就不能通过模态框能方法再初始化一次。模态框的特性就是和原页面公用一个页面。安全问题。目前很多监控画面都在装在保卫科的局域网中，只有保卫科才能看得到视频数据。视频播放功能集成到Web系统后，实现了远程监控、随时可查。现在如果接入了这个系统接入了保卫科的安防系统，如果不足够重视安全，一些人就可以借助缓存、窃取密码等方式查看视频画面。在方法调用的时候，可以把检查是否安装插件、是否初始化等方法进行一次封装，通过true/false的方法可以优化代码调用时的代码精简。另外，当调用login等方法时，不能成功登录的话 需要较长的时间才能得到“失败”的消息回传。应该做一个“正在xx请等待”的遮罩，提升用户体验。 如何查看海康威视摄像头的IP和重置密码

海康威视提供了查询已经连接的视频监控设备的应用程序。通过该应用程序，可以搜索到和主机电脑同一局域网络下的所有海康视频设备。

海康威视网络设备搜索

在页面中可以看到各个设备的型号和参数，其中关键参数有：IP，客户端端口号、HTTP端口号（用于浏览器使用的）。如果忘记了账号和密码，可以通过输入右侧的管理员密码进行重置，也可以修改其他参数。账号通常都是“Admin”。 选中设备后就可以点击右下角的【忘记密码】–>【官方公众号获取秘钥】–>【导入并重置】 重置密码

1 keyi chongfu denglu 2 bixu xian denglu caineng yulanhuozhehuifang



【本文地址】


今日新闻

推荐新闻

CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3