桌面端
- 新增 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 描述
299 lines
12 KiB
C#
299 lines
12 KiB
C#
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);
|
||
}
|
||
}
|