using System; using System.Collections.Concurrent; using System.Collections.Generic; using System.Linq; using System.Runtime.InteropServices; using System.Threading; namespace YuncangTrace.LocalService.Services.Hik; /// /// 取实时码流 + 本地解码(25fps 的预览就是靠它)。 /// /// 链路:NET_DVR_RealPlay_V40(8000 私有协议,TCP)→ 回调收到 PS 流 → /// PlayM4_InputData 解码 → PlayM4_GetJPEG 取当前帧交给浏览器。 /// /// 与「抓帧」模式的差别(实测): /// - 抓帧:设备端编码 JPEG,**上限约 5fps**(1080p 每帧 ~190ms),只适合低频快照; /// - 解码:一路码流持续解码,可稳稳跑到设备实际帧率(本项目 25fps), /// 代价是本机多一个解码线程、设备多一路预览连接。 /// /// 子码流( = 1)默认,因为预览流畅度优先、带宽小; /// 要看细节可以传 0 走主码流。 /// public sealed class HikStreamService : IDisposable { /// PlayM4 缓冲区(2MB,够 1080p 一段 GOP) private const uint BufferPoolSize = 2 * 1024 * 1024; /// 取帧用的 JPEG 缓冲区(4MB) private const uint JpegBufferSize = 4 * 1024 * 1024; private readonly HikDeviceService _device; private readonly ConcurrentDictionary _streams = new(); /// 复用键(host:port|user|channel|streamType|模式)→ 句柄 private readonly Dictionary _byKey = new(StringComparer.OrdinalIgnoreCase); /// 串行化 Open/Close,避免两个浏览器同时申请同一通道时各开一路 private readonly object _gate = new(); private bool _disposed; public HikStreamService(HikDeviceService device) { _device = device; } /// 当前打开的码流数(排障用) public int Count => _streams.Count; /// /// 打开一路实时流,返回句柄(NET_DVR_RealPlay_V40 的返回值) /// /// 0-主码流,1-子码流 /// /// 渲染窗口句柄:IntPtr.Zero = 只解码(配合 推给浏览器); /// 传窗口句柄 = 解码器直接画到窗口,**满帧率(设备 25fps)且不经过 JPEG 编码**。 /// public int Open(string host, int port, string userName, string password, int channel, int streamType = 0, string? name = null, IntPtr renderWnd = default) { if (channel <= 0) throw new ArgumentException("channel 必须是正整数"); var finalStreamType = streamType == 1 ? 1 : 0; var mode = renderWnd == IntPtr.Zero ? "decode" : "window"; var key = $"{host.Trim().ToLowerInvariant()}:{port}|{userName}|{channel}|{finalStreamType}|{mode}"; lock (_gate) { // 同一通道 + 同一码流已经在拉:直接复用,RefCount+1。 // 不这么做的话,每开一次预览就多一路 realplay,设备/摄像头很快到达并发上限, // 新开的那一路拿到的是“没有数据的流”,页面就卡在“画面中断”(实测踩过)。 if (renderWnd == IntPtr.Zero && _byKey.TryGetValue(key, out var existing) && _streams.TryGetValue(existing, out var alive)) { alive.RefCount++; alive.Touch(); AppLog.Write($"实时流复用:{host} 通道 {channel}({(finalStreamType == 0 ? "主码流" : "子码流")})handle={existing} 引用数={alive.RefCount}"); return existing; } var handle = CreateStream(host, port, userName, password, channel, finalStreamType, name, renderWnd, key); return handle; } } private int CreateStream(string host, int port, string userName, string password, int channel, int finalStreamType, string? name, IntPtr renderWnd, string key) { // 复用登录会话(不重复登录设备),密码错在这里就会抛 var userId = _device.EnsureUser(host, port, userName, password); var session = new StreamSession(); if (!PlayM4.PlayM4_GetPort(out var playPort)) { throw new HikException(HikSdk.NET_DVR_GetLastError(), "PlayM4 取解码端口失败(PlayCtrl.dll 是否随 SDK 一起安装?)"); } session.PlayPort = playPort; session.Name = name; session.RenderWnd = renderWnd; session.Key = key; PlayM4.PlayM4_SetStreamOpenMode(playPort, PlayM4.STREAME_REALTIME); var info = new HikSdk.NET_DVR_PREVIEWINFO { lChannel = channel, dwStreamType = (uint)finalStreamType, dwLinkMode = 0, // TCP hPlayWnd = IntPtr.Zero, // 只要数据,不由 SDK 画 bBlocked = 0, bPassbackRecord = 0, byPreviewMode = 0, byStreamID = new byte[32], byProtoType = 0, byVideoCodingType = 0, dwDisplayBufNum = 0, byRes = new byte[212], }; session.Callback = session.OnRealData; // 必须持有引用,否则被 GC 后回调崩 var handle = HikSdk.NET_DVR_RealPlay_V40(userId, ref info, session.Callback, IntPtr.Zero); if (handle < 0) { var err = HikSdk.NET_DVR_GetLastError(); PlayM4.PlayM4_FreePort(playPort); throw new HikException(err, $"打开实时流失败:{HikSdk.DescribeError(err)}"); } session.Handle = handle; session.Host = host; session.Channel = channel; session.StreamType = finalStreamType; session.RefCount = 1; _streams[handle] = session; if (renderWnd == IntPtr.Zero) _byKey[key] = handle; AppLog.Write($"实时流已打开:{host} 通道 {channel}({(finalStreamType == 0 ? "主码流" : "子码流")},{(renderWnd == IntPtr.Zero ? "仅解码" : "窗口渲染")})handle={handle} port={playPort}"); return handle; } /// /// 取当前帧 JPEG;尚无解码帧时返回空数组(调用方稍后重试即可) /// public byte[] GetJpeg(int handle, int timeoutMs = 800) { if (!_streams.TryGetValue(handle, out var session)) return Array.Empty(); var deadline = Environment.TickCount64 + Math.Max(timeoutMs, 0); while (Environment.TickCount64 <= deadline) { if (TryReadJpeg(session, out var frame) && frame.Length > 0) return frame; if (_disposed) break; Thread.Sleep(15); } return Array.Empty(); } private static bool TryReadJpeg(StreamSession session, out byte[] frame) { frame = Array.Empty(); var buffer = Marshal.AllocHGlobal((int)JpegBufferSize); try { if (!PlayM4.PlayM4_GetJPEG(session.PlayPort, buffer, JpegBufferSize, out var size) || size == 0) { return false; } frame = new byte[size]; Marshal.Copy(buffer, frame, 0, frame.Length); return true; } catch { return false; } finally { Marshal.FreeHGlobal(buffer); } } /// 解出来的画面尺寸(宽 x 高),拿不到返回 (0,0) public (int Width, int Height) GetSize(int handle) { if (!_streams.TryGetValue(handle, out var session)) return (0, 0); return PlayM4.PlayM4_GetPictureSize(session.PlayPort, out var width, out var height) ? (width, height) : (0, 0); } /// 关闭一路实时流(引用计数减到 0 才真的停) public bool Close(int handle) { lock (_gate) { if (!_streams.TryGetValue(handle, out var session)) return false; session.RefCount--; if (session.RefCount > 0) { AppLog.Write($"实时流释放引用:handle={handle} 剩余={session.RefCount}"); return true; } _streams.TryRemove(handle, out _); if (!string.IsNullOrEmpty(session.Key) && _byKey.TryGetValue(session.Key, out var mapped) && mapped == handle) { _byKey.Remove(session.Key); } try { HikSdk.NET_DVR_StopRealPlay(handle); } catch { // 退出阶段忽略 } try { PlayM4.PlayM4_Stop(session.PlayPort); PlayM4.PlayM4_CloseStream(session.PlayPort); PlayM4.PlayM4_FreePort(session.PlayPort); } catch { // 忽略 } AppLog.Write($"实时流已关闭:{session.Host} 通道 {session.Channel} handle={handle}"); return true; } } public void CloseAll() { foreach (var handle in _streams.Keys.ToList()) { Close(handle); } } public void Dispose() { if (_disposed) return; _disposed = true; CloseAll(); } /// 一路实时流的状态(回调线程与 HTTP 线程共用) private sealed class StreamSession { private readonly object _sync = new(); private byte[]? _systemHeader; private bool _opened; private bool _openFailed; private bool _loggedFirstPacket; public int Handle { get; set; } public int PlayPort { get; set; } public string Host { get; set; } = string.Empty; public int Channel { get; set; } public int StreamType { get; set; } /// 复用键(window 模式不参与复用,Key 为空) public string Key { get; set; } = string.Empty; /// 有多少个预览会话在用它 public int RefCount { get; set; } /// 最近使用时间(配速/排障用) public long LastUsedTicks { get; private set; } = Environment.TickCount64; public void Touch() => LastUsedTicks = Environment.TickCount64; /// 渲染窗口(0 = 只解码不出图) public IntPtr RenderWnd { get; set; } public string? Name { get; set; } /// 回调委托(必须由本对象持有,避免被 GC 回收) public HikSdk.RealDataCallback? Callback { get; set; } /// SDK 网络线程回调:拿到 PS 流喂给 PlayM4 public void OnRealData(int lRealHandle, uint dwDataType, IntPtr pBuffer, uint dwBufSize, IntPtr pUser) { try { // 首次回调记一笔(排障:主码流打不开时能看出是没数据还是没解码) if (!_loggedFirstPacket) { _loggedFirstPacket = true; AppLog.Write($"实时流首包:通道 {Channel}({(StreamType == 0 ? "主码流" : "子码流")})type={dwDataType} size={dwBufSize}"); } switch (dwDataType) { case 1: // 系统头(PS 头),打开流时一起交给解码器 lock (_sync) { _systemHeader = new byte[dwBufSize]; Marshal.Copy(pBuffer, _systemHeader, 0, (int)dwBufSize); } return; case 2: // 流数据 break; default: return; } if (!EnsureOpened()) return; // 直接指向 SDK 的缓冲区,解码器会拷走 PlayM4.PlayM4_InputData(PlayPort, pBuffer, dwBufSize); } catch (Exception ex) { if (!_openFailed) { _openFailed = true; AppLog.Write($"实时流解码失败(通道 {Channel}):{ex.Message}"); } } } private bool EnsureOpened() { if (_opened) return true; lock (_sync) { if (_opened) return true; var header = _systemHeader ?? Array.Empty(); var headerPtr = IntPtr.Zero; try { if (header.Length > 0) { headerPtr = Marshal.AllocHGlobal(header.Length); Marshal.Copy(header, 0, headerPtr, header.Length); } // 没拿到系统头也要开(PS 流的第一包自带头) if (!PlayM4.PlayM4_OpenStream(PlayPort, headerPtr, (uint)header.Length, BufferPoolSize)) { _openFailed = true; AppLog.Write($"PlayM4 打开流失败:通道 {Channel} port={PlayPort} 头长度={header.Length}"); return false; } PlayM4.PlayM4_Play(PlayPort, RenderWnd); // 0 = 只解码不显示;有句柄 = 直接画到窗口(满帧) _opened = true; AppLog.Write($"PlayM4 已开流:通道 {Channel} port={PlayPort} 头长度={header.Length} 模式={(RenderWnd == IntPtr.Zero ? "仅解码" : "窗口")}"); return true; } finally { if (headerPtr != IntPtr.Zero) Marshal.FreeHGlobal(headerPtr); } } } } }