diff --git a/desktop/README.md b/desktop/README.md index c9b4f16..9e9fc37 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -150,10 +150,15 @@ dotnet publish -c Release -r win-x64 -p:ServerBaseUrl=https://trace.example.com (NTP 校准后的值)。前提是**录像机时区必须是东八区**——现场曾把录像机时区设成伦敦(GMT+0), 设备把本地时间当 UTC 推给摄像头,导致录像 OSD 整体跑偏 8~14 小时,而且**烧进视频后改不回来**。 软件走 8000 协议读不到时区,所以这一项由现场保证(时区改好后再同步)。 -- **不再依赖 ISAPI/Web 端口**:以前用 ISAPI 补通道名、探测云台、读写时区, - 但这些接口在部分摄像头/NVR 上根本不存在(实测有设备 `/ISAPI/*` 全 404),已全部移除: - 通道名留空(前端拼「NVR名-通道号」)、不再标记「是否支持云台」(预览界面统一显示方向盘)。 - `/api/hik/channels` 的 `webPort` 参数也已删除(旧前端传了会被忽略)。 +- **通道名走 8000 私有协议**:`NET_DVR_GET_IPPARACFG_V40`(IP 接入配置)里没有名字, + 所以拉通道时对每个 `enabled` 通道再读一次 `NET_DVR_GET_PICCFG_V30`,结构体头部的 + `sChanName`(偏移 4,32 字节,**GBK** 编码)就是通道名 —— 实测 32 路约 250ms,中文正常。 + **不需要设备的 Web/ISAPI 端口**(很多现场只开 8000)。 +- ISAPI 只是兜底:只有当 PICCFG 一个名字都没拿到(极老固件)才去读 + `/ISAPI/ContentMgmt/InputProxy/channels`(先 500ms TCP 探测,依次试 80 / 443 / 8443, + 设备自签证书不校验,按 IP 匹配、IP 对不上再按 ISAPI 的 `id` 推); + 仍然失败就把名字留空,前端拼「NVR名-通道号」,不影响其他字段。 + 云台探测 / 时区读写**仍然完全不依赖 ISAPI**(`/api/hik/channels` 的 `webPort` 参数已删除,旧前端传了会被忽略)。 ## 构建 / 运行 / 发布 diff --git a/desktop/Services/Hik/HikDeviceService.cs b/desktop/Services/Hik/HikDeviceService.cs index 0cef266..9d590b0 100644 --- a/desktop/Services/Hik/HikDeviceService.cs +++ b/desktop/Services/Hik/HikDeviceService.cs @@ -3,6 +3,9 @@ using System.Collections.Generic; using System.Diagnostics; using System.IO; using System.Linq; +using System.Net; +using System.Net.Http; +using System.Net.Sockets; using System.Runtime.InteropServices; using System.Security.Cryptography; using System.Text; @@ -34,6 +37,13 @@ public sealed class HikDeviceService : IDisposable private const int IpDevInfoStart = 84; private const int IpDevInfoSize = 296; + /// NET_DVR_GET_PICCFG_V30 输出缓冲区(实测设备返回 7752 字节,留余量) + private const int PicCfgBufferSize = 20000; + + /// PICCFG 结构体里 sChanName 的偏移与长度(DWORD dwSize + char[NAME_LEN=32]) + private const int PicCfgNameOffset = 4; + private const int PicCfgNameLength = 32; + /// /// 通道→IP 设备的映射表(struStreamMode):64 项、每项 496 字节。 /// 实测 84 + 64*296 + 64*496 + 20 = 50792,正好是设备返回的字节数。 @@ -51,7 +61,10 @@ public sealed class HikDeviceService : IDisposable } /// 读取设备通道列表(登录 → 读 IP 接入配置 → 返回)。阻塞调用,调用方放在线程池里跑 - /// 只走 8000 私有协议:部分摄像头没开 Web/ISAPI 端口,不能再依赖它。 + /// + /// 主数据只走 8000 私有协议(部分摄像头没开 Web/ISAPI 端口); + /// 通道名额外用 **8000 会话的 ISAPI 透传** 补一次,拿不到就留空(前端会自己拼「NVR名-通道号」)。 + /// public HikChannelsResult GetChannels(string host, int port, string userName, string password) { Validate(host, port, userName, password); @@ -75,7 +88,7 @@ public sealed class HikDeviceService : IDisposable try { - var result = ReadChannels(session); + var result = ReadChannels(session, password); result.userId = session.UserId; result.sessionReused = reused; result.elapsedMs = stopwatch.ElapsedMilliseconds; @@ -1081,7 +1094,7 @@ public sealed class HikDeviceService : IDisposable }; } - private static HikChannelsResult ReadChannels(Session session) + private static HikChannelsResult ReadChannels(Session session, string password) { var device = session.Device ?? throw new HikException(3, "设备信息缺失(会话状态异常)"); @@ -1190,8 +1203,8 @@ public sealed class HikDeviceService : IDisposable } } - // 通道名:8000 协议的配置里没有(以前是走 ISAPI 补的,现已移除 —— 部分摄像头没有 Web 端口)。 - // 前端没有名字时会自己拼「NVR名-通道号」。 + // 通道名:IP 接入配置里没有名字 → 逐通道读 PICCFG 的 sChanName(走 8000,不需要 Web 端口) + TryFillChannelNames(session, password, channels); return new HikChannelsResult { @@ -1207,6 +1220,194 @@ public sealed class HikDeviceService : IDisposable }; } + /// + /// 补通道名(best-effort)。 + /// + /// 主路径:**8000 私有协议**逐通道读 NET_DVR_GET_PICCFG_V30 的 sChanName + /// (GBK)—— 不需要设备的 Web/ISAPI 端口,实测 32 路约 250ms,中文名正常。 + /// 只有一条都没拿到(极老固件不支持 PICCFG_V30)才退回设备 Web 端口的 ISAPI; + /// 全部失败就留空,前端会拼「NVR名-通道号」,不影响其他字段。 + /// + private static void TryFillChannelNames(Session session, string password, List channels) + { + var filled = FillNamesFromPicCfg(session, channels); + if (filled == 0) + { + filled = FillNamesFromIsapi(session.Host, session.User, password, channels); + } + + if (filled > 0) + { + AppLog.Write($"通道名:补全 {filled} 个({session.Host})"); + } + } + + /// + /// 走 8000 读每个通道的 OSD 名:NET_DVR_GET_PICCFG_V30 头部是 DWORD dwSize + char sChanName[32]。 + /// 只查 enabled 的通道(空槽位会回 err=4),任何单通道失败都跳过。 + /// + private static int FillNamesFromPicCfg(Session session, List channels) + { + var targets = channels.Where(item => item.enabled).ToList(); + if (targets.Count == 0) return 0; + + var buffer = Marshal.AllocHGlobal(PicCfgBufferSize); + try + { + var filled = 0; + foreach (var item in targets) + { + Marshal.Copy(new byte[PicCfgBufferSize], 0, buffer, PicCfgBufferSize); + Marshal.WriteInt32(buffer, 0, PicCfgBufferSize); // dwSize 必须预先填好 + + var ok = HikSdk.NET_DVR_GetDVRConfig( + session.UserId, + HikSdk.NET_DVR_GET_PICCFG_V30, + item.channel, + buffer, + PicCfgBufferSize, + out var returned); + + if (!ok || returned <= PicCfgNameOffset + PicCfgNameLength) continue; + + var bytes = new byte[PicCfgNameLength]; + Marshal.Copy(IntPtr.Add(buffer, PicCfgNameOffset), bytes, 0, PicCfgNameLength); + var end = Array.IndexOf(bytes, (byte)0); + var name = HikSdk.DecodeGbk(bytes, end < 0 ? PicCfgNameLength : end).Trim(); + if (string.IsNullOrWhiteSpace(name)) continue; + + item.name = name; + filled++; + } + + return filled; + } + finally + { + Marshal.FreeHGlobal(buffer); + } + } + + /// + /// 兜底:读设备 ISAPI ContentMgmt/InputProxy/channels(需要设备 Web 端口)。 + /// + /// - 发请求前先做 500ms TCP 探测,端口没开直接跳过(有些固件只开 8000); + /// - 依次试 http://host:80 → https://host:443 → https://host:8443; + /// - 先按 IP 匹配,IP 对不上再按 ISAPI 的 id 推(id 从 1 起,对应第几个数字通道)。 + /// + private static int FillNamesFromIsapi(string host, string userName, string password, List channels) + { + var digital = channels.Where(item => item.type == "digital").ToList(); + if (digital.Count == 0) return 0; + + var xml = TryGetIsapiChannels(host, userName, password); + if (string.IsNullOrWhiteSpace(xml)) return 0; + + var startDigital = digital.Min(item => item.channel); + + try + { + var byId = new Dictionary(); + var byIp = new Dictionary(StringComparer.OrdinalIgnoreCase); + + foreach (var node in XDocument.Parse(xml).Descendants() + .Where(e => e.Name.LocalName == "InputProxyChannel")) + { + var name = node.Elements().FirstOrDefault(e => e.Name.LocalName == "name")?.Value?.Trim(); + if (string.IsNullOrWhiteSpace(name)) continue; + + var idText = node.Elements().FirstOrDefault(e => e.Name.LocalName == "id")?.Value; + var ip = node.Descendants().FirstOrDefault(e => e.Name.LocalName == "ipAddress")?.Value?.Trim(); + + if (int.TryParse(idText, out var id)) byId[id] = name; + if (!string.IsNullOrWhiteSpace(ip)) byIp[ip] = name; + } + + if (byIp.Count == 0 && byId.Count == 0) return 0; + + var filled = 0; + foreach (var item in digital) + { + if (!string.IsNullOrWhiteSpace(item.ip) && byIp.TryGetValue(item.ip!, out var ipName)) + { + item.name = ipName; + filled++; + continue; + } + + var idGuess = item.channel - startDigital + 1; + if (byId.TryGetValue(idGuess, out var idName)) + { + item.name = idName; + filled++; + } + } + + return filled; + } + catch (Exception ex) + { + AppLog.Write($"解析 ISAPI 通道名失败:{ex.Message}"); + return 0; + } + } + + /// + /// 取 ISAPI 通道列表 XML:按 80(http) → 443(https) → 8443(https) 顺序试, + /// 先 TCP 探测端口,连不通直接换下一个(不等待 HTTP 超时)。全部失败返回 null。 + /// + private static string? TryGetIsapiChannels(string host, string userName, string password) + { + var candidates = new[] + { + (Port: 80, Https: false), + (Port: 443, Https: true), + (Port: 8443, Https: true), + }; + + foreach (var (port, https) in candidates) + { + if (!CanConnect(host, port)) continue; + + try + { + using var handler = new HttpClientHandler + { + // 设备走 HTTP Digest;HttpClientHandler 会自动完成 401 挑战 + Credentials = new NetworkCredential(userName, password), + PreAuthenticate = false, + // 内网设备普遍是自签证书,这里只用来取名字,不做证书校验 + ServerCertificateCustomValidationCallback = (_, _, _, _) => true, + }; + using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(3) }; + var scheme = https ? "https" : "http"; + var url = $"{scheme}://{host}:{port}/ISAPI/ContentMgmt/InputProxy/channels"; + return client.GetStringAsync(url).GetAwaiter().GetResult(); + } + catch (Exception ex) + { + AppLog.Write($"ISAPI 取通道名失败 {host}:{port}:{ex.Message}"); + } + } + + return null; + } + + /// TCP 端口探测( 内连上就算通) + private static bool CanConnect(string host, int port, int timeoutMs = 500) + { + try + { + using var client = new TcpClient(); + var task = client.ConnectAsync(host, port); + return task.Wait(timeoutMs) && client.Connected; + } + catch + { + return false; + } + } + /// /// 校验 struStreamMode 映射表能不能用(老固件可能不填这一层)。 /// 判定标准:byEnable 只能 0/1;启用的槽位 byIPID 必须在 1..64。 @@ -1342,7 +1543,7 @@ public sealed class HikChannelInfo public bool enabled { get; init; } - /// 设备上的通道名(8000 协议不返回,现已留空,由前端自行拼名字) + /// 设备上的通道名(ISAPI 透传补的;拿不到就是 null,由前端自己拼名字) public string? name { get; set; } /// 数字通道对应的前端 IP(未配置时为 null) diff --git a/desktop/Services/Hik/HikSdk.cs b/desktop/Services/Hik/HikSdk.cs index e2dab6c..3658156 100644 --- a/desktop/Services/Hik/HikSdk.cs +++ b/desktop/Services/Hik/HikSdk.cs @@ -41,6 +41,15 @@ internal static class HikSdk /// 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 字节)。 /// @@ -62,6 +71,7 @@ internal static class HikSdk private static readonly object InitSync = new(); private static bool _initialized; + private static bool _codePagesRegistered; /// 实际加载的 SDK 目录(排障用) internal static string? SdkDirectory { get; private set; } @@ -433,6 +443,29 @@ internal static class HikSdk 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);