• .net 调用海康SDK的常用操作封装


    • 📢欢迎点赞 :👍 收藏 ⭐留言 📝 如有错误敬请指正,赐人玫瑰,手留余香!
    • 📢本文作者:由webmote 原创
    • 📢作者格言:新的征程,我们面对的不仅仅是技术还有人心,人心不可测,海水不可量,唯有技术,才是深沉黑夜中的一座闪烁的灯塔

    序言

    上篇海康SDK使用以及常见的坑受到了许多网友的喜爱,这也说明了在工控领域内,使用.net开发还是非常便捷省事的。 结合硬件的开发经验来谈语言,也是非常切合实用主义的,这里继续上篇未完成的事情,对海康威视的SDK进行进一步封装,已解决其在x86和x64系统执行时的疑难杂症,并且对海康的SDK进行进一步封装,第一版代码发在github上,供大家测试和使用。

    声明下,海康威视没有给赞助费,希望厂家能够看到,给点打赏,哈哈~~~

    在这里插入图片描述

    1. 支持x86和x64的运行时自动加载

    做过开发的同学都知道,我们目前的操作系统分为x86和x64两个版本,海康SDK是基于C++编写,在编译时已经定义了系统的操作版本,因此需要我们在开发时根据自己的运行环境载入不同的SDK版本。

    这是不是有些复杂,一不小心就掉入了不能加载正确的dll镜像的陷阱中?有没有更方便的办法呢?

    当然是有的,基于.net Framework版本的应用可以采用一种巧妙的方式绕开[DllImport] 属性的载入限制, 当然如果是.net core 3以后的版本,还有更精妙的办法来适应linux平台的方式,这里按下不表,暂时聚焦在.net Framework 4运行环境下的载入方式。

    大家都知道,DllImportAttribute是编译时确定路径的,因此无法在运行时进行dll路径的设置,所以我们利用windows系统的SetDllDirectory函数,来解决加载时自动搜索的路径,这里巧妙的设置加载路径,便绕开了这个限制。

     public HkCamera()
     {
          _sdkInit = CHCNetSDK.NET_DVR_Init();            
      }
    
      static HkCamera()
      {
          //设置搜索路径,兼容x86 和 x64
          var path = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
          path = Path.Combine(path,"Lib", IntPtr.Size == 8 ? "x64" : "x86");
          bool ok = SetDllDirectory(path);
          if (!ok) throw new System.ComponentModel.Win32Exception();
    
      }
    [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
     private static extern bool SetDllDirectory(string path);
    

    在海康原始的SDK文件中,我们需要检查引入类库部分,让它们都采用相对路径,如下:

     [DllImportAttribute(@".\HCNetSDK.dll")]
     public static extern int NET_DVR_SendWithRecvRemoteConfig(...
    

    这里运行时的环境,简单的使用IntPtr.Size == 8 ? "x64" : "x86"进行检测,简单使用便捷!

    2. 海康设备的在线检测

    经过仔细阅读海康的SDK帮助手册,海康在新的SDK中引入了在线检测函数,这里提供新版海康SDK的在线检测方案,以替换上篇文章中阐述的方法。

    当然如果是使用老版本的SDK,可以保留之前的方式,效果是一样的。

    CHCNetSDK.NET_DVR_RemoteControl(_userId, CHCNetSDK.NET_DVR_CHECK_USER_STATUS, IntPtr.Zero, 0);
    

    使用NET_DVR_CHECK_USER_STATUS来检测设备是否在线,经测试,断联后检测的时间会稍微长点。

    3. 封装登录和登出

    海康SDK在使用时,需要对SDK进行初始化,在使用完毕后,需要释放资源,这里可以继承IDisposable接口,实现释放接口,以便销毁该类时,自动卸载这个非托管资源,避免资源泄漏。

    protected virtual void Dispose(bool disposing)
    {
        if (!_disposedValue)
        {
            if (disposing)
            {
                // TODO: 释放托管状态(托管对象)
            }                
    
            if (_sdkInit)
            {
                if (_userId >= 0)
                {
                    Logout();
                }
                try
                {
                    CHCNetSDK.NET_DVR_Cleanup();
                }
                catch { }
            }
           
            _disposedValue = true;
        }
    }
    

    登录和登出是使用海康视频,录像机等设备必须做的操作,这里也进行了统一封装,方便上层调用。

    public bool Login(CameraLoginInfo cameraLoginInfo)
            {
                try
                {
                    
                    if (_userId >= 0)
                    {
                        Logout();
                    }
                    _loginInfo = cameraLoginInfo;
                    var loginInfo = new CHCNetSDK.NET_DVR_USER_LOGIN_INFO();
    
                    loginInfo.sDeviceAddress = cameraLoginInfo.IP;
                    loginInfo.wPort = cameraLoginInfo.Port;
                    loginInfo.sUserName = cameraLoginInfo.UserName;
                    loginInfo.sPassword = cameraLoginInfo.Password;                
                    //是否异步登录:0- 否,1- 是 
                    loginInfo.bUseAsynLogin = false;
    
                    var _deviceInfo = new CHCNetSDK.NET_DVR_DEVICEINFO_V40();
                    _userId = CHCNetSDK.NET_DVR_Login_V40(ref loginInfo, ref _deviceInfo);
                    _serailNumber =  _deviceInfo.struDeviceV30.sSerialNumber;
                    return _userId >= 0;
                   
                }
                catch 
                {
                    return false;
                }
            }
    
            public bool IsOnline()
            {
                try
                {
                    return CHCNetSDK.NET_DVR_RemoteControl(_userId, CHCNetSDK.NET_DVR_CHECK_USER_STATUS, IntPtr.Zero, 0);
                }
                catch { return false; }
            }
            public void Logout()
            {
                try
                {
                    if (_userId >= 0)
                    {
                        CHCNetSDK.NET_DVR_Logout(_userId);
                        _userId = -1;
                    }
                }
                catch { }
            }
    
            private bool CheckLogin()
            {
                if (IsOnline()) return true;
                return Login(_loginInfo);
            }
    

    这里定义了登录的接口类,限定了登录需要的资源,包含IP和端口,用户名和密码,以及默认的视频通道号。

    端口默认为8000,因此初始化时可以不用配置。

    /// 
        /// 海康DVR登录信息
        /// 
        public class CameraLoginInfo
        {
            /// 
            /// 摄像头的IP地址
            /// 
            public string IP { get; set; }
            /// 
            /// 登录端口号
            /// 
            public ushort Port { get; set; } = 8000;
            /// 
            /// 登录用户名
            /// 
            public string UserName { get; set; }
            /// 
            /// 登录密码
            /// 
            public string Password { get; set; }
    
            /// 
            /// 默认通道
            /// 
            public int ChannelNo { get; set; } = 1;
        }
    

    4.云台控制

    海康监控相机最常用到的应该是云台控制和抓取图片了,这里也进行了封装,当然这里还缺少对硬盘录像机,红外测温等的封装,后续将一一完善。

    云台的控制基本是一样的,都是配对操作,一个开始,一个停止。

     /// 
            /// 控制云台,设备接收到控制命令后直接返回成功。不关心云台是否进行相应的动作
            /// 
            /// 
            /// 取值范围[1,7] 
            /// 
            public bool StartPTZControl(PtzCommand cmd, Int32 speed = 4)
            {
                try
                {
                    if (!CheckLogin()) return false;
                    
                    var result = CHCNetSDK.NET_DVR_PTZControlWithSpeed_Other(_userId,_loginInfo.ChannelNo, (uint)cmd, 0, (uint)speed);
                    return result;
                }
                catch 
                {
                    return false;
                }
            }
            /// 
            /// 停止云台
            /// 
            /// 
            /// 
            public bool StopPTZControl(PtzCommand cmd)
            {
                try
                {
                    if (!CheckLogin()) return false;
                    var result = CHCNetSDK.NET_DVR_PTZControlWithSpeed_Other(_userId, _loginInfo.ChannelNo, (uint)cmd, 1, 4);
                    return result;
                }
                catch
                {
                    return false;
                }
            }
    

    注意,所有操作没有抛出异常,因此外部使用的时候,不需要进行try/catch,如果需要提示错误信息,那么需要调用 GetLastError去获取即可。

    这里还是有优化空间的,标准的做法是抛出异常方式,定义一堆异常类,不知道大家能接受那种方式呢?

    5.抓取图片

    最后一步,对抓取图片进行封装,这里需要你提供合适的文件路径和名称。

    /// 
            /// 抓图
            /// 
            /// 
            /// 
            public bool CapturePicture(string fileName)
            {
                if (!CheckLogin()) return false;
    
                try
                {
                    FileInfo fi = new FileInfo(fileName);
                    if (fi.Exists)
                    {
                        File.Delete(fi.FullName);
                    }
                    if (!Directory.Exists(fi.DirectoryName))
                    {
                        Directory.CreateDirectory(fi.DirectoryName);
                    }
    
                    CHCNetSDK.NET_DVR_JPEGPARA lpJpegPara = new CHCNetSDK.NET_DVR_JPEGPARA
                    {
                        wPicQuality = 0,
                        wPicSize = 0xff
                    };
    
                    return CHCNetSDK.NET_DVR_CaptureJPEGPicture(_userId, _loginInfo.ChannelNo, ref lpJpegPara, fileName);
                   
                }
                catch 
                {
                    return false;
                }
            }
    

    总结

    海康SDK的封装还是比较繁琐的,主要在如下几个方面:

    1. 兼容x86和x64
    2. 错误的处理方式包装
    3. 原始的SDK,需要人性化包装改造
    4. 需要硬件进行全面测试
    5. 大量的接口,只能先根据使用场景进行裁剪,后续的改善跟进。

    你学废了吗?

    👓都看到这了,还在乎点个赞吗?

    👓都点赞了,还在乎一个收藏吗?

    👓都收藏了,还在乎一个评论吗?

  • 相关阅读:
    网络通信:基本原理、协议与技术趋势
    OpenCV-Mat类-图像表示
    C++语言实现网络爬虫详细代码
    React native 近期Android 无法编译的问题解决
    JuiceFS 在多云存储架构中的应用 | 深势科技分享
    【C++从0到王者】第三十七站:模拟unordered_map和unordered_set
    C#宿舍信息管理系统
    基于微信小程序的药店管理系统设计与实现-计算机毕业设计源码+LW文档
    数据结构:二叉树(2)
    计算机网络实验:路由器交换机与其基本配置操作、常见命令
  • 原文地址:https://blog.csdn.net/webmote/article/details/139714890