packServer/desktop/Services/Hik/HikPreviewService.cs
liufumingren bca8f7270c 本机预览/云台/拉通道全部改走 WebSocket(桌面 1.0.75)
桌面端
- 新增 LocalWsServer(ws://127.0.0.1:17301):hello / ping / get_channels /
  start_preview / stop_preview / open_window / close_window / ptz / ptz_preset,
  一条连接可同时推多路 JPEG 帧(帧头带 sid);慢命令并发派发,云台命令按连接串行,
  页面断开自动清理会话与满帧率窗口
- LocalHttpServer 删除预览(MJPEG/快照/满帧率窗口)、/api/hik/channels、/api/hik/ptz*,
  HTTP 17300 只保留 /api/query/{code}、/api/activate-login、/api/playback/download,
  其余 POST 统一回 404 并提示已迁到 WS;不再依赖 HCNetSDK
- App 自行组装 HikStreamService -> HikPreviewService + HikNativePreviewService 注入 WS
- 后台服务加固:框架依赖(开发版)安装/启动时自动写服务环境变量 DOTNET_ROOT,
  避免 LocalSystem 找不到用户目录里的 .NET 8 而报「后台服务启动超时」

前端
- 新增 api/localWs.ts(连接/断线/请求-响应/二进制帧分发),补 getChannels / openWindow /
  closeWindow / ptz / ptzPreset
- CamerasView 预览只走 WS(保留「唤起本机软件 -> 等待 -> 提示安装」兜底),
  满帧率窗口、云台、预置点改走 WS
- NvrsView 拉取通道改走 WS(连不上时自动唤起一次再重试)
- CameraLayoutCanvas 合成画面 4 路改 WS 推帧
- 删除 createHikPreview/closeHikPreview*/openHikWindow/closeHikWindow*/ptzControl/ptzPreset
  与 isLocalServiceAlive/waitForLocalService

其他
- 移除 cameras.has_ptz(迁移 20261019233000)与相关接口/字段/UI
- 通道号按 struStreamMode 映射(IP 通道空槽导致 51 之后整体错位)
- 扫码 24 小时内只保留最后一次扫描(后上报时间更新时覆盖)
- 清理历史 DESKTOP 占位通道(迁移 20261019230000)
- README / desktop README 补 17301 与 WS 接口说明,修正已删除的 /api/health 描述
2026-10-20 00:47:31 +08:00

299 lines
12 KiB
C#
Raw 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 17301 驱动)。
///
/// 为什么要有「会话」这层:
/// - 网页预览时凭据只发一次(走 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);
}
}