packServer/desktop/Services/Hik/HikPreviewService.cs
liufumingren fe8c0d62a1 chore(ports): 本机服务与边缘代理端口整体迁出 173xx
- 桌面端本机 HTTP/WS:17300/17301 → 16000/16001(前端、浏览器扩展、文档同步)
- 后台服务局域网:UDP 17310/TCP 17311 → UDP 16100/TCP 16101(16010 被向日葵占用,统一避开 160xx)
- 防火墙规则随端口更新,安装/升级时清理旧 17xxx 规则,避免继续占用别人的端口
- 桌面端版本升到 1.0.162

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-18 15:51:41 +08:00

299 lines
12 KiB
C#
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System;
using System.Collections.Concurrent;
using System.Linq;
using System.Threading;
namespace YuncangTrace.LocalService.Services.Hik;
/// <summary>
/// 预览会话管理(实时预览唯一入口,由 WS 16001 驱动)。
///
/// 为什么要有「会话」这层:
/// - 网页预览时凭据只发一次(走 WS 的 <c>start_preview</c>),之后每帧按 <c>sid</c> 区分,
/// 密码**不会**出现在任何 URL/帧头里(避免被历史记录、日志、代理记下来);
/// - 会话里存着设备凭据与通道号,抓帧时直接复用 <see cref="HikDeviceService"/> 的连接池,
/// 不会每次取帧都重新登录设备;
/// - 30 分钟没人刷新自动失效(滑动过期),进程内内存存储,不落盘。
///
/// 抓帧用 HCNetSDK 的 <c>NET_DVR_CaptureJPEGPicture_NEW</c>(8000 端口私有协议):
/// 不需要解码器、不需要转码,拿到的 JPEG 直接通过 WS 以二进制帧推给页面。
/// </summary>
public sealed class HikPreviewService : IDisposable
{
/// <summary>会话空闲多久失效(浏览器一直开着流会不断续期)</summary>
private static readonly TimeSpan SessionTtl = TimeSpan.FromMinutes(30);
/// <summary>同时保留的会话上限(防止页面异常反复建会话把内存吃满)</summary>
private const int MaxSessions = 32;
private readonly HikDeviceService _device;
private readonly HikStreamService _stream;
private readonly HikFfmpegService _ffmpeg;
private readonly ConcurrentDictionary<string, HikPreviewSession> _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));
}
/// <summary>
/// 建预览会话(会登录一次设备验证账号密码,并从登录信息里读「首个数字通道号」)
/// </summary>
/// <param name="mode">
/// ffmpeg = ffmpeg 转码(主码流可用,缩到 width 宽);
/// stream = SDK 取流 + PlayM4 解码转 JPEG(适合子码流);
/// capture = 设备抓帧(约 5fps)。
/// </param>
/// <param name="streamType">0-主码流,1-子码流</param>
/// <param name="logicalChannel">RTSP 的 1 起通道序号;不传则按设备起始数字通道推算</param>
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;
}
/// <summary>按 sid 取会话(滑动续期);不存在/已过期返回 null</summary>
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;
}
/// <summary>抓一帧(阻塞调用,HTTP 层放线程池里跑)</summary>
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<byte>();
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);
}
/// <summary>解码画面的分辨率(拿不到返回 0x0)</summary>
public (int Width, int Height) SizeOf(HikPreviewSession session)
=> session.StreamHandle >= 0 ? _stream.GetSize(session.StreamHandle) : (0, 0);
/// <summary>当前打开的实时流数(排障用)</summary>
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 统一释放
}
}
/// <summary>一路预览</summary>
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;
/// <summary>海康通道号(数字通道从 33 起)</summary>
public int Channel { get; init; }
/// <summary>RTSP 用的 1 起通道序号</summary>
public int LogicalChannel { get; init; }
/// <summary>0-主码流(默认),1-子码流</summary>
public int StreamType { get; init; } = 0;
/// <summary>预览模式:stream=码流本地解码(25fps);capture=设备抓帧(约 5fps)</summary>
public string Mode { get; internal set; } = "capture";
/// <summary>降级时的提示</summary>
public string? Warning { get; internal set; }
/// <summary>实时流句柄(-1 = 未走码流;句柄 0 是合法的第一路)</summary>
public int StreamHandle { get; internal set; } = -1;
/// <summary>ffmpeg 转码句柄(-1 = 未用 ffmpeg)</summary>
public int FfmpegHandle { get; internal set; } = -1;
/// <summary>该会话已经取到的 ffmpeg 帧版本(避免两个页面抢同一帧)</summary>
public long FfmpegVersion { get; internal set; }
/// <summary>是否已经成功出过解码帧(用于首帧兑底判断)</summary>
public bool HadFrame { get; internal set; }
/// <summary>抓帧帧率(1~25)</summary>
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;
/// <summary>RTSP 码流 id:主码流 = 通道号 * 100 + 1(通道 1 → 101)</summary>
public string StreamId => $"{LogicalChannel}01";
/// <summary>标准 RTSP 地址(给 VLC 等外部播放器;浏览器用 MJPEG 那个)</summary>
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);
}
}