? 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();
}
}