海康威视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<NVR> 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<V_Alarm_Rule> 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:MP4iWndowType: 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("<option value='" + szDeviceIdentify + "'>" + szDeviceIdentify + "</option>");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”。
选中设备后就可以点击右下角的【忘记密码】–>【官方公众号获取秘钥】–>【导入并重置】
重置密码