using System; using System.Collections.Concurrent; using System.Linq; using System.Threading; namespace YuncangTrace.LocalService.Services.Hik; /// /// 预览会话管理(实时预览唯一入口,由 WS 17301 驱动)。 /// /// 为什么要有「会话」这层: /// - 网页预览时凭据只发一次(走 WS 的 start_preview),之后每帧按 sid 区分, /// 密码**不会**出现在任何 URL/帧头里(避免被历史记录、日志、代理记下来); /// - 会话里存着设备凭据与通道号,抓帧时直接复用 的连接池, /// 不会每次取帧都重新登录设备; /// - 30 分钟没人刷新自动失效(滑动过期),进程内内存存储,不落盘。 /// /// 抓帧用 HCNetSDK 的 NET_DVR_CaptureJPEGPicture_NEW(8000 端口私有协议): /// 不需要解码器、不需要转码,拿到的 JPEG 直接通过 WS 以二进制帧推给页面。 /// public sealed class HikPreviewService : IDisposable { /// 会话空闲多久失效(浏览器一直开着流会不断续期) private static readonly TimeSpan SessionTtl = TimeSpan.FromMinutes(30); /// 同时保留的会话上限(防止页面异常反复建会话把内存吃满) private const int MaxSessions = 32; private readonly HikDeviceService _device; private readonly HikStreamService _stream; private readonly HikFfmpegService _ffmpeg; private readonly ConcurrentDictionary _sessions = new(StringComparer.OrdinalIgnoreCase); private readonly Timer _sweeper; private bool _disposed; public HikPreviewService(HikDeviceService device, HikStreamService stream, HikFfmpegService ffmpeg) { _device = device; _stream = stream; _ffmpeg = ffmpeg; _sweeper = new Timer(_ => Sweep(), null, TimeSpan.FromMinutes(1), TimeSpan.FromMinutes(1)); } /// /// 建预览会话(会登录一次设备验证账号密码,并从登录信息里读「首个数字通道号」) /// /// /// ffmpeg = ffmpeg 转码(主码流可用,缩到 width 宽); /// stream = SDK 取流 + PlayM4 解码转 JPEG(适合子码流); /// capture = 设备抓帧(约 5fps)。 /// /// 0-主码流,1-子码流 /// RTSP 的 1 起通道序号;不传则按设备起始数字通道推算 public HikPreviewSession Create( string host, int port, string userName, string password, int channel, int fps = 25, int? logicalChannel = null, string? name = null, string mode = "stream", int streamType = 0) { if (channel <= 0) throw new ArgumentException("channel 必须是正整数"); // 顺带验证账号密码:密码错在这里就抛,不会等到浏览器拉流时才失败 var startDigital = _device.GetStartDigitalChannel(host, port, userName, password); var logical = logicalChannel is > 0 ? logicalChannel.Value : (channel >= startDigital ? channel - startDigital + 1 : channel); Trim(); var session = new HikPreviewSession { Id = Guid.NewGuid().ToString("N")[..16], Host = host.Trim(), Port = port, User = userName, Password = password, Channel = channel, LogicalChannel = logical, StreamType = streamType == 1 ? 1 : 0, Fps = Math.Clamp(fps <= 0 ? 25 : fps, 1, 25), Name = name, CreatedAt = DateTime.Now, ExpiresAt = DateTime.Now + SessionTtl, }; // 三种取帧方式(ffmpeg 转码 / SDK 取流解码 / 设备抓帧) var normalizedMode = (mode ?? string.Empty).Trim().ToLowerInvariant(); if (normalizedMode == "ffmpeg") { try { // RTSP 码流号:通道序号*100 + 码流号(通道 1 主码流 = 101,子码流 = 102) var streamId = (session.LogicalChannel * 100 + (session.StreamType == 0 ? 1 : 2)).ToString(); session.FfmpegHandle = _ffmpeg.Open(host, 554, userName, password, streamId, 1280, session.Fps, 6); session.Mode = "ffmpeg"; } catch (HikException ex) { AppLog.Write($"ffmpeg 预览失败(通道 {channel}):{ex.Message},降级为设备抓帧"); session.Mode = "capture"; session.Warning = $"{ex.Message}已降级为设备抓帧(约 5fps)"; session.Fps = Math.Min(session.Fps, 5); } } else if (normalizedMode == "capture") { session.Mode = "capture"; session.Fps = Math.Min(session.Fps, 5); } else { // 默认:SDK 取流 + PlayM4 解码(子码流能稳定 25fps) try { session.StreamHandle = _stream.Open(host, port, userName, password, channel, session.StreamType, name); session.Mode = "stream"; } catch (HikException ex) { AppLog.Write($"取流预览失败(通道 {channel}):{ex.Message},降级为抓帧"); session.Mode = "capture"; session.Warning = $"取流失败({ex.Message}),已降级为抓帧模式(约 5fps)"; session.Fps = Math.Min(session.Fps, 5); } } _sessions[session.Id] = session; return session; } /// 按 sid 取会话(滑动续期);不存在/已过期返回 null public HikPreviewSession? Get(string? id) { if (string.IsNullOrWhiteSpace(id)) return null; if (!_sessions.TryGetValue(id, out var session)) return null; if (DateTime.Now > session.ExpiresAt) { _sessions.TryRemove(id, out _); return null; } session.Touch(); return session; } public bool Remove(string? id) { if (string.IsNullOrWhiteSpace(id) || !_sessions.TryRemove(id, out var session)) return false; if (session.StreamHandle >= 0) _stream.Close(session.StreamHandle); if (session.FfmpegHandle >= 0) _ffmpeg.Close(session.FfmpegHandle); return true; } /// 抓一帧(阻塞调用,HTTP 层放线程池里跑) public byte[] CaptureFrame(HikPreviewSession session) { // ffmpeg 转码:取比上次更新的一帧(多个会话共用同一路转码也不会互抢) if (session.FfmpegHandle >= 0) { if (!_ffmpeg.TryGetLatest(session.FfmpegHandle, session.FfmpegVersion, 600, out var frame, out var version)) return Array.Empty(); session.FfmpegVersion = version; session.HadFrame = true; return frame; } // ⚠️ 句柄 0 是**合法**的(NET_DVR_RealPlay_V40 第一路就返回 0),所以用 -1 当“没流” if (session.StreamHandle >= 0) { // 取流模式**不能**再退回去用设备抓图: // 设备抓图(1080p 约 190ms)会占住 SDK 的网络线程,PlayM4 随即拿不到新帧, // 于是每帧都退化成抓图、永久卡在 ~7fps(实测踩过)。 // 拿不到帧就返回空,由 HTTP 层跳过这一轮,等下一帧即可。 var frame = _stream.GetJpeg(session.StreamHandle, session.HadFrame ? 250 : 2000); if (frame.Length > 0) session.HadFrame = true; return frame; } return _device.CaptureJpeg(session.Host, session.Port, session.User, session.Password, session.Channel); } /// 解码画面的分辨率(拿不到返回 0x0) public (int Width, int Height) SizeOf(HikPreviewSession session) => session.StreamHandle >= 0 ? _stream.GetSize(session.StreamHandle) : (0, 0); /// 当前打开的实时流数(排障用) public int StreamCount => _stream.Count; public int Count => _sessions.Count; private void Trim() { if (_sessions.Count < MaxSessions) return; // 满了就把最久没用的踢掉 foreach (var stale in _sessions.Values.OrderBy(s => s.LastUsedTicks).Take(_sessions.Count - MaxSessions + 1).ToList()) { Remove(stale.Id); } } private void Sweep() { if (_disposed) return; var now = DateTime.Now; foreach (var pair in _sessions) { if (now <= pair.Value.ExpiresAt) continue; _sessions.TryRemove(pair.Key, out var expired); if (expired is null) continue; if (expired.StreamHandle >= 0) _stream.Close(expired.StreamHandle); if (expired.FfmpegHandle >= 0) _ffmpeg.Close(expired.FfmpegHandle); } } public void Dispose() { if (_disposed) return; _disposed = true; _sweeper.Dispose(); _sessions.Clear(); // 注意:_stream 是共用的(满帧率窗口也在用),由 LocalHttpServer 统一释放 } } /// 一路预览 public sealed class HikPreviewSession { public string Id { get; init; } = string.Empty; public string Host { get; init; } = string.Empty; public int Port { get; init; } // 设备凭据只存在内存里,不外泄到 URL public string User { get; init; } = string.Empty; public string Password { get; init; } = string.Empty; /// 海康通道号(数字通道从 33 起) public int Channel { get; init; } /// RTSP 用的 1 起通道序号 public int LogicalChannel { get; init; } /// 0-主码流(默认),1-子码流 public int StreamType { get; init; } = 0; /// 预览模式:stream=码流本地解码(25fps);capture=设备抓帧(约 5fps) public string Mode { get; internal set; } = "capture"; /// 降级时的提示 public string? Warning { get; internal set; } /// 实时流句柄(-1 = 未走码流;句柄 0 是合法的第一路) public int StreamHandle { get; internal set; } = -1; /// ffmpeg 转码句柄(-1 = 未用 ffmpeg) public int FfmpegHandle { get; internal set; } = -1; /// 该会话已经取到的 ffmpeg 帧版本(避免两个页面抢同一帧) public long FfmpegVersion { get; internal set; } /// 是否已经成功出过解码帧(用于首帧兑底判断) public bool HadFrame { get; internal set; } /// 抓帧帧率(1~25) public int Fps { get; internal set; } public string? Name { get; init; } public DateTime CreatedAt { get; init; } public DateTime ExpiresAt { get; internal set; } public long LastUsedTicks { get; private set; } = Environment.TickCount64; /// RTSP 码流 id:主码流 = 通道号 * 100 + 1(通道 1 → 101) public string StreamId => $"{LogicalChannel}01"; /// 标准 RTSP 地址(给 VLC 等外部播放器;浏览器用 MJPEG 那个) public string RtspUrl => $"rtsp://{Uri.EscapeDataString(User)}:{Uri.EscapeDataString(Password)}@{Host}:554/Streaming/Channels/{StreamId}"; public void Touch() { LastUsedTicks = Environment.TickCount64; ExpiresAt = DateTime.Now + TimeSpan.FromMinutes(30); } }