C#控制海康网络摄像头：从SDK集成到视频流保存的实战指南

1次阅读

没有评论

共计 2112 个字符，预计需要花费 6 分钟才能阅读完成。

海康威视摄像头 SDK（HCNetSDK）是工业级监控设备的标配开发包，但.NET 开发者常会遇到以下问题：

文档晦涩 ：官方文档以 C ++ 示例为主，P/Invoke 转换困难
回调机制复杂 ：视频流需要处理异步回调，涉及非托管内存操作
高频错误 ：
NET_DVR_Init() 返回 false（通常因 DLL 加载路径错误）
预览窗口黑屏（常见于参数配置不当）
视频存储失败（H.264 裸流需要特殊处理）

对比三种常见方案：

原生 HCNetSDK
优点：功能完整，支持所有设备特性
缺点：需处理非托管资源
OpenCV
优点：简单易用
缺点：无法控制 PTZ 等高级功能
ONVIF 协议
优点：标准化
缺点：功能受限

核心流程 ：

SDK 初始化
设备登录
获取视频参数
启动实时预览
存储视频流

public sealed class SdkHandle : SafeHandleZeroOrMinusOneIsInvalid
{protected override bool ReleaseHandle()
    {return HCNetSDK.NET_DVR_Cleanup();
    }
}

// 使用示例
using (var sdk = new SdkHandle())
{if (!HCNetSDK.NET_DVR_Init())
        throw new DvrException("初始化失败");
}

private static HCNetSDK.REALDATACALLBACK _callback;

// 初始化时注册
_callback = new HCNetSDK.REALDATACALLBACK(RealDataCallback);
GC.KeepAlive(_callback); // 防止 GC 回收

private static void RealDataCallback(int lRealHandle, uint dwDataType, IntPtr pBuffer, uint dwBufSize, IntPtr pUser)
{// 处理视频帧}

public int LoginWithRetry(string ip, ushort port, string user, string pwd, int retries = 3)
{for (int i = 0; i < retries; i++)
    {var param = new HCNetSDK.NET_DVR_DEVICEINFO_V30();
        int userId = HCNetSDK.NET_DVR_Login_V30(ip, port, user, pwd, ref param);

        if (userId >= 0) 
            return userId;

        Thread.Sleep(1000);
    }
    throw new TimeoutException("登录超时");
}

// 初始化 FFmpeg 上下文
AVCodecContext* codecCtx = ffmpeg.avcodec_alloc_context3(codec);
codecCtx->codec_type = AVMediaType.AVMEDIA_TYPE_VIDEO;
codecCtx->codec_id = AVCodecID.AV_CODEC_ID_H264;

// 处理关键帧
if (packet->flags & AV_PKT_FLAG_KEY) 
{// 关键帧特殊处理}

32 位 /64 位 DLL 需放在不同目录
推荐目录结构：
```
/x86/HCNetSDK.dll
/x64/HCNetSDK.dll
```

// 心跳检测线程
while (true)
{if (!HCNetSDK.NET_DVR_GetDeviceStatus(userId, out var status))
    {Reconnect();
        break;
    }
    Thread.Sleep(5000);
}

// 使用 SDK 时间 + 本地偏移量
DateTime GetFrameTime(uint dwAbsTime)
{var baseTime = new DateTime(2000, 1, 1);
    return baseTime.AddSeconds(dwAbsTime);
}

private static readonly ConcurrentQueue<byte[]> _yuvPool = new();

byte[] RentYuvBuffer(int size)
{if (_yuvPool.TryDequeue(out var buffer) && buffer.Length >= size)
        return buffer;

    return new byte[size];
}

建议方案：