using System;
using System.IO;
using System.Runtime.InteropServices;
using System.Text;
namespace YuncangTrace.LocalService.Services.Hik;
///
/// 海康「设备网络 SDK(HCNetSDK)」的 P/Invoke 声明与初始化。
///
/// 只覆盖本项目需要的最小集合:NET_DVR_Login_V40(走 8000 私有协议)、
/// NET_DVR_GetDVRConfig(读 IP 通道配置)、NET_DVR_Logout。
///
/// ⚠️ 关键约束(都踩过):
/// 1. **必须 x64**:desktop 本身是 x64 进程,SDK 只能用 Win64 包(32 位会加载失败);
/// 2. **必须 SetDllDirectory**:HCNetSDK.dll 依赖同目录的 HCCore.dll 与 HCNetSDKCom\ 组件,
/// 不指定目录会 DLL 找不到 → NET_DVR_Init 直接失败;
/// 3. **结构体要按字节对齐**: 的 Marshal.SizeOf 必须为 416,
/// 少一个填充字节密码就会读错位;
/// 4. **密码传明文**:MD5/RSA 是 SDK 与设备内部的挑战应答,应用层传明文(实测传 MD5 必然 err=1)。
///
internal static class HikSdk
{
private const string Dll = "HCNetSDK.dll";
/// NET_DVR_GET_IPPARACFG_V40:读取 IP 接入配置(含 IP 通道列表)
internal const uint NET_DVR_GET_IPPARACFG_V40 = 1062;
/// NET_DVR_GET_TIMECFG:读取设备时间(输出 NET_DVR_TIME,24 字节)
internal const uint NET_DVR_GET_TIMECFG = 118;
/// NET_DVR_SET_TIMECFG:写入设备时间(输入 NET_DVR_TIME)
internal const uint NET_DVR_SET_TIMECFG = 119;
/// NET_DVR_GET_NTPCFG:读取 NTP 配置(输出 NET_DVR_NTPPARA,126 字节)
internal const uint NET_DVR_GET_NTPCFG = 224;
/// NET_DVR_SET_NTPCFG:写入 NTP 配置(输入 NET_DVR_NTPPARA)
internal const uint NET_DVR_SET_NTPCFG = 225;
/// NET_DVR_GET_DEVICECFG:读取设备参数(用于探活)
internal const uint NET_DVR_GET_DEVICECFG = 100;
///
/// NET_DVR_GET_PICCFG_V30:读取单通道图像参数(结构体头部的 sChanName 就是通道名)
///
/// 通道名只能这么拿:NET_DVR_GET_IPPARACFG_V40(IP 接入配置)里没有名字,
/// 而这条路**走 8000 私有协议**,不需要设备的 Web/ISAPI 端口。
/// 结构体布局:DWORD dwSize + char sChanName[32] + …,名字是 **GBK** 编码。
///
internal const uint NET_DVR_GET_PICCFG_V30 = 1002;
///
/// NET_DVR_GET_PTZPOS:读取通道的 PTZ 参数(输出 NET_DVR_PTZPOS,4 个 WORD = 8 字节)。
///
/// 文档写明是「获取 IP 快球 PTZ 参数」:**非云台通道通常返回失败**(err=17/23)。
/// 拉取通道时已不再调用(预览界面统一显示云台方向盘,不再标记「是否支持云台」)。
///
internal const uint NET_DVR_GET_PTZPOS = 293;
///
/// NET_DVR_JPEGPARA.wPicSize 常用值
///
/// 0xFF = 用当前码流分辨率(部分老固件不支持,会回 err=17/23,调用方需降级重试)。
///
internal const byte JpegSizeCurrent = 0xFF;
internal const byte JpegSize720P = 0x0B;
internal const byte JpegSizeD1 = 0x02;
private static readonly object InitSync = new();
private static bool _initialized;
private static bool _codePagesRegistered;
/// 实际加载的 SDK 目录(排障用)
internal static string? SdkDirectory { get; private set; }
/// 设备网络 SDK 的登录参数结构体(Win64 下 sizeof = 416)
[StructLayout(LayoutKind.Sequential)]
internal struct NET_DVR_USER_LOGIN_INFO
{
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 129)] public byte[] sDeviceAddress;
public byte byUseTransport;
public ushort wPort;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public byte[] sUserName;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public byte[] sPassword;
public IntPtr cbLoginResult;
public IntPtr pUser;
public int bUseAsynLogin;
public byte byProxyType;
public byte byUseUTCTime;
public byte byLoginMode;
public byte byHttps;
public int iProxyID;
public byte byVerifyMode;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 119)] public byte[] byRes3;
}
[DllImport("kernel32.dll", CharSet = CharSet.Unicode)]
private static extern bool SetDllDirectory(string lpPathName);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
private static extern bool NET_DVR_Init();
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
private static extern bool NET_DVR_Cleanup();
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern uint NET_DVR_GetLastError();
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
private static extern bool NET_DVR_SetConnectTime(uint dwWaitTime, uint dwTryTimes);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
private static extern bool NET_DVR_SetReconnect(uint dwInterval, int bEnableRecon);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
private static extern int NET_DVR_Login_V40(ref NET_DVR_USER_LOGIN_INFO pLoginInfo, IntPtr lpDeviceInfo);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_Logout(int lUserID);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_GetDVRConfig(
int lUserID,
uint dwCommand,
int lChannel,
IntPtr lpOutBuffer,
uint dwOutBufferSize,
out uint lpBytesReturned);
/// 写设备配置(如 NET_DVR_SET_NTPCFG); 指向命令对应的结构体
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_SetDVRConfig(
int lUserID,
uint dwCommand,
int lChannel,
IntPtr lpInBuffer,
uint dwInBufferSize);
///
/// 从设备抓一帧 JPEG(走 8000 私有协议,**不需要** ISAPI/Web 端口)
///
/// 预览就是靠它按 fps 连续抓帧、再以 MJPEG 推给浏览器;不需要解码器,也不需要转码进程。
/// lpJpegPara 指向 NET_DVR_JPEGPARA(WORD wPicSize + WORD wPicQuality,4 字节)。
///
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_CaptureJPEGPicture_NEW(
int lUserID,
int lChannel,
IntPtr lpJpegPara,
IntPtr sJpegPicBuffer,
uint dwPicSize,
out uint lpSizeReturned);
///
/// 实时预览信息(HCNetSDK.h 的 NET_DVR_PREVIEWINFO,x64 下 sizeof = 288)
///
/// 头文件**没有** #pragma pack,所以按自然对齐声明:hPlayWnd 前有 4 字节填充。
///
[StructLayout(LayoutKind.Sequential)]
internal struct NET_DVR_PREVIEWINFO
{
public int lChannel;
public uint dwStreamType; // 0-主码流 1-子码流 2-第三码流
public uint dwLinkMode; // 0-TCP
public IntPtr hPlayWnd; // 0 = 只要数据、不显示
public uint bBlocked;
public uint bPassbackRecord;
public byte byPreviewMode;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 32)] public byte[] byStreamID;
public byte byProtoType;
public byte byRes1;
public byte byVideoCodingType;
public uint dwDisplayBufNum;
public byte byNPQMode;
public byte byRecvMetaData;
public byte byDataType;
public byte byReconnect;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 212)] public byte[] byRes;
}
/// 实时流数据回调(dwDataType:1-系统头,2-流数据)
internal delegate void RealDataCallback(int lRealHandle, uint dwDataType, IntPtr pBuffer, uint dwBufSize, IntPtr pUser);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern int NET_DVR_RealPlay_V40(
int lUserID,
ref NET_DVR_PREVIEWINFO lpPreviewInfo,
RealDataCallback? fRealDataCallBack_V30,
IntPtr pUser);
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_StopRealPlay(int lRealHandle);
///
/// 云台连续动作(不依赖预览句柄,直接用登录的 UserID + 通道号)
///
/// :0=开始,1=停止。云台必须“开始 + 停止”成对调用,否则会一直转。
///
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_PTZControlWithSpeed_Other(
int lUserID,
int lChannel,
uint dwPTZCommand,
uint dwStop,
uint dwSpeed);
/// 预置点:设置 / 调用 / 删除(dwPTZPresetCmd 见 )
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_PTZPreset_Other(
int lUserID,
int lChannel,
uint dwPTZPresetCmd,
uint dwPresetIndex);
// ==================== 按时间下载录像(走 8000 私有协议) ====================
/// HCNetSDK 的 NET_DVR_TIME(sizeof = 24)
[StructLayout(LayoutKind.Sequential)]
internal struct NET_DVR_TIME
{
public uint dwYear;
public uint dwMonth;
public uint dwDay;
public uint dwHour;
public uint dwMinute;
public uint dwSecond;
}
///
/// HCNetSDK 的 NET_DVR_NTPPARA(sizeof = 126)
///
///
/// BYTE sNTPServer[64]; // 域名/IP,ASCII
/// WORD wInterval; // 同步间隔(分钟)
/// BYTE byEnable; // 0-关闭 1-启用
/// BYTE byRes[59];
///
///
[StructLayout(LayoutKind.Sequential)]
internal struct NET_DVR_NTPPARA
{
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public byte[] sNTPServer;
public ushort wInterval;
public byte byEnable;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 59)] public byte[] byRes;
}
///
/// HCNetSDK 的 NET_DVR_PLAYCOND(sizeof = 356)
///
///
/// DWORD dwChannel; NET_DVR_TIME struStartTime; NET_DVR_TIME struStopTime;
/// BYTE byStreamType; BYTE byDownload; BYTE byOptimalStreamType; BYTE byRes2[301];
///
///
[StructLayout(LayoutKind.Sequential)]
internal struct NET_DVR_PLAYCOND
{
public uint dwChannel;
public NET_DVR_TIME struStartTime;
public NET_DVR_TIME struStopTime;
public byte byStreamType; // 0-主码流 1-子码流
public byte byDownload; // 0-下载(存文件)1-回放(需解码器)
public byte byOptimalStreamType;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 301)] public byte[] byRes2;
}
///
/// 按时间把录像**下载到文件**(8000 私有协议,不需要 554 / 不需要解码器)
///
/// 返回值是文件句柄(>0 成功,-1 失败用 查原因)。
/// 下载出来的是设备原始封装(PS),要 mp4 得再用 ffmpeg 转封装。
///
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern int NET_DVR_GetFileByTime_V40(
int lUserID,
[MarshalAs(UnmanagedType.LPStr)] string sSavedFileName,
ref NET_DVR_PLAYCOND pDownloadCond);
/// 下载进度(0~100,-1 表示失败)
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern int NET_DVR_GetDownloadPos(int lFileHandle);
/// 停止下载并释放句柄
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_StopGetFile(int lFileHandle);
// ==================== 按时间**回放取流**(8000 私有协议,全速推送) ====================
/// NET_DVR_PlayBackControl 控制码
internal const uint PlayStart = 1;
internal const uint PlayStop = 2;
internal const uint PlayPause = 3;
internal const uint PlayFast = 5;
internal const uint PlayNormal = 7;
/// 回放数据回调(:1 系统头,2 流数据)
internal delegate void PlayDataCallback(int lPlayHandle, uint dwDataType, IntPtr pBuffer, uint dwBufSize,
IntPtr pUser);
///
/// 按时间打开回放(通道号用**海康通道号**,如 34)
///
/// ⚠️ 实测:这条接口是**全速推送**的,不按实时速率 —— 本项目设备 2 分钟主码流素材
/// 约 7 秒就推完(≈14 MB/s,17 倍速),所以下载录像不用再 `PlayFast`。
/// 相比之下 NET_DVR_GetFileByTime* 在这台固件上直接不工作(err 17 / 0 字节)。
///
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern int NET_DVR_PlayBackByTime(
int lUserID,
int lChannel,
ref NET_DVR_TIME lpStartTime,
ref NET_DVR_TIME lpStopTime,
IntPtr hWnd);
/// 回放数据回调( 传 0 时必须设,否则没有数据)
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_SetPlayDataCallBack(
int lPlayHandle,
PlayDataCallback? fPlayDataCallBack,
IntPtr pUser);
/// 回放控制(开始 / 停止 / 暂停 / 快放…), 见常量
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_PlayBackControl(
int lPlayHandle,
uint dwControlCode,
uint dwInValue,
IntPtr lpOutValue);
/// 停止回放并释放句柄
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_StopPlayBack(int lPlayHandle);
/// 回放进度(0~100;-1 失败)。判「推完」用它,比数字节稳
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern int NET_DVR_GetPlayBackPos(int lPlayHandle);
///
/// 取**当前回放帧对应的 OSD 时间**(输出 NET_DVR_TIME,24 字节)。
///
/// 这是录像的真实内容时间(录像机回放时间轴),不是"会话相对时间"——
/// 多路对齐只有靠它才能精确到秒:各路从哪个关键帧起播、晚了多少,读一次就知道。
///
[DllImport(Dll, CallingConvention = CallingConvention.StdCall)]
internal static extern bool NET_DVR_GetPlayBackOsdTime(int lPlayHandle, IntPtr lpOsdTime);
/// 初始化 SDK(幂等)。找不到 HCNetSDK.dll 时抛
internal static void EnsureInitialized()
{
lock (InitSync)
{
if (_initialized) return;
var dir = ResolveSdkDirectory()
?? throw new HikException(uint.MaxValue,
"未找到 HCNetSDK.dll:请把海康 Win64 SDK 的「库文件」目录放到程序目录下的 native\\HCNetSDK\\," +
"或设置环境变量 YUNCANG_HIKSDK_DIR 指向该目录");
SetDllDirectory(dir);
// 组件(HCNetSDKCom)里的 DLL 由 HCCore 自行 LoadLibrary,补齐 PATH 更稳
var path = Environment.GetEnvironmentVariable("PATH") ?? string.Empty;
if (path.IndexOf(dir, StringComparison.OrdinalIgnoreCase) < 0)
{
Environment.SetEnvironmentVariable("PATH", dir + Path.PathSeparator + path);
}
if (!NET_DVR_Init())
{
throw new HikException(NET_DVR_GetLastError(), "HCNetSDK 初始化失败(NET_DVR_Init)");
}
// 3 秒连接超时、2 次重试;断链后 5 秒重连(SDK 默认 30 秒,这里更快恢复)
NET_DVR_SetConnectTime(3000, 2);
NET_DVR_SetReconnect(5000, 1);
SdkDirectory = dir;
_initialized = true;
AppLog.Write($"HCNetSDK 已初始化:{dir}");
}
}
/// 停用 SDK(进程退出时调用)
internal static void Shutdown()
{
lock (InitSync)
{
if (!_initialized) return;
try { NET_DVR_Cleanup(); } catch { /* 退出阶段忽略 */ }
_initialized = false;
}
}
/// 登录设备,返回 UserID(>=0);失败抛异常。调用方负责 FreeHGlobal(deviceInfo)
internal static int Login(string host, ushort port, string userName, string password, out IntPtr deviceInfo)
{
EnsureInitialized();
var info = new NET_DVR_USER_LOGIN_INFO
{
sDeviceAddress = new byte[129],
sUserName = new byte[64],
sPassword = new byte[64],
byRes3 = new byte[119],
byUseTransport = 0,
wPort = port,
bUseAsynLogin = 0,
byProxyType = 0,
byUseUTCTime = 0,
byLoginMode = 0, // 0 = 私有协议(走 8000);1 = ISAPI 登录模式(本项目不用)
byHttps = 0, // 0 = 不套 TLS
iProxyID = -1, // 不使用代理时必须为 -1(填 0 新固件会报参数错误 17,实测)
byVerifyMode = 0,
};
// 用 Latin1 保证 1 字符 = 1 字节,不会像 UTF-8 那样把非 ASCII 撑成多字节错位
WriteFixed(info.sDeviceAddress, host);
WriteFixed(info.sUserName, userName);
WriteFixed(info.sPassword, password);
// 设备信息结构体(NET_DVR_DEVICEINFO_V40)比较大,给足空间;给小了会报参数错误 17
const int infoSize = 4096;
deviceInfo = Marshal.AllocHGlobal(infoSize);
Marshal.Copy(new byte[infoSize], 0, deviceInfo, infoSize);
var userId = NET_DVR_Login_V40(ref info, deviceInfo);
if (userId < 0)
{
var err = NET_DVR_GetLastError();
Marshal.FreeHGlobal(deviceInfo);
deviceInfo = IntPtr.Zero;
throw new HikException(err, $"登录设备失败:{DescribeError(err)}");
}
return userId;
}
///
/// GBK(936) 解码:设备返回的通道名 / OSD 名都是 GBK。
/// .NET Core 默认不带码页,第一次用前要注册 ;
/// 注册失败就退回 ASCII(名字可能变问号,但不影响其他字段)。
///
internal static string DecodeGbk(byte[] bytes, int count)
{
try
{
if (!_codePagesRegistered)
{
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
_codePagesRegistered = true;
}
return Encoding.GetEncoding(936).GetString(bytes, 0, count);
}
catch
{
return Encoding.ASCII.GetString(bytes, 0, count);
}
}
private static void WriteFixed(byte[] buffer, string? value)
{
var bytes = Encoding.Latin1.GetBytes(value ?? string.Empty);
var count = Math.Min(bytes.Length, buffer.Length - 1);
Array.Copy(bytes, 0, buffer, 0, count);
}
private static string? ResolveSdkDirectory()
{
var candidates = new[]
{
Environment.GetEnvironmentVariable("YUNCANG_HIKSDK_DIR"),
Path.Combine(AppContext.BaseDirectory, "native", "HCNetSDK"),
Path.Combine(AppContext.BaseDirectory, "native"),
// 兜底:有些部署(历史安装包)把运行库直接放在 exe 同级的 HCNetSDK 目录
Path.Combine(AppContext.BaseDirectory, "HCNetSDK"),
AppContext.BaseDirectory,
};
foreach (var dir in candidates)
{
if (string.IsNullOrWhiteSpace(dir)) continue;
try
{
if (File.Exists(Path.Combine(dir, Dll))) return Path.GetFullPath(dir);
}
catch
{
// 路径非法就跳过
}
}
return null;
}
/// 常见错误码的中文描述(对照 HCNetSDK.h)
internal static string DescribeError(uint code) => code switch
{
0 => "成功",
1 => "用户名或密码错误(密码必须传明文)",
2 => "权限不足",
3 => "SDK 未初始化",
4 => "通道号错误",
5 => "连接到设备的客户端个数超过最大",
6 => "设备版本不匹配",
7 => "连接设备失败(IP/端口不通或设备未开机)",
8 => "网络发送失败",
9 => "网络接收失败",
10 => "网络接收超时",
11 => "网络数据错误",
12 => "调用次序错误",
13 => "无此权限",
14 => "命令执行超时",
15 => "串口号错误",
16 => "报警端口错误",
17 => "参数错误(检查登录参数,如代理序号 / 结构体大小)",
18 => "通道状态异常",
19 => "没有硬盘",
20 => "硬盘号错误",
21 => "硬盘已满",
22 => "硬盘出错",
23 => "设备不支持",
24 => "设备忙",
25 => "设备修改不成功",
26 => "密码格式不正确",
27 => "硬盘正在格式化",
47 => "用户不存在",
72 => "账号被锁定",
73 => "账号已过期",
74 => "账号已禁用",
76 => "该用户有权限的设备数量超过最大值",
251 => "密码为风险密码(设备拒绝)",
1231 => "初始密码未修改,功能受限",
_ => $"未知错误({code})",
};
}
/// 海康 SDK 调用异常( 为 NET_DVR_GetLastError 的原值)
public sealed class HikException : Exception
{
public HikException(uint errorCode, string message) : base(message)
{
ErrorCode = errorCode;
}
/// NET_DVR_GetLastError 返回码(非 SDK 错误时用 0xFFFFFFFF)
public uint ErrorCode { get; }
}