using System; using System.IO; using System.Net; using System.Text; using System.Text.Json; using System.Threading; using System.Threading.Tasks; using YuncangTrace.LocalService.Services.Hik; namespace YuncangTrace.LocalService.Services; /// /// 本机 HTTP 服务(只监听 127.0.0.1) /// /// 给浏览器里的页面调用(我们的 `/local` 公共页、以及任何想取数据的前端): /// - GET /api/query/{code} 查信息;**同时把服务/登录状态一起返回**(没登录回 401 `state:need-login`), /// 页面一次请求就能决定「展示结果」还是「提示唤起」,不再需要单独的探活接口; /// - POST /api/activate-login 把登录窗/主界面叫到前台。 /// /// ⚠️ 两个坑(都在这里处理好了): /// 1. **CORS**:页面同源是站点域名,请求本机属于跨域,必须回 /// `Access-Control-Allow-Origin` 等头,否则浏览器直接拦掉(表现像「服务没启动」); /// 2. **Private Network Access**:公网 https 页面访问 localhost 时,Chrome 会先发 /// 带 `Access-Control-Request-Private-Network: true` 的预检,必须回 /// `Access-Control-Allow-Private-Network: true`,否则预检失败。 /// /// 用 (HTTP.sys):绑定 `http://localhost:端口/` 一般不需要管理员权限; /// 若报「拒绝访问(5)」,用管理员执行一次: /// netsh http add urlacl url=http://localhost:17300/ user=%USERNAME% /// public sealed class LocalHttpServer : IDisposable { /// 监听端口(前端/插件里写死的 17300;可用 YUNCANG_LOCAL_PORT 临时覆盖,便于自测) public static int Port { get; } = ResolvePort(); private static int ResolvePort() { var raw = Environment.GetEnvironmentVariable("YUNCANG_LOCAL_PORT"); return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : 17300; } private readonly HttpListener _listener = new(); private readonly OrderQueryService _queryService; private readonly HikDeviceService? _hik; private readonly HikStreamService? _stream; private readonly HikFfmpegService? _ffmpeg; private readonly HikPreviewService? _preview; private readonly HikNativePreviewService? _native; private CancellationTokenSource? _cts; private Task? _loop; /// /// 「按运单下载录像」服务(网页查件页也会调) /// /// 不注入时为 null → 接口回 503(老版本/没装 ffmpeg 的环境)。 /// public PlaybackDownloadService? PlaybackDownload { get; set; } /// 日志回调(服务线程 → UI 线程的桥,UI 那边自己 Dispatcher.Invoke) public event Action? Log; /// 网页请求唤起登录(`POST /api/activate-login`);服务线程触发,订阅方自己切 UI 线程 public event Action? LoginRequested; /// 当前是否已登录(由 App 提供,随 `/api/query` 一起返回) public Func? IsLoggedInProvider { get; set; } /// 当前登录用户显示名(由 App 提供,随 `/api/query` 一起返回) public Func? UserNameProvider { get; set; } /// 当前后端地址(由 App 提供,随 `/api/query` 一起返回,排障用) public Func? ServerBaseUrlProvider { get; set; } public LocalHttpServer(OrderQueryService queryService, HikDeviceService? hik = null) { _queryService = queryService; _hik = hik; if (hik is not null) { _stream = new HikStreamService(hik); _ffmpeg = new HikFfmpegService(); _preview = new HikPreviewService(hik, _stream, _ffmpeg); _native = new HikNativePreviewService(_stream); } } /// 是否已登录(网页靠它判断要不要唤起登录) public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false; /// 浏览器里可直接打开的地址 public string BaseUrl => $"http://localhost:{Port}"; public bool IsRunning => _listener.IsListening; /// 启动监听;失败抛 (端口被占 / 没权限) public void Start() { if (IsRunning) return; _listener.Prefixes.Clear(); // 两个都监听:前端页面默认用 localhost,但改 VITE_LOCAL_SERVICE 用 127.0.0.1 时也得能连 // (HttpListener 只接受 "注册过的 host",否则直接 400) _listener.Prefixes.Add($"{BaseUrl}/"); _listener.Prefixes.Add($"http://127.0.0.1:{Port}/"); _listener.Start(); _cts = new CancellationTokenSource(); _loop = Task.Run(() => AcceptLoopAsync(_cts.Token)); Log?.Invoke($"服务已启动:{BaseUrl}"); } public void Stop() { if (!IsRunning) return; try { _cts?.Cancel(); _listener.Stop(); _listener.Close(); } catch (Exception ex) { Log?.Invoke($"停止服务时出错:{ex.Message}"); } finally { Log?.Invoke("服务已停止"); } } private async Task AcceptLoopAsync(CancellationToken token) { while (!token.IsCancellationRequested && _listener.IsListening) { HttpListenerContext context; try { context = await _listener.GetContextAsync().ConfigureAwait(false); } catch (Exception) { // Stop()/Close() 会让 GetContextAsync 抛异常,属于正常退出路径 break; } _ = Task.Run(() => HandleAsync(context), CancellationToken.None); } } private async Task HandleAsync(HttpListenerContext context) { var request = context.Request; var response = context.Response; try { WriteCorsHeaders(request, response); // 预检请求(含 PNA 预检)直接放行 if (request.HttpMethod.Equals("OPTIONS", StringComparison.OrdinalIgnoreCase)) { response.StatusCode = 204; response.Close(); return; } var path = request.Url?.AbsolutePath ?? "/"; Log?.Invoke($"{request.HttpMethod} {path} ← {request.RemoteEndPoint?.Address}"); // 网页请求唤起登录(POST,避免被浏览器的链接预取误触发) if (path.Equals("/api/activate-login", StringComparison.OrdinalIgnoreCase)) { if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false); return; } Log?.Invoke("网页请求唤起登录"); LoginRequested?.Invoke(); await WriteJsonAsync(response, 200, new { ok = true, loggedIn = IsLoggedIn, message = IsLoggedIn ? "已登录,已把主界面唤到前台" : "已请求本机软件显示登录窗口", }).ConfigureAwait(false); return; } // 海康设备通道:POST JSON {host,port,user,password} 或 GET ?host=&port=&user=&password= // 走 HCNetSDK 的 8000 私有协议登录,成功后读 IP 接入配置返回通道列表 if (path.Equals("/api/hik/channels", StringComparison.OrdinalIgnoreCase)) { await HandleHikChannelsAsync(request, response).ConfigureAwait(false); return; } // 海康实时预览:建会话 → MJPEG 拉流 / 单帧快照 if (path.StartsWith("/api/hik/preview", StringComparison.OrdinalIgnoreCase)) { await HandleHikPreviewAsync(request, response, path).ConfigureAwait(false); return; } // 海康云台:POST /api/hik/ptz(方向/变倍/聚焦/光圈)与 /api/hik/ptz/preset(预置点) if (path.Equals("/api/hik/ptz", StringComparison.OrdinalIgnoreCase) || path.Equals("/api/hik/ptz/preset", StringComparison.OrdinalIgnoreCase)) { await HandleHikPtzAsync(request, response, path).ConfigureAwait(false); return; } // 按运单下载录像:POST /api/playback/download { code } // 网页查件页(/local?code=)用 —— 任何装了本机软件的电脑都能下,存到本机设置的目录 if (path.Equals("/api/playback/download", StringComparison.OrdinalIgnoreCase)) { await HandlePlaybackDownloadAsync(request, response).ConfigureAwait(false); return; } if (!request.HttpMethod.Equals("GET", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 GET" }).ConfigureAwait(false); return; } const string queryPrefix = "/api/query/"; if (path.StartsWith(queryPrefix, StringComparison.OrdinalIgnoreCase)) { // 一个接口把「软件在跑吗 / 登录了吗 / 查到什么」全返回 —— // 网页只发一次请求就能决定展示结果还是提示“唤起”,不会出现“探活通过、真正查询时软件已退出”的错位。 var code = Uri.UnescapeDataString(path[queryPrefix.Length..]).Trim(); var loggedIn = IsLoggedIn; var user = UserNameProvider?.Invoke(); var env = BuildInfo.Environment; var server = ServerBaseUrlProvider?.Invoke(); if (!loggedIn) { await WriteJsonAsync(response, 401, new { ok = false, state = "need-login", code, loggedIn = false, user, env, server, message = "本机软件未登录,请先在软件里登录", }).ConfigureAwait(false); return; } var result = (await _queryService.QueryAsync(code).ConfigureAwait(false)).Http; if (result.Ok) { await WriteJsonAsync(response, 200, new { ok = true, state = "ok", code, loggedIn, user, env, server, data = result.Data, }).ConfigureAwait(false); return; } var state = result.StatusCode switch { 400 => "bad-request", 404 => "not-found", 401 => "need-login", _ => "error", }; await WriteJsonAsync(response, result.StatusCode, new { ok = false, state, code, loggedIn, user, env, server, message = result.Message, }).ConfigureAwait(false); return; } // 浏览器直接打开本机服务时给一个说明页(方便排查、也是手工测试入口) if (path == "/" || path.Equals("/index.html", StringComparison.OrdinalIgnoreCase)) { var html = """ 云仓视频溯源软件(本机服务)

云仓视频溯源软件(本机服务)

服务运行中,只监听本机(127.0.0.1:17300)。

  • /api/query/{运单号} 查询(同时返回服务/登录状态;没登录回 401)
  • POST /api/activate-login 把登录窗叫到前台
  • POST /api/hik/channels 读取海康设备通道(body:{"host":"192.168.8.241","port":8000,"user":"admin","password":"***"})
  • POST /api/hik/preview 建预览会话(body 同 channels,加 channel)→ 返回 mjpegUrl / snapshotUrl / rtspUrl
  • POST /api/hik/ptz 云台连续动作(command=up/down/left/right/zoom-in…,stop=true 停止)
  • POST /api/hik/ptz/preset 预置点(action=set/goto/clear,preset=1~256)
"""; await WriteHtmlAsync(response, 200, html).ConfigureAwait(false); return; } await WriteJsonAsync(response, 404, new { ok = false, message = "接口不存在" }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"处理请求出错:{ex.Message}"); try { await WriteJsonAsync(response, 500, new { ok = false, message = "本机服务内部错误" }).ConfigureAwait(false); } catch { // 响应已经发出去 / 连接断了,忽略 } } finally { try { response.Close(); } catch { // 忽略 } } } /// /// 按运单下载录像:POST /api/playback/download,body { "code": "运单号" } /// /// 网页查件页(`/local?code=`)用:**任何装了本机软件的电脑**都能查件并下载录像, /// 存到**这台电脑自己设置的目录**(`~/packVideo/年/月/日/`),跟"是不是设备服务器"无关。 /// private async Task HandlePlaybackDownloadAsync(HttpListenerRequest request, HttpListenerResponse response) { if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false); return; } if (!IsLoggedIn) { await WriteJsonAsync(response, 401, new { ok = false, state = "need-login", loggedIn = false, message = "本机软件未登录,请先在软件里登录", }).ConfigureAwait(false); return; } var service = PlaybackDownload; if (service is null) { await WriteJsonAsync(response, 503, new { ok = false, state = "unsupported", message = "本机软件没有启用录像下载(请升级到 1.0.54+)", }).ConfigureAwait(false); return; } string code; try { using var reader = new StreamReader(request.InputStream, request.ContentEncoding ?? Encoding.UTF8); var body = await reader.ReadToEndAsync().ConfigureAwait(false); using var document = JsonDocument.Parse(string.IsNullOrWhiteSpace(body) ? "{}" : body); code = ReadJsonString(document.RootElement, "code") ?? string.Empty; } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } if (string.IsNullOrWhiteSpace(code)) { await WriteJsonAsync(response, 400, new { ok = false, message = "缺少运单号(code)" }).ConfigureAwait(false); return; } var started = DateTime.UtcNow; Log?.Invoke($"网页请求下载录像:{code}"); try { var result = await service.DownloadAsync(code.Trim()).ConfigureAwait(false); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", code, folder = result.Folder, merged = result.Merged, segments = result.Segments, warnings = result.Warnings, elapsedMs = (int)(DateTime.UtcNow - started).TotalMilliseconds, }).ConfigureAwait(false); } catch (InvalidOperationException ex) { // 「没有可下载的流 / 未登录 / 密码没填」这类,直接把话说清楚 await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message, }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"下载录像失败:{ex.Message}"); await WriteJsonAsync(response, 500, new { ok = false, state = "error", message = ex.Message, }).ConfigureAwait(false); } } /// /// 海康设备通道接口:POST /api/hik/channels(JSON)或 GET /api/hik/channels?host=&port=&user=&password=。 /// /// 走 HCNetSDK 的 8000 私有协议登录 → 读 NET_DVR_GET_IPPARACFG_V40 → 返回通道列表。 /// 会话在 里池化复用,本接口**不会**每次登录。 /// private async Task HandleHikChannelsAsync(HttpListenerRequest request, HttpListenerResponse response) { if (_hik is null) { await WriteJsonAsync(response, 503, new { ok = false, message = "本机服务未启用海康 SDK 支持" }).ConfigureAwait(false); return; } string? host = null; string? user = null; string? password = null; var port = 8000; var webPort = 80; try { if (request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { if (request.ContentLength64 > 8192) { await WriteJsonAsync(response, 413, new { ok = false, message = "请求体过大" }).ConfigureAwait(false); return; } string body; using (var reader = new StreamReader(request.InputStream, request.ContentEncoding ?? Encoding.UTF8)) { body = await reader.ReadToEndAsync().ConfigureAwait(false); } if (body.Trim().Length == 0) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不能为空" }).ConfigureAwait(false); return; } using var document = JsonDocument.Parse(body); var root = document.RootElement; host = ReadJsonString(root, "host") ?? ReadJsonString(root, "ip"); user = ReadJsonString(root, "user") ?? ReadJsonString(root, "username") ?? ReadJsonString(root, "account"); password = ReadJsonString(root, "password") ?? ReadJsonString(root, "pwd"); if (root.TryGetProperty("port", out var portElement)) { if (portElement.ValueKind == JsonValueKind.Number && portElement.TryGetInt32(out var number)) port = number; else if (portElement.ValueKind == JsonValueKind.String && int.TryParse(portElement.GetString(), out var parsed)) port = parsed; } if (root.TryGetProperty("webPort", out var webPortElement)) { if (webPortElement.ValueKind == JsonValueKind.Number && webPortElement.TryGetInt32(out var webNumber)) webPort = webNumber; else if (webPortElement.ValueKind == JsonValueKind.String && int.TryParse(webPortElement.GetString(), out var webParsed)) webPort = webParsed; } } else if (request.HttpMethod.Equals("GET", StringComparison.OrdinalIgnoreCase)) { var query = request.QueryString; host = query["host"] ?? query["ip"]; user = query["user"] ?? query["username"]; password = query["password"] ?? query["pwd"]; if (int.TryParse(query["port"], out var parsed)) port = parsed; if (int.TryParse(query["webPort"], out var parsedWeb)) webPort = parsedWeb; } else { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 POST / GET" }).ConfigureAwait(false); return; } } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } try { var data = await Task.Run(() => _hik.GetChannels(host ?? string.Empty, port, user ?? string.Empty, password ?? string.Empty, webPort)) .ConfigureAwait(false); Log?.Invoke($"海康通道读取成功:{data.endpoint},通道 {data.channels.Count} 个,耗时 {data.elapsedMs}ms(会话复用={data.sessionReused})"); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", data, }).ConfigureAwait(false); } catch (ArgumentException ex) { await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message }).ConfigureAwait(false); } catch (HikException ex) { Log?.Invoke($"海康通道读取失败:{ex.Message}"); await WriteJsonAsync(response, 502, new { ok = false, state = "hik-error", lastError = ex.ErrorCode, message = ex.Message, }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"海康通道读取异常:{ex}"); await WriteJsonAsync(response, 500, new { ok = false, message = "读取通道失败" }).ConfigureAwait(false); } } /// /// 海康实时预览(`/api/hik/preview*`) /// /// 三个动作: /// - POST /api/hik/preview:body `{host, port, user, password, channel, fps?, logicalChannel?}` → 建会话 /// - GET /api/hik/preview/snapshot?sid=:单帧 JPEG /// - GET /api/hik/preview/mjpeg?sid=&fps=:multipart/x-mixed-replace 连续帧,浏览器 <img> 直接能放 /// - DELETE /api/hik/preview?sid=:释放会话 /// /// 为什么用 MJPEG:浏览器不认 RTSP,转 HLS/WebRTC 需要额外转码进程;而 /// NET_DVR_CaptureJPEGPicture_NEW 拿到的就是 JPEG,推流侧零依赖。 /// private async Task HandleHikPreviewAsync(HttpListenerRequest request, HttpListenerResponse response, string path) { if (_hik is null || _preview is null) { await WriteJsonAsync(response, 503, new { ok = false, message = "本机服务未启用海康 SDK 支持" }).ConfigureAwait(false); return; } var isCreate = path.Equals("/api/hik/preview", StringComparison.OrdinalIgnoreCase); var isClose = path.Equals("/api/hik/preview/close", StringComparison.OrdinalIgnoreCase); var isSnapshot = path.Equals("/api/hik/preview/snapshot", StringComparison.OrdinalIgnoreCase); var isMjpeg = path.Equals("/api/hik/preview/mjpeg", StringComparison.OrdinalIgnoreCase); var isWindow = path.Equals("/api/hik/preview/window", StringComparison.OrdinalIgnoreCase); var isWindowClose = path.Equals("/api/hik/preview/window/close", StringComparison.OrdinalIgnoreCase); if (!isCreate && !isClose && !isSnapshot && !isMjpeg && !isWindow && !isWindowClose) { await WriteJsonAsync(response, 404, new { ok = false, message = "接口不存在" }).ConfigureAwait(false); return; } // ---------- 网页关闭时用 navigator.sendBeacon 释放(只能 POST) ---------- if (isClose) { var removed = _preview.Remove(request.QueryString["sid"]); await WriteJsonAsync(response, 200, new { ok = true, removed }).ConfigureAwait(false); return; } // ---------- 满帧率原生窗口(解码器直接画到窗口,25fps) ---------- if (isWindow || isWindowClose) { await HandleHikPreviewWindowAsync(request, response, isWindowClose).ConfigureAwait(false); return; } // ---------- 建会话 / 释放会话 ---------- if (isCreate) { if (request.HttpMethod.Equals("DELETE", StringComparison.OrdinalIgnoreCase)) { var sidDelete = request.QueryString["sid"]; var removed = _preview.Remove(sidDelete); await WriteJsonAsync(response, 200, new { ok = true, removed }).ConfigureAwait(false); return; } if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 POST / DELETE" }).ConfigureAwait(false); return; } string host = string.Empty, user = string.Empty, password = string.Empty; var port = 8000; var channel = 0; var fps = 25; int? logicalChannel = null; string? name = null; var streamType = 0; // 0-主码流(默认) 1-子码流 var mode = "stream"; // ffmpeg / stream / capture try { var (body, error) = await ReadJsonBodyAsync(request).ConfigureAwait(false); if (error is not null) { await WriteJsonAsync(response, 400, new { ok = false, message = error }).ConfigureAwait(false); return; } using var document = JsonDocument.Parse(body!); var root = document.RootElement; host = ReadJsonString(root, "host") ?? ReadJsonString(root, "ip") ?? string.Empty; user = ReadJsonString(root, "user") ?? ReadJsonString(root, "username") ?? ReadJsonString(root, "account") ?? string.Empty; password = ReadJsonString(root, "password") ?? ReadJsonString(root, "pwd") ?? string.Empty; name = ReadJsonString(root, "name"); port = ReadJsonInt(root, "port") ?? 8000; channel = ReadJsonInt(root, "channel") ?? ReadJsonInt(root, "channelNo") ?? 0; fps = ReadJsonInt(root, "fps") ?? 25; logicalChannel = ReadJsonInt(root, "logicalChannel"); streamType = ReadJsonInt(root, "streamType") ?? 0; // mode:ffmpeg(主码流转码)/ stream(SDK 取流解码)/ capture(设备抓帧) var modeText = ReadJsonString(root, "mode"); if (!string.IsNullOrWhiteSpace(modeText)) mode = modeText.Trim().ToLowerInvariant(); } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } try { var session = await Task.Run(() => _preview.Create(host, port, user, password, channel, fps, logicalChannel, name, mode, streamType)).ConfigureAwait(false); Log?.Invoke($"预览开始:{session.Host}:{session.Port} 通道 {session.Channel}(码流 {session.StreamId},{session.Fps}fps,{session.Mode},sid={session.Id})"); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", data = new { sid = session.Id, host = session.Host, port = session.Port, channel = session.Channel, logicalChannel = session.LogicalChannel, streamId = session.StreamId, fps = session.Fps, name = session.Name, // stream/ffmpeg = 可到 25fps;capture = 设备抓帧(约 5fps) mode = session.Mode, streamType = session.StreamType, maxFps = session.Mode == "capture" ? 5 : 25, ffmpegAvailable = _ffmpeg?.IsAvailable ?? false, warning = session.Warning, rtspUrl = session.RtspUrl, mjpegUrl = $"/api/hik/preview/mjpeg?sid={session.Id}", snapshotUrl = $"/api/hik/preview/snapshot?sid={session.Id}", expireAt = session.ExpiresAt.ToString("yyyy-MM-dd HH:mm:ss"), }, }).ConfigureAwait(false); return; } catch (ArgumentException ex) { await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message }).ConfigureAwait(false); return; } catch (HikException ex) { Log?.Invoke($"预览建会话失败:{ex.Message}"); await WriteJsonAsync(response, 502, new { ok = false, state = "hik-error", lastError = ex.ErrorCode, message = ex.Message, }).ConfigureAwait(false); return; } catch (Exception ex) { Log?.Invoke($"预览建会话异常:{ex}"); await WriteJsonAsync(response, 500, new { ok = false, message = "建立预览会话失败" }).ConfigureAwait(false); return; } } // ---------- 以下需要 sid ---------- if (!request.HttpMethod.Equals("GET", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 GET" }).ConfigureAwait(false); return; } var sid = request.QueryString["sid"]; var sessionNow = _preview.Get(sid); if (sessionNow is null) { await WriteJsonAsync(response, 404, new { ok = false, state = "session-expired", message = "预览会话不存在或已过期,请重新打开预览", }).ConfigureAwait(false); return; } if (isSnapshot) { try { var jpeg = await Task.Run(() => _preview.CaptureFrame(sessionNow)).ConfigureAwait(false); response.StatusCode = 200; response.ContentType = "image/jpeg"; response.Headers["Cache-Control"] = "no-store, no-cache, must-revalidate"; response.ContentLength64 = jpeg.Length; await response.OutputStream.WriteAsync(jpeg).ConfigureAwait(false); } catch (HikException ex) { Log?.Invoke($"预览快照失败:{ex.Message}"); await WriteJsonAsync(response, 502, new { ok = false, state = "hik-error", lastError = ex.ErrorCode, message = ex.Message }).ConfigureAwait(false); } return; } await WriteMjpegAsync(request, response, sessionNow).ConfigureAwait(false); } /// /// 连续推 JPEG 帧:multipart/x-mixed-replace /// /// 浏览器(Chrome/Edge)对 MJPEG 的 <img> 支持一直很稳; /// 客户端一关页面写入就会抛 IO 异常,这里直接停止抓帧,避免空转。 /// private async Task WriteMjpegAsync(HttpListenerRequest request, HttpListenerResponse response, HikPreviewSession session) { if (_preview is null) return; // 允许浏览器用 ?fps= 临时降/提帧(大屏 10fps 就够,看细节可到 25) var fpsOverride = int.TryParse(request.QueryString["fps"], out var parsed) ? parsed : 0; var fps = Math.Clamp(fpsOverride > 0 ? fpsOverride : session.Fps, 1, 25); var frameInterval = 1000.0 / fps; // 毫秒/帧 response.StatusCode = 200; response.ContentType = "multipart/x-mixed-replace; boundary=frame"; response.Headers["Cache-Control"] = "no-store, no-cache, must-revalidate"; response.Headers["Pragma"] = "no-cache"; response.SendChunked = true; var output = response.OutputStream; var crlf = Encoding.ASCII.GetBytes("\r\n"); // 按「绝对时间轴」配速(不是每帧之后再睡 40ms): // 抓帧本身约 33ms,若写成 sleep(间隔 - 耗时) 会累积误差,实测只有 ~21fps;绝对时间轴能锁住 25fps。 var clock = System.Diagnostics.Stopwatch.StartNew(); var nextFrameAt = 0.0; try { while (true) { // 会话过期(30 分钟没人看)或被 DELETE 掉就收工 if (_preview.Get(session.Id) is null) break; byte[] jpeg; try { jpeg = await Task.Run(() => _preview.CaptureFrame(session)).ConfigureAwait(false); } catch (HikException ex) { Log?.Invoke($"预览中断:通道 {session.Channel} {ex.Message}"); break; } // 解码端口刚起来时可能还没出帧,跳过这轮即可(不要断流) if (jpeg.Length == 0) { await Task.Delay(15).ConfigureAwait(false); continue; } var header = Encoding.ASCII.GetBytes( $"--frame\r\nContent-Type: image/jpeg\r\nContent-Length: {jpeg.Length}\r\n\r\n"); await output.WriteAsync(header).ConfigureAwait(false); await output.WriteAsync(jpeg).ConfigureAwait(false); await output.WriteAsync(crlf).ConfigureAwait(false); await output.FlushAsync().ConfigureAwait(false); nextFrameAt += frameInterval; var delay = nextFrameAt - clock.Elapsed.TotalMilliseconds; if (delay > 0) await Task.Delay((int)Math.Round(delay)).ConfigureAwait(false); else nextFrameAt = clock.Elapsed.TotalMilliseconds; // 已经落后就不追,重新对齐 } } catch (Exception ex) { // 浏览器关掉预览(img 换 src / 关弹窗)→ 写入失败,属于正常结束 Log?.Invoke($"预览流结束:通道 {session.Channel}({ex.GetType().Name})"); } finally { try { response.Abort(); } catch { /* 忽略 */ } } } /// 读 JSON 请求体(超过 8KB 或为空都算错误) private static async Task<(string? Body, string? Error)> ReadJsonBodyAsync(HttpListenerRequest request) { if (request.ContentLength64 > 8192) return (null, "请求体过大"); using var reader = new StreamReader(request.InputStream, request.ContentEncoding ?? Encoding.UTF8); var body = await reader.ReadToEndAsync().ConfigureAwait(false); if (body.Trim().Length == 0) return (null, "请求体不能为空"); return (body, null); } private static int? ReadJsonInt(JsonElement root, string name) { if (!root.TryGetProperty(name, out var element)) return null; if (element.ValueKind == JsonValueKind.Number && element.TryGetInt32(out var number)) return number; if (element.ValueKind == JsonValueKind.String && int.TryParse(element.GetString(), out var parsed)) return parsed; return null; } /// /// 满帧率原生窗口:POST /api/hik/preview/window 打开,DELETE ...?wid= 关闭 /// /// 浏览器内嵌画面必须逐帧转 JPEG,1080p 每帧编码约 140ms(上限约 7fps); /// 这个接口让 PlayM4 直接把画面画到一个原生窗口,能跑满设备帧率(25fps)。 /// private async Task HandleHikPreviewWindowAsync(HttpListenerRequest request, HttpListenerResponse response, bool isClose) { if (_native is null) { await WriteJsonAsync(response, 503, new { ok = false, message = "本机服务未启用海康 SDK 支持" }).ConfigureAwait(false); return; } // 关窗口:DELETE 或 POST(后者给 navigator.sendBeacon 用,它只能发 POST) if (isClose || request.HttpMethod.Equals("DELETE", StringComparison.OrdinalIgnoreCase)) { var wid = request.QueryString["wid"]; var closed = _native.Close(wid); await WriteJsonAsync(response, 200, new { ok = true, closed }).ConfigureAwait(false); return; } if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 POST / DELETE" }).ConfigureAwait(false); return; } string host = string.Empty, user = string.Empty, password = string.Empty; var port = 8000; var channel = 0; var streamType = 0; string? name = null; try { var (body, error) = await ReadJsonBodyAsync(request).ConfigureAwait(false); if (error is not null) { await WriteJsonAsync(response, 400, new { ok = false, message = error }).ConfigureAwait(false); return; } using var document = JsonDocument.Parse(body!); var root = document.RootElement; host = ReadJsonString(root, "host") ?? ReadJsonString(root, "ip") ?? string.Empty; user = ReadJsonString(root, "user") ?? ReadJsonString(root, "username") ?? string.Empty; password = ReadJsonString(root, "password") ?? ReadJsonString(root, "pwd") ?? string.Empty; name = ReadJsonString(root, "name"); port = ReadJsonInt(root, "port") ?? 8000; channel = ReadJsonInt(root, "channel") ?? ReadJsonInt(root, "channelNo") ?? 0; streamType = ReadJsonInt(root, "streamType") ?? 1; } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } try { var preview = _native.Open(host, port, user, password, channel, streamType, name); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", data = new { wid = preview.Id, host = preview.Host, channel = preview.Channel, streamType = preview.StreamType, mode = "window", fps = 25, message = "已在本机软件里打开满帧率预览窗口", }, }).ConfigureAwait(false); } catch (ArgumentException ex) { await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message }).ConfigureAwait(false); } catch (HikException ex) { Log?.Invoke($"满帧率预览失败:{ex.Message}"); await WriteJsonAsync(response, 502, new { ok = false, state = "hik-error", lastError = ex.ErrorCode, message = ex.Message, }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"满帧率预览异常:{ex}"); await WriteJsonAsync(response, 500, new { ok = false, message = $"打开预览窗口失败:{ex.Message}" }).ConfigureAwait(false); } } /// /// 云台控制:POST /api/hik/ptz / POST /api/hik/ptz/preset /// /// body:{host, port, user, password, channel, command?, stop?, speed?, action?, preset?} /// - command:up/down/left/right/up-left/up-right/down-left/down-right/zoom-in/zoom-out/ /// focus-near/focus-far/iris-open/iris-close/auto(自动扫描) /// - stop:true 停止(页面松开按钮时发);方向类是“开始 + 停止”成对调用 /// - 预置点:action=set/goto/clear,preset=1~256 /// /// 走 NET_DVR_PTZControlWithSpeed_Other,不需要开预览也能控。 /// private async Task HandleHikPtzAsync(HttpListenerRequest request, HttpListenerResponse response, string path) { if (_hik is null) { await WriteJsonAsync(response, 503, new { ok = false, message = "本机服务未启用海康 SDK 支持" }).ConfigureAwait(false); return; } if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "只支持 POST" }).ConfigureAwait(false); return; } string host = string.Empty, user = string.Empty, password = string.Empty; var port = 8000; var channel = 0; var speed = 4; string? command = null; string? action = null; var preset = 0; var stop = false; try { var (body, error) = await ReadJsonBodyAsync(request).ConfigureAwait(false); if (error is not null) { await WriteJsonAsync(response, 400, new { ok = false, message = error }).ConfigureAwait(false); return; } using var document = JsonDocument.Parse(body!); var root = document.RootElement; host = ReadJsonString(root, "host") ?? ReadJsonString(root, "ip") ?? string.Empty; user = ReadJsonString(root, "user") ?? ReadJsonString(root, "username") ?? string.Empty; password = ReadJsonString(root, "password") ?? ReadJsonString(root, "pwd") ?? string.Empty; command = ReadJsonString(root, "command"); action = ReadJsonString(root, "action"); port = ReadJsonInt(root, "port") ?? 8000; channel = ReadJsonInt(root, "channel") ?? ReadJsonInt(root, "channelNo") ?? 0; speed = ReadJsonInt(root, "speed") ?? 4; preset = ReadJsonInt(root, "preset") ?? 0; if (root.TryGetProperty("stop", out var stopElement)) { stop = stopElement.ValueKind switch { JsonValueKind.True => true, JsonValueKind.False => false, JsonValueKind.Number => stopElement.TryGetInt32(out var number) && number != 0, JsonValueKind.String => string.Equals(stopElement.GetString(), "true", StringComparison.OrdinalIgnoreCase), _ => false, }; } } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } var isPreset = path.EndsWith("/preset", StringComparison.OrdinalIgnoreCase); try { await Task.Run(() => { if (isPreset) { _hik.PtzPreset(host, port, user, password, channel, action ?? string.Empty, preset); } else { _hik.PtzControl(host, port, user, password, channel, command ?? string.Empty, stop, speed); } }).ConfigureAwait(false); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", data = new { channel, command, action, preset, stop }, }).ConfigureAwait(false); } catch (ArgumentException ex) { await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message }).ConfigureAwait(false); } catch (HikException ex) { Log?.Invoke($"云台操作失败(通道 {channel}):{ex.Message}"); await WriteJsonAsync(response, 502, new { ok = false, state = "hik-error", lastError = ex.ErrorCode, message = ex.Message, }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"云台操作异常:{ex}"); await WriteJsonAsync(response, 500, new { ok = false, message = "云台操作失败" }).ConfigureAwait(false); } } private static string? ReadJsonString(JsonElement root, string name) => root.TryGetProperty(name, out var element) && element.ValueKind == JsonValueKind.String ? element.GetString() : null; /// CORS + 私有网络访问(PNA)头 private static void WriteCorsHeaders(HttpListenerRequest request, HttpListenerResponse response) { // 回显 Origin(比写死 * 更稳:以后要带 cookie/凭据也能用) var origin = request.Headers["Origin"]; response.Headers["Access-Control-Allow-Origin"] = string.IsNullOrEmpty(origin) ? "*" : origin; response.Headers["Vary"] = "Origin"; // DELETE 用于关闭预览会话;漏了它浏览器预检直接失败(实测现象:关弹窗时 console 报 CORS) response.Headers["Access-Control-Allow-Methods"] = "GET, POST, DELETE, OPTIONS"; response.Headers["Access-Control-Allow-Headers"] = "Content-Type, Accept"; response.Headers["Access-Control-Max-Age"] = "600"; // 公网页面访问 localhost 时,Chrome 会带 Access-Control-Request-Private-Network: true if (string.Equals(request.Headers["Access-Control-Request-Private-Network"], "true", StringComparison.OrdinalIgnoreCase)) { response.Headers["Access-Control-Allow-Private-Network"] = "true"; } } private static async Task WriteJsonAsync(HttpListenerResponse response, int statusCode, object? payload) { var body = JsonUtil.ToJson(payload); await WriteTextAsync(response, statusCode, "application/json; charset=utf-8", body).ConfigureAwait(false); } private static async Task WriteHtmlAsync(HttpListenerResponse response, int statusCode, string html) { await WriteTextAsync(response, statusCode, "text/html; charset=utf-8", html).ConfigureAwait(false); } private static async Task WriteTextAsync(HttpListenerResponse response, int statusCode, string contentType, string body) { var bytes = Encoding.UTF8.GetBytes(body); response.StatusCode = statusCode; response.ContentType = contentType; response.ContentEncoding = Encoding.UTF8; response.Headers["Cache-Control"] = "no-store"; response.ContentLength64 = bytes.Length; await response.OutputStream.WriteAsync(bytes).ConfigureAwait(false); } public void Dispose() { Stop(); _cts?.Dispose(); _native?.Dispose(); _preview?.Dispose(); _ffmpeg?.Dispose(); _stream?.Dispose(); _listener.Close(); } }