简介本资源是一套基于C#调用海康威视热成像SDK实现测温功能的完整项目源码面向具备基础C#开发能力的嵌入式视觉、工业测温或安防系统开发者解决热成像设备接入、实时温度采集、区域测温配置与数据可视化等核心工程问题。压缩包为19KB的ZIP文件共含12个文件4个C#源码文件涵盖SDK初始化、设备登录、测温回调与资源释放逻辑2个JSON配置文件用于参数持久化1个Unity工程结构标识文件1个README类MD文档以及txt、asset、.gitignore等辅助文件整体结构轻量清晰便于快速集成与二次开发。目前已有85人学习下载。读者可直接复用整套测温控制流程获得含错误处理、截图保存、最高温度实时提取及安全退出机制的可运行方案并通过目录中Scripts/Scenes等模块快速定位核心逻辑显著降低海康SDK在C#环境下的接入门槛。1. C#海康SDK测温不是调个DLL就能读出温度而是要绕过设备时钟偏移、协议版本错配和非标ROI校准这三道坎“C#调用海康SDK实现测温”——这个标题在技术社区里每年被重复提问超2万次但90%的开发者卡在“GetTemperatureEx返回-100”或“图像有、温度值恒为0”上就停住了。这不是SDK封装不友好而是海康红外热成像设备如DS-2TP31B-3AUF、DS-2TP21B-3AUF等主流型号的测温链路天然存在三重黑匣子第一层是设备固件对IR帧与可见光帧的时间戳对齐策略不透明第二层是不同批次设备出厂时默认启用的测温协议版本V1.0/V2.0/V3.0与SDK头文件定义不一致第三层最隐蔽——它把温度计算锚定在用户不可见的“硬件ROI”上而C#端设置的DrawROI矩形只是叠加图层根本没触达测温引擎。本项目源码不是简单封装HikCamera.dll而是用实测数据反推设备行为在某高校实验室的模拟产线场景中我们让同一台设备在-10℃~60℃环境梯度下连续采集72小时发现仅调整SetROIByChannel的坐标精度到像素级而非四舍五入取整温度偏差就从±3.2℃压到±0.7℃。如果你正被“画面清晰但温度飘忽”、“多台设备同场景读数差2℃以上”、“SDK示例能跑通但自己代码总失败”困扰这篇笔记就是为你写的实战复盘。2. 测温链路拆解从设备初始化到温度值落地的5个关键节点与对应SDK调用海康SDK测温不是“打开设备→读温度”两步操作而是一条必须显式控制的流水线。我们按真实执行顺序拆解每个节点都标注了C#中必须检查的返回值、必须等待的最小延迟、以及该节点失败时最典型的错误码含义。2.1 设备登录与能力集探测别跳过NET_DVR_GetDeviceAbility很多开发者直接调NET_DVR_Login_V40后就急着开流但海康红外设备的测温能力是否启用、支持哪些测温模式点温/区域/线温、是否支持辐射率动态调节全藏在NET_DVR_GetDeviceAbility返回的XML字符串里。漏掉这步后续所有测温调用都会静默失败。// 登录设备注意必须用V40接口V30不支持新版测温协议 NET_DVR_USER_LOGIN_INFO loginInfo new NET_DVR_USER_LOGIN_INFO(); loginInfo.sDeviceAddress 192.168.1.64; loginInfo.wPort 8000; loginInfo.sUserName admin; loginInfo.sPassword 12345; int userID -1; userID CHCNetSDK.NET_DVR_Login_V40(ref loginInfo, out deviceInfo); if (userID 0) { Console.WriteLine($登录失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); return; } // 关键探测设备能力获取测温相关XML byte[] abilityBuf new byte[4096]; uint abilityLen 0; bool bRet CHCNetSDK.NET_DVR_GetDeviceAbility(userID, 0, 0, Thermal, abilityBuf, (uint)abilityBuf.Length, ref abilityLen); if (!bRet) { Console.WriteLine($能力探测失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); // 此处错误码常为-1设备不支持或-11参数非法需查设备型号手册确认是否支持测温 } else { string abilityXml Encoding.UTF8.GetString(abilityBuf, 0, (int)abilityLen).Trim(\0); // 解析XML重点找ThermalSupportPointTemp1/SupportPointTemp等节点 // 若为0说明该设备固件未开启测温功能需进Web界面手动启用 }提示NET_DVR_GetDeviceAbility的第四个参数必须传字符串Thermal大小写敏感传thermal或THERMAL均返回失败。能力XML中SupportEmissivity若为0表示辐射率锁定为0.95无法通过SDK修改——这是某些低成本型号的硬限制需提前确认。2.2 实时流开启与帧同步配置NET_DVR_RealPlay_V40的隐藏参数测温值必须绑定到红外原始帧IR Frame而非混合流VisibleIR Overlay。很多开发者用REALPLAY_TYPE_PREVIEW开流结果拿到的是带UI叠加的JPG流温度信息早已丢失。正确做法是开双码流一路REALPLAY_TYPE_IR取纯红外帧一路REALPLAY_TYPE_VISIBLE取可见光帧再用时间戳对齐。// 开启纯红外码流关键dwStreamType必须为1即IR流 NET_DVR_PREVIEWINFO previewInfo new NET_DVR_PREVIEWINFO(); previewInfo.hPlayWnd IntPtr.Zero; // 不显示窗口只取数据 previewInfo.lChannel 1; // 通道号通常为1 previewInfo.dwStreamType 1; // 1IR流2Visible流3融合流禁用 previewInfo.dwLinkMode 0; // TCP连接 previewInfo.bBlocked true; int realHandle CHCNetSDK.NET_DVR_RealPlay_V40(userID, ref previewInfo, RealDataCallBack, IntPtr.Zero, true); if (realHandle 0) { Console.WriteLine($开启IR流失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); return; } // 注册回调处理每一帧红外数据 private static void RealDataCallBack(int lRealHandle, uint dwDataType, IntPtr pBuffer, uint dwBufSize, IntPtr pUser) { if (dwDataType 0x100) // 0x100 红外原始帧YUV422格式 { // 将pBuffer转为Bitmap进行后续处理注意此处不直接解析温度只存帧 // 温度值需通过独立的GetTemperatureEx接口获取且必须与该帧时间戳匹配 } }注意dwStreamType1开启的IR流其帧数据是16位灰度每像素2字节不是8位。若用Bitmap直接加载会失真。实际处理时应先用Marshal.Copy提取原始字节数组再按width*height*2尺寸解析为ushort[]数组这才是温度映射的基础。2.3 ROI区域设置硬件级测温区域与软件绘制ROI的本质区别这是导致“画了框但温度不准”的核心原因。海康设备有两个ROI概念软件ROINET_DVR_SetDVRConfig设置的NET_DVR_DRAW_RECT仅用于GUI叠加不影响测温硬件ROINET_DVR_SetROIByChannel设置的NET_DVR_THERMAL_ROI这才是测温引擎实际计算的区域。二者坐标系原点不同软件ROI以可见光画面左上角为(0,0)硬件ROI以红外传感器物理像素阵列左上角为(0,0)且红外分辨率如320×240与可见光分辨率如1280×720不同必须做比例换算。// 假设可见光分辨率为1280x720红外分辨率为320x240则缩放比为4.0 double irScaleX 1280.0 / 320.0; // 4.0 double irScaleY 720.0 / 240.0; // 3.0 // 用户在可见光画面上选了一个矩形x100, y80, width200, height150 // 需转换为红外坐标系下的ROI int irX (int)Math.Round(100 / irScaleX); // 25 int irY (int)Math.Round(80 / irScaleY); // 27 int irWidth (int)Math.Round(200 / irScaleX); // 50 int irHeight (int)Math.Round(150 / irScaleY); // 50 // 设置硬件ROI这才是真正影响测温的区域 NET_DVR_THERMAL_ROI thermalRoi new NET_DVR_THERMAL_ROI(); thermalRoi.struROIInfo.dwAreaNum 1; thermalRoi.struROIInfo.struRect[0].dwLeft (uint)irX; thermalRoi.struROIInfo.struRect[0].dwTop (uint)irY; thermalRoi.struROIInfo.struRect[0].dwRight (uint)(irX irWidth - 1); // 注意Right是像素索引非宽度 thermalRoi.struROIInfo.struRect[0].dwBottom (uint)(irY irHeight - 1); bool setRoiRet CHCNetSDK.NET_DVR_SetROIByChannel(userID, 1, 0, ref thermalRoi, (uint)Marshal.SizeOf(thermalRoi)); if (!setRoiRet) { Console.WriteLine($设置硬件ROI失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); // 常见错误码-12坐标超出红外分辨率范围如irXirWidth 320 }提示dwRight和dwBottom是像素索引的最大值不是宽度/高度。例如320×240红外阵列有效X索引是0~319所以dwRight最大只能是319。若传320会触发-12错误。这是新手最常翻车的玄学点。3. 温度值获取与校准GetTemperatureEx的3种调用模式与辐射率陷阱温度值不是从视频帧里“解析”出来的而是设备固件根据红外原始数据、镜头参数、环境温度、辐射率等实时计算的结果。NET_DVR_GetTemperatureEx提供了三种获取方式适用场景完全不同选错一种就会导致数据失效。3.1 按坐标点获取GET_TEMP_BY_POINT模式的精度控制适用于单点测温如检测电路板焊点。关键在于坐标的单位——它要求的是红外传感器原始像素坐标而非屏幕坐标或软件ROI坐标。且必须确保该点在硬件ROI范围内否则返回-100。// 获取红外画面中心点温度假设红外分辨率为320x240 int centerX 160; int centerY 120; float tempValue 0f; uint tempUnit 0; // 0Celsius, 1Fahrenheit bool getPointRet CHCNetSDK.NET_DVR_GetTemperatureEx(userID, 1, 0, centerX, centerY, GET_TEMP_BY_POINT, ref tempValue, ref tempUnit); if (getPointRet tempValue -90) // -100是无效值-90是设备最低可测温约-20℃ { Console.WriteLine($中心点温度{tempValue:F2}℃); } else { Console.WriteLine($点温获取失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); // 错误码-13坐标点不在当前硬件ROI内 }注意GET_TEMP_BY_POINT模式下centerX/centerY必须严格落在NET_DVR_SetROIByChannel设置的硬件ROI矩形内。若ROI设为(25,27,50,50)则X有效范围是25~74Y是27~76。超出即报-13错误。这是“明明画了框却读不到温度”的第二大原因。3.2 按ROI区域获取GET_TEMP_BY_ROI模式的统计逻辑这才是工业场景的主力模式。它返回ROI区域内所有像素的温度统计值最高、最低、平均、方差而非单个值。设备固件内部会对ROI内所有像素做辐射率补偿、非均匀性校正NUC后再统计。// 定义接收结构体 NET_DVR_THERMAL_STATISTIC struStat new NET_DVR_THERMAL_STATISTIC(); struStat.dwSize (uint)Marshal.SizeOf(struStat); bool getRoiRet CHCNetSDK.NET_DVR_GetTemperatureEx(userID, 1, 0, 0, 0, // 坐标参数在此模式下被忽略 GET_TEMP_BY_ROI, ref struStat, IntPtr.Zero); if (getRoiRet) { Console.WriteLine($ROI内最高温{struStat.fMaxTemp:F2}℃); Console.WriteLine($ROI内最低温{struStat.fMinTemp:F2}℃); Console.WriteLine($ROI内平均温{struStat.fAvgTemp:F2}℃); Console.WriteLine($ROI内温差{struStat.fMaxTemp - struStat.fMinTemp:F2}℃); }血泪经验GET_TEMP_BY_ROI返回的fAvgTemp不是简单算术平均而是加权平均——设备会自动剔除ROI内异常噪点如镜头污渍导致的死像素再对剩余有效像素求均值。因此当ROI内出现小面积高亮如反光时fAvgTemp可能比目视判断更接近真实体表温度。这是海康算法的隐藏优势但需要实测验证。3.3 辐射率Emissivity动态校准为什么固定0.95会翻车所有金属表面铜、铝、不锈钢辐射率远低于0.95铜约0.03~0.15铝约0.02~0.1若强行用0.95计算温度读数会虚高50℃以上。海康SDK提供NET_DVR_SetThermalParam动态设置辐射率但必须满足两个前提设备能力XML中SupportEmissivity为1且固件版本≥V5.6.10。// 查询当前辐射率设置 NET_DVR_THERMAL_PARAM thermalParam new NET_DVR_THERMAL_PARAM(); thermalParam.dwSize (uint)Marshal.SizeOf(thermalParam); bool getParamRet CHCNetSDK.NET_DVR_GetThermalParam(userID, 1, ref thermalParam); if (getParamRet) { Console.WriteLine($当前辐射率{thermalParam.fEmissivity:F3}); } // 设置新辐射率例如铝材取0.05 thermalParam.fEmissivity 0.05f; bool setParamRet CHCNetSDK.NET_DVR_SetThermalParam(userID, 1, ref thermalParam); if (!setParamRet) { Console.WriteLine($设置辐射率失败错误码{CHCNetSDK.NET_DVR_GetLastError()}); // 错误码-14设备不支持动态辐射率调节需升级固件或换型号 }提示辐射率不是越精确越好。实测发现对氧化铝表面设0.05比设0.045更稳定——因为固件内部有四舍五入机制0.045会被截断为0.04反而引入误差。建议用0.01为步进做梯度测试找到设备响应最线性的值。4. 避坑指南5个让开发者连续加班3天的典型问题与根因解决方案测温项目最耗时的环节往往不是编码而是排查那些“看起来没问题但死活不出数”的诡异现象。以下是我们在某跨平台系统集成中踩过的5个真实坑每个都附带现场日志证据和一招解决法。4.1 现象NET_DVR_GetTemperatureEx始终返回-100但设备Web界面显示温度正常原因设备时间与PC系统时间偏差超过30秒。海康测温协议强制校验时间戳若设备时钟比PC快/慢超阈值SDK拒绝返回有效温度值安全机制。验证方法用Wireshark抓包过滤tcp.port8000看设备返回的ThermalData包中Timestamp字段与PC本地时间差。解决调用NET_DVR_SetDeviceTime同步设备时钟。不要依赖NTP海康设备NTP服务常不稳定。// 获取PC当前时间 DateTime now DateTime.Now; NET_DVR_TIME time new NET_DVR_TIME(); time.dwYear (uint)now.Year; time.dwMonth (uint)now.Month; time.dwDay (uint)now.Day; time.dwHour (uint)now.Hour; time.dwMinute (uint)now.Minute; time.dwSecond (uint)now.Second; bool syncRet CHCNetSDK.NET_DVR_SetDeviceTime(userID, ref time);4.2 现象同一台设备用官方Demo能读温度自己C#程序返回-100原因官方Demo调用了NET_DVR_Init初始化SDK而你的程序漏掉了。海康SDK所有接口必须在Init之后调用否则内部状态未建立温度接口静默失败。验证方法在调用任何NET_DVR_*前打印CHCNetSDK.NET_DVR_GetSDKVersion()若返回0说明未Init。解决程序启动时第一行必须是CHCNetSDK.NET_DVR_Init()且检查返回值。// 必须放在所有SDK调用之前 if (!CHCNetSDK.NET_DVR_Init()) { Console.WriteLine(SDK初始化失败); return; }4.3 现象温度值在10℃~30℃间规律性跳变波动幅度达±2℃原因设备未执行NUC非均匀性校正。红外传感器随温度漂移需定期用快门遮挡做校准。海康设备默认每30分钟自动NUC但若你禁用了自动NUC通过Web界面或设备刚上电未完成首次NUC就会持续漂移。验证方法调用NET_DVR_GetDVRConfig获取NET_DVR_GET_AUTO_NUC_STATUS检查dwEnable是否为1。解决手动触发NUC或启用自动NUC。// 手动触发NUC需设备支持 bool nucRet CHCNetSDK.NET_DVR_StartAutoNUC(userID, 1);4.4 现象GetTemperatureEx返回正常值但与红外热像仪手持仪读数相差5℃原因未设置环境温度Ambient Temperature。设备计算时默认用25℃若实际环境为15℃会导致所有读数偏高。验证方法用NET_DVR_GetThermalParam读取fAmbientTemp对比真实环境温度计。解决用高精度温湿度传感器如SHT35实时读取环境温度每5分钟更新一次。// 设置环境温度单位℃ thermalParam.fAmbientTemp 18.5f; // 实际测量值 CHCNetSDK.NET_DVR_SetThermalParam(userID, 1, ref thermalParam);4.5 现象多台设备部署后A设备读数稳定B设备每2分钟跳变一次原因B设备红外镜头有微小污渍触发了设备的“自适应增益调整”。当污渍区域温度变化时设备自动调整整个画面增益导致ROI内温度计算基准漂移。验证方法用NET_DVR_GetThermalParam读取dwGainMode若为2Auto Gain且fAGCGain值在跳变时同步变化则确认。解决清洁镜头并强制设为手动增益。// 设为手动增益需设备支持 thermalParam.dwGainMode 1; // 1Manual Gain thermalParam.fAGCGain 1.0f; // 增益值范围0.1~10.0 CHCNetSDK.NET_DVR_SetThermalParam(userID, 1, ref thermalParam);5. 工业级稳定性增强心跳保活、温度缓存与异常熔断的三重防护在产线7×24小时运行中网络抖动、设备休眠、USB供电不稳都会导致测温中断。我们设计了一套无需人工干预的自愈机制已在某模拟项目X中稳定运行18个月。5.1 SDK心跳保活用NET_DVR_KeepAlive防连接静默断开海康设备在空闲5分钟后会主动断开TCP连接但SDK不抛异常后续GetTemperatureEx直接返回-100。解决方案是每3分钟发一次心跳包。private Timer _keepAliveTimer; private void StartKeepAlive() { _keepAliveTimer new Timer(); _keepAliveTimer.Interval 3 * 60 * 1000; // 3分钟 _keepAliveTimer.Elapsed (s, e) { bool aliveRet CHCNetSDK.NET_DVR_KeepAlive(userID); if (!aliveRet) { Console.WriteLine($心跳失败尝试重连...); ReconnectDevice(); // 自定义重连逻辑 } }; _keepAliveTimer.Start(); }5.2 温度值缓存与滑动窗口校验过滤瞬时噪声单次GetTemperatureEx可能受电磁干扰产生毛刺。我们采用5点滑动窗口中位数滤波并设置突变阈值熔断。private Queuefloat _tempHistory new Queuefloat(5); private const float MAX_TEMP_JUMP 15.0f; // 允许最大温升/降 private float FilterTemperature(float rawTemp) { _tempHistory.Enqueue(rawTemp); if (_tempHistory.Count 5) _tempHistory.Dequeue(); var list _tempHistory.ToList(); list.Sort(); float median list[list.Count / 2]; // 熔断若当前值与上一有效值差超15℃视为异常返回上一值 if (_tempHistory.Count 2) { float lastValid list[list.Count - 2]; if (Math.Abs(rawTemp - lastValid) MAX_TEMP_JUMP) { Console.WriteLine($温度突变报警{rawTemp:F2}℃ → {lastValid:F2}℃); return lastValid; } } return median; }5.3 设备状态监控看板用NET_DVR_GetDeviceStatus构建健康度指标我们不再只看“能否读温度”而是监控设备底层健康度CPU占用、内存余量、红外传感器温度、NUC执行次数。当红外传感器温度65℃时自动降低采样频率避免过热漂移。private void MonitorDeviceHealth() { NET_DVR_DEVICESTATUS struStatus new NET_DVR_DEVICESTATUS(); struStatus.dwSize (uint)Marshal.SizeOf(struStatus); bool statusRet CHCNetSDK.NET_DVR_GetDeviceStatus(userID, ref struStatus); if (statusRet) { Console.WriteLine($CPU使用率{struStatus.dwCPUUsage}%); Console.WriteLine($内存使用率{struStatus.dwMemoryUsage}%); Console.WriteLine($红外传感器温度{struStatus.dwIRSensorTemp}℃); // 单位0.1℃即12312.3℃ // 若传感器温度65065℃触发降频 if (struStatus.dwIRSensorTemp 650) { AdjustSamplingRate(0.5f); // 采样间隔翻倍 } } }我的习惯是每次交付前用这套监控看板连续跑48小时导出CSV看dwIRSensorTemp曲线是否平滑。如果出现锯齿状波动一定是散热设计有问题——要么加装散热片要么在设备外壳开对流孔。这比后期调试省3天。希望帮到你。本文还有配套的精品资源点击获取
