把海康取流从扫码服务主进程拆到 --hik-worker 子进程,原生 SDK 崩溃
不再连带扫码收码;新增局域网询问-应答与跨网下载通道。
隔离与守护
- 新增 HikWorker(子进程):独占 HCNetSDK 与 NVR 会话池
- 新增 HikWorkerSupervisor(主进程):懒启动、管道通信、
5 分钟内失败 3 次熔断 10 分钟
- 管道协议为 [4 字节长度][JSON],进程退出即知,不占端口
- ServiceInstaller 复制 native(HCNetSDK/ffmpeg),先删后拷,
避免 SDK 升级残留旧 DLL;安装时放行 TCP 17311 / UDP 17310
局域网询问-应答(不是主动公告)
- UDP 17310 收询问,只回同 subjectId;带了 nvrHosts 时先实测可达,
连不上就不应答,让查询机继续走本机
- 应答带 TCP 17311,查询机一次连接即可判定是否同 LAN
跨网下载
- TCP 17311 提供 /health、/probe、/download、/download/{id}
- 除 /health 外均要求 X-Edge-Subject 且与配置主体一致
- 成片在传输完成后立即删除,另有 done 10 分钟 / failed 15 分钟
TTL 兜底,避免现场磁盘被临时文件吃满
桌面端选路
- DownloadAsync 先探 NVR 8000(600ms):通则沿用原有本机直连,
不通才广播找取流服务,取回后落到本机录像目录
- DownloadByPlanAsync 拆分:不查库、不需要用户令牌,
供只有设备令牌的服务端复用
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
421 lines
17 KiB
C#
421 lines
17 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using System.IO;
|
||
using System.Linq;
|
||
using System.Net.Sockets;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
using YuncangTrace.LocalService.Services.Edge;
|
||
using YuncangTrace.LocalService.Services.Hik;
|
||
|
||
namespace YuncangTrace.LocalService.Services;
|
||
|
||
/// <summary>下载结果(HTTP 接口与桌面端共用)</summary>
|
||
/// <param name="Folder">最终存放目录(`{录像根}/yyyy/MM/dd`)</param>
|
||
/// <param name="Merged">合并后的成片路径(单路时就是那一路的路径)</param>
|
||
/// <param name="Segments">各路段文件(合并失败时才有多个,且都已搬到用户目录)</param>
|
||
/// <param name="Warnings">非致命问题(某路没下到等)</param>
|
||
public sealed record PlaybackDownloadResult(
|
||
string Folder,
|
||
string? Merged,
|
||
IReadOnlyList<string> Segments,
|
||
IReadOnlyList<string> Warnings);
|
||
|
||
/// <summary>
|
||
/// 按 NVR id 取登录凭据。
|
||
///
|
||
/// 桌面端走用户令牌调后端;后台扫码服务只有设备令牌,走云端下发或本地缓存。
|
||
/// 单独抽成委托,是为了让「按流计划下载」这件事不依赖登录态。
|
||
/// </summary>
|
||
public delegate Task<NvrCredential> NvrCredentialProvider(int nvrId, CancellationToken ct);
|
||
|
||
/// <summary>
|
||
/// 「按运单下载录像」的完整流程(**与界面无关**,桌面端和网页查件都走它)
|
||
///
|
||
/// 1. `pack-query` 拿到回放计划(扫码当时的工作台快照);
|
||
/// 2. 逐路下载到 **临时目录**(并发 2 路,8000 全速拉流优先、失败回落 RTSP);
|
||
/// 3. 多路按工作台画布布局**自动合并**成一个视频;
|
||
/// 4. 成片放到 `{录像根}/年/月/日/`,删掉临时片段。
|
||
///
|
||
/// 关键点:**录像存储路径是每台机器自己的设置**,跟"是不是设备服务器"无关 ——
|
||
/// 任何装了本机软件的电脑,查件后都能下载到自己配的目录里。
|
||
/// </summary>
|
||
public sealed class PlaybackDownloadService
|
||
{
|
||
/// <summary>同时下载几路(给 NVR 回放连接留余量)</summary>
|
||
private const int MaxParallel = 2;
|
||
|
||
private readonly OrderQueryService _query;
|
||
private readonly HikPlaybackService _playback;
|
||
private readonly Func<ApiClient?> _api;
|
||
private readonly Func<int> _subjectId;
|
||
private readonly Func<string?> _token;
|
||
private readonly Func<string> _root;
|
||
|
||
public PlaybackDownloadService(
|
||
OrderQueryService query,
|
||
HikPlaybackService playback,
|
||
Func<ApiClient?> apiProvider,
|
||
Func<int> subjectIdProvider,
|
||
Func<string?> tokenProvider,
|
||
Func<string> videoRootProvider)
|
||
{
|
||
_query = query;
|
||
_playback = playback;
|
||
_api = apiProvider;
|
||
_subjectId = subjectIdProvider;
|
||
_token = tokenProvider;
|
||
_root = videoRootProvider;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按运单号下载这段时间的录像(多路自动合并)
|
||
/// </summary>
|
||
/// <exception cref="InvalidOperationException">查询失败 / 没有可下载的流(message 可直接给用户看)</exception>
|
||
public async Task<PlaybackDownloadResult> DownloadAsync(string code, IProgress<string>? progress = null,
|
||
CancellationToken ct = default)
|
||
{
|
||
var outcome = await _query.QueryAsync(code, ct).ConfigureAwait(false);
|
||
if (!outcome.Http.Ok || outcome.Query is null)
|
||
{
|
||
throw new InvalidOperationException(outcome.Http.Message);
|
||
}
|
||
|
||
var query = outcome.Query;
|
||
if (!query.Playback || query.Records.Count == 0)
|
||
{
|
||
throw new InvalidOperationException("这个运单没有可下载的回放(扫码时该通道没绑定工作台)");
|
||
}
|
||
|
||
var streams = query.Records.SelectMany(item => item.Streams).ToList();
|
||
if (streams.Count == 0)
|
||
{
|
||
throw new InvalidOperationException("工作台没有绑定摄像头,没有可下载的流");
|
||
}
|
||
|
||
var scanTime = query.Records[0].ScanTime.LocalDateTime;
|
||
|
||
var nvrs = streams
|
||
.Select(item => (Host: item.NvrHost, item.NvrPort))
|
||
.Where(item => !string.IsNullOrWhiteSpace(item.Host))
|
||
.Distinct()
|
||
.ToList();
|
||
|
||
// 选路:本机能直连 NVR 就自己下(与以前行为完全一致);
|
||
// 连不上说明在别的网段 —— 找同主体的取流服务代取,取回来落到本机。
|
||
if (nvrs.Count > 0 && !await CanReachNvrAsync(nvrs[0].Host, nvrs[0].NvrPort, ct).ConfigureAwait(false))
|
||
{
|
||
var viaEdge = await TryDownloadViaEdgeAsync(code, streams, scanTime, nvrs, progress, ct)
|
||
.ConfigureAwait(false);
|
||
|
||
if (viaEdge is not null) return viaEdge;
|
||
|
||
progress?.Report("本机连不上录像机,也没有可用的取流服务,尝试直连…");
|
||
}
|
||
|
||
return await DownloadByPlanAsync(
|
||
code,
|
||
streams,
|
||
scanTime,
|
||
_root(),
|
||
FetchCredentialAsync,
|
||
progress,
|
||
ct).ConfigureAwait(false);
|
||
}
|
||
|
||
/// <summary>本机能不能连到这台 NVR(只判 TCP,不发设备协议)</summary>
|
||
private static async Task<bool> CanReachNvrAsync(string host, int port, CancellationToken ct)
|
||
{
|
||
try
|
||
{
|
||
using var tcp = new TcpClient();
|
||
using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
|
||
timeout.CancelAfter(TimeSpan.FromMilliseconds(600));
|
||
await tcp.ConnectAsync(host, port, timeout.Token).ConfigureAwait(false);
|
||
return tcp.Connected;
|
||
}
|
||
catch (OperationCanceledException) when (!ct.IsCancellationRequested)
|
||
{
|
||
return false;
|
||
}
|
||
catch
|
||
{
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 跨网路径:广播找同主体的取流服务 → 派任务 → 轮询 → 把成片拉回本机。
|
||
///
|
||
/// 返回 null 表示「没找到/没接单」,调用方继续走本机直连(保持原有失败语义)。
|
||
/// </summary>
|
||
private async Task<PlaybackDownloadResult?> TryDownloadViaEdgeAsync(
|
||
string code,
|
||
IReadOnlyList<PackStream> streams,
|
||
DateTime scanTime,
|
||
IReadOnlyList<(string Host, int Port)> nvrs,
|
||
IProgress<string>? progress,
|
||
CancellationToken ct)
|
||
{
|
||
var subjectId = _subjectId?.Invoke() ?? 0;
|
||
if (subjectId <= 0) return null;
|
||
|
||
progress?.Report("本机连不上录像机,正在查找取流服务…");
|
||
|
||
var peer = await EdgeDiscoveryClient.FindAsync(subjectId, nvrs, ct).ConfigureAwait(false);
|
||
if (peer is null) return null;
|
||
|
||
progress?.Report($"已找到取流服务 {peer.Display},正在下发任务…");
|
||
|
||
// 凭据仍从后端取:取流服务那边只有设备令牌,拿不到用户态凭据
|
||
var credentials = new List<NvrCredential>();
|
||
var seen = new HashSet<int>();
|
||
foreach (var stream in streams)
|
||
{
|
||
if (!seen.Add(stream.NvrId)) continue;
|
||
credentials.Add(await FetchCredentialAsync(stream.NvrId, ct).ConfigureAwait(false));
|
||
}
|
||
|
||
using var client = new EdgeClient(peer);
|
||
|
||
var taskId = await client.CreateDownloadAsync(code, streams, credentials, scanTime, ct)
|
||
.ConfigureAwait(false);
|
||
if (string.IsNullOrEmpty(taskId))
|
||
{
|
||
progress?.Report("取流服务拒绝了下载任务");
|
||
return null;
|
||
}
|
||
|
||
progress?.Report("取流服务已接单,等待下载与合并…");
|
||
|
||
var completed = false;
|
||
var deadline = DateTime.UtcNow.AddMinutes(15);
|
||
while (DateTime.UtcNow < deadline)
|
||
{
|
||
ct.ThrowIfCancellationRequested();
|
||
|
||
var status = await client.GetStatusAsync(taskId, ct).ConfigureAwait(false);
|
||
if (status is null)
|
||
{
|
||
progress?.Report("取流服务状态查询失败");
|
||
return null;
|
||
}
|
||
|
||
if (status.IsFailed) throw new InvalidOperationException(status.Error ?? "取流服务下载失败");
|
||
if (status.IsDone)
|
||
{
|
||
completed = true;
|
||
break;
|
||
}
|
||
|
||
if (!string.IsNullOrEmpty(status.Progress)) progress?.Report(status.Progress);
|
||
await Task.Delay(TimeSpan.FromSeconds(2), ct).ConfigureAwait(false);
|
||
}
|
||
|
||
if (!completed) throw new InvalidOperationException("等待取流服务超时(15 分钟)");
|
||
|
||
var folder = VideoStorage.FolderFor(_root(), scanTime);
|
||
Directory.CreateDirectory(folder);
|
||
var target = Path.Combine(folder, $"{Sanitize(code)}_取流_{DateTime.Now:yyyyMMdd_HHmmss}.mp4");
|
||
|
||
progress?.Report("正在接收成片…");
|
||
var size = await client.DownloadFileAsync(taskId, target, ct).ConfigureAwait(false);
|
||
progress?.Report($"已保存:{target}({size / 1024.0 / 1024.0:0.0} MB)");
|
||
|
||
return new PlaybackDownloadResult(folder, target, new[] { target }, new List<string>());
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按**流计划**下载并合并(不查库、不依赖用户令牌)
|
||
///
|
||
/// 桌面端由 <see cref="DownloadAsync"/> 查好计划再调进来;
|
||
/// 后台扫码服务只有设备令牌、调不了 `pack-query`,所以直接调这个。
|
||
/// </summary>
|
||
/// <param name="rootDir">成片根目录(桌面端用用户设置,服务端用 ProgramData 下的录像目录)</param>
|
||
/// <param name="credentialProvider">按 NVR id 取凭据(桌面端走 API,服务端走云端下发或本地缓存)</param>
|
||
public async Task<PlaybackDownloadResult> DownloadByPlanAsync(
|
||
string code,
|
||
IReadOnlyList<PackStream> streams,
|
||
DateTime scanTime,
|
||
string rootDir,
|
||
NvrCredentialProvider credentialProvider,
|
||
IProgress<string>? progress = null,
|
||
CancellationToken ct = default)
|
||
{
|
||
if (streams.Count == 0) throw new InvalidOperationException("没有可下载的流");
|
||
|
||
var folder = VideoStorage.FolderFor(rootDir, scanTime);
|
||
Directory.CreateDirectory(folder);
|
||
|
||
var stamp = DateTime.Now.ToString("yyyyMMdd_HHmmss");
|
||
var workDir = Path.Combine(Path.GetTempPath(), "YuncangTrace", "playback",
|
||
$"{Sanitize(code)}_{stamp}");
|
||
Directory.CreateDirectory(workDir);
|
||
|
||
var warnings = new List<string>();
|
||
var saved = new PlaybackClip?[streams.Count];
|
||
var gate = new SemaphoreSlim(MaxParallel);
|
||
var credentials = new Dictionary<int, NvrCredential>();
|
||
var credentialGate = new SemaphoreSlim(1, 1);
|
||
|
||
try
|
||
{
|
||
var tasks = new List<Task>();
|
||
for (var i = 0; i < streams.Count; i++)
|
||
{
|
||
var slot = i;
|
||
var stream = streams[i];
|
||
tasks.Add(Task.Run(async () =>
|
||
{
|
||
await gate.WaitAsync(ct).ConfigureAwait(false);
|
||
try
|
||
{
|
||
progress?.Report($"[{slot + 1}/{streams.Count}] {stream.DisplayName} 连接中…");
|
||
|
||
var credential = await CredentialAsync(stream.NvrId, credentials, credentialGate,
|
||
credentialProvider, ct).ConfigureAwait(false);
|
||
|
||
var name = $"{Sanitize(code)}_{stream.CameraId}_{stream.CameraName}"
|
||
+ $"_{stream.StartTime.ToLocalTime():yyyyMMdd_HHmmss}.mp4";
|
||
var path = Path.Combine(workDir, name);
|
||
|
||
var file = await _playback.DownloadAsync(credential.Host, credential.Port,
|
||
credential.Username, credential.Password, stream.ChannelNo,
|
||
stream.StartTime, stream.EndTime, path,
|
||
new Progress<PlaybackProgress>(p =>
|
||
progress?.Report($"[{slot + 1}/{streams.Count}] {stream.DisplayName} {p.Message}")),
|
||
ct).ConfigureAwait(false);
|
||
|
||
saved[slot] = file;
|
||
progress?.Report($"[{slot + 1}/{streams.Count}] {stream.DisplayName} ✓ 完成");
|
||
}
|
||
catch (OperationCanceledException)
|
||
{
|
||
throw;
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
warnings.Add($"{stream.DisplayName}:{ex.Message}");
|
||
progress?.Report($"[{slot + 1}/{streams.Count}] {stream.DisplayName} ✗ {ex.Message}");
|
||
}
|
||
finally
|
||
{
|
||
gate.Release();
|
||
}
|
||
}, ct));
|
||
}
|
||
|
||
await Task.WhenAll(tasks).ConfigureAwait(false);
|
||
|
||
var parts = new List<(PackStream Stream, PlaybackClip Clip)>();
|
||
for (var i = 0; i < streams.Count; i++)
|
||
{
|
||
if (saved[i] is { } clip) parts.Add((streams[i], clip));
|
||
}
|
||
|
||
if (parts.Count == 0)
|
||
{
|
||
throw new InvalidOperationException(
|
||
"所有通道都没能下载成功:" + string.Join(";", warnings));
|
||
}
|
||
|
||
if (parts.Count == 1)
|
||
{
|
||
var single = parts[0].Clip.Path;
|
||
var target = Path.Combine(folder, Path.GetFileName(single));
|
||
if (File.Exists(target)) File.Delete(target);
|
||
File.Move(single, target);
|
||
progress?.Report($"已保存:{target}");
|
||
return new PlaybackDownloadResult(folder, target, new[] { target }, warnings);
|
||
}
|
||
|
||
var merged = Path.Combine(folder,
|
||
$"{Sanitize(code)}_合并_{parts[0].Stream.StartTime.ToLocalTime():yyyyMMdd_HHmmss}.mp4");
|
||
|
||
progress?.Report("正在按工作台布局合并…");
|
||
try
|
||
{
|
||
await _playback.ComposeAsync(
|
||
parts.Select(item => item.Clip.Path).ToList(),
|
||
parts.Select(item => item.Stream).ToList(),
|
||
merged,
|
||
parts.Select(item => item.Clip.StartOffset).ToList(),
|
||
new Progress<PlaybackProgress>(p => progress?.Report(p.Message)),
|
||
ct).ConfigureAwait(false);
|
||
|
||
progress?.Report($"已合并:{merged}");
|
||
return new PlaybackDownloadResult(folder, merged, new[] { merged }, warnings);
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
// 合并失败不丢数据:把各路段搬到用户目录
|
||
warnings.Add($"合并失败:{ex.Message}");
|
||
var moved = new List<string>();
|
||
foreach (var (_, clip) in parts)
|
||
{
|
||
var target = Path.Combine(folder, Path.GetFileName(clip.Path));
|
||
if (File.Exists(target)) File.Delete(target);
|
||
File.Move(clip.Path, target);
|
||
moved.Add(target);
|
||
}
|
||
return new PlaybackDownloadResult(folder, null, moved, warnings);
|
||
}
|
||
}
|
||
finally
|
||
{
|
||
TryDeleteDirectory(workDir);
|
||
}
|
||
}
|
||
|
||
/// <summary>按 NVR id 取凭据并缓存(同一份计划里每个 NVR 只取一次)</summary>
|
||
private async Task<NvrCredential> CredentialAsync(int nvrId, Dictionary<int, NvrCredential> cache,
|
||
SemaphoreSlim gate, NvrCredentialProvider provider, CancellationToken ct)
|
||
{
|
||
await gate.WaitAsync(ct).ConfigureAwait(false);
|
||
try
|
||
{
|
||
if (cache.TryGetValue(nvrId, out var cached)) return cached;
|
||
|
||
var credential = await provider(nvrId, ct).ConfigureAwait(false);
|
||
if (string.IsNullOrEmpty(credential.Password))
|
||
{
|
||
throw new InvalidOperationException(
|
||
$"录像机「{credential.Name}」没有保存密码,请到网页端「录像机」页补填");
|
||
}
|
||
|
||
cache[nvrId] = credential;
|
||
return credential;
|
||
}
|
||
finally
|
||
{
|
||
gate.Release();
|
||
}
|
||
}
|
||
|
||
/// <summary>桌面端默认实现:带用户令牌调后端拿凭据</summary>
|
||
private async Task<NvrCredential> FetchCredentialAsync(int nvrId, CancellationToken ct)
|
||
{
|
||
var api = _api() ?? throw new InvalidOperationException("本机软件未登录");
|
||
var token = _token() ?? throw new InvalidOperationException("本机软件未登录");
|
||
return await api.NvrCredentialAsync(token, _subjectId(), nvrId, ct).ConfigureAwait(false);
|
||
}
|
||
|
||
private static string Sanitize(string text)
|
||
{
|
||
var invalid = Path.GetInvalidFileNameChars();
|
||
return new string(text.Select(ch => invalid.Contains(ch) ? '_' : ch).ToArray());
|
||
}
|
||
|
||
private static void TryDeleteDirectory(string dir)
|
||
{
|
||
try
|
||
{
|
||
if (Directory.Exists(dir)) Directory.Delete(dir, recursive: true);
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
AppLog.Write($"[playback] 清理临时目录失败({dir}):{ex.Message}");
|
||
}
|
||
}
|
||
}
|