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

2024-06-17 08:04

本文主要是介绍.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 和 x64var 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,因此初始化时可以不用配置。

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

4.云台控制

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

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

 /// <summary>/// 控制云台,设备接收到控制命令后直接返回成功。不关心云台是否进行相应的动作/// </summary>/// <param name="cmd"></param>/// <param name="speed">取值范围[1,7] </param>/// <returns></returns>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;}}/// <summary>/// 停止云台/// </summary>/// <param name="cmd"></param>/// <returns></returns>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.抓取图片

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

/// <summary>/// 抓图/// </summary>/// <param name="fileName"></param>/// <returns></returns>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. 大量的接口,只能先根据使用场景进行裁剪,后续的改善跟进。

你学废了吗?

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

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

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

这篇关于.net 调用海康SDK的常用操作封装的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1068885

相关文章

Django调用外部Python程序的完整项目实战

《Django调用外部Python程序的完整项目实战》Django是一个强大的PythonWeb框架,它的设计理念简洁优雅,:本文主要介绍Django调用外部Python程序的完整项目实战,文中通... 目录一、为什么 Django 需要调用外部 python 程序二、三种常见的调用方式方式 1:直接 im

Java调用DeepSeek API的8个高频坑与解决方法

《Java调用DeepSeekAPI的8个高频坑与解决方法》现在大模型开发特别火,DeepSeek因为中文理解好、反应快、还便宜,不少Java开发者都用它,本文整理了最常踩的8个坑,希望对... 目录引言一、坑 1:Token 过期未处理,鉴权异常引发服务中断问题本质典型错误代码解决方案:实现 Token

MySQL游标和触发器的操作流程

《MySQL游标和触发器的操作流程》本文介绍了MySQL中的游标和触发器的使用方法,游标可以对查询结果集进行逐行处理,而触发器则可以在数据表发生更改时自动执行预定义的操作,感兴趣的朋友跟随小编一起看看... 目录游标游标的操作流程1. 定义游标2.打开游标3.利用游标检索数据4.关闭游标例题触发器触发器的基

在C#中分离饼图的某个区域的操作指南

《在C#中分离饼图的某个区域的操作指南》在处理Excel饼图时,我们可能需要将饼图的各个部分分离出来,以使它们更加醒目,Spire.XLS提供了Series.DataFormat.Percent属性,... 目录引言如何设置饼图各分片之间分离宽度的代码示例:从整个饼图中分离单个分片的代码示例:引言在处理

Java实现字符串大小写转换的常用方法

《Java实现字符串大小写转换的常用方法》在Java中,字符串大小写转换是文本处理的核心操作之一,Java提供了多种灵活的方式来实现大小写转换,适用于不同场景和需求,本文将全面解析大小写转换的各种方法... 目录前言核心转换方法1.String类的基础方法2. 考虑区域设置的转换3. 字符级别的转换高级转换

Python列表的创建与删除的操作指南

《Python列表的创建与删除的操作指南》列表(list)是Python中最常用、最灵活的内置数据结构之一,它支持动态扩容、混合类型、嵌套结构,几乎无处不在,但你真的会创建和删除列表吗,本文给大家介绍... 目录一、前言二、列表的创建方式1. 字面量语法(最常用)2. 使用list()构造器3. 列表推导式

Python使用Matplotlib和Seaborn绘制常用图表的技巧

《Python使用Matplotlib和Seaborn绘制常用图表的技巧》Python作为数据科学领域的明星语言,拥有强大且丰富的可视化库,其中最著名的莫过于Matplotlib和Seaborn,本篇... 目录1. 引言:数据可视化的力量2. 前置知识与环境准备2.1. 必备知识2.2. 安装所需库2.3

C#借助Spire.XLS for .NET实现在Excel中添加文档属性

《C#借助Spire.XLSfor.NET实现在Excel中添加文档属性》在日常的数据处理和项目管理中,Excel文档扮演着举足轻重的角色,本文将深入探讨如何在C#中借助强大的第三方库Spire.... 目录为什么需要程序化添加Excel文档属性使用Spire.XLS for .NET库实现文档属性管理Sp

Go异常处理、泛型和文件操作实例代码

《Go异常处理、泛型和文件操作实例代码》Go语言的异常处理机制与传统的面向对象语言(如Java、C#)所使用的try-catch结构有所不同,它采用了自己独特的设计理念和方法,:本文主要介绍Go异... 目录一:异常处理常见的异常处理向上抛中断程序恢复程序二:泛型泛型函数泛型结构体泛型切片泛型 map三:文

MyBatis配置文件中最常用的设置

《MyBatis配置文件中最常用的设置》文章主要介绍了MyBatis配置的优化方法,包括引用外部的properties配置文件、配置外置以实现环境解耦、配置文件中最常用的6个核心设置以及三种常用的Ma... 目录MyBATis配置优化mybatis的配置中引用外部的propertis配置文件⚠️ 注意事项X