diff --git a/desktop/Services/DeviceService.cs b/desktop/Services/DeviceService.cs new file mode 100644 index 0000000..6832b41 --- /dev/null +++ b/desktop/Services/DeviceService.cs @@ -0,0 +1,349 @@ +using System; +using System.Collections.Concurrent; +using System.Collections.Generic; +using System.Linq; +using System.Threading; +using System.Threading.Tasks; +using YuncangTrace.LocalService.Services.Scan; + +namespace YuncangTrace.LocalService.Services; + +/// +/// 桌面端「设备服务」:把本机当成一台扫码中控(scanner),向服务器上报扫码记录。 +/// +/// - **默认关闭**:只有主体管理员在菜单「服务 → 开启设备服务」里手动开启; +/// - 开启时调 `POST /api/web/devices/activate`,服务端保证「一个主体只有一台设备在线」, +/// 同主体其他设备会被踢下线(旧令牌立即 401); +/// - 开启后拿到**长期设备 JWT**,上报走 `POST /api/scan/{channels,records}`; +/// - 关闭时调 `POST /api/web/devices/:id/logout` 让令牌立即作废。 +/// +public sealed class DeviceService +{ + /// 本机上报用的通道 id / 名称(一台电脑就是一个通道) + public const string LocalChannelId = "DESKTOP"; + public const string LocalChannelName = "本机中控"; + + private readonly ApiClient _api; + private readonly AppSettings _settings; + private readonly Session _session; + + // 扫码记录上报队列:条码先进本地库,后台循环批量推送,**服务器确认后才标记已上传** + private readonly SemaphoreSlim _uploadSignal = new(0, 1); + private CancellationTokenSource? _uploadCts; + private Task? _uploadTask; + private int _uploadRetryMs = 1000; + + // 面单一直放在扫码器上时会持续「更新最近扫描时间」(每 1~2 秒一次)—— + // 这种事件不能每条都写日志,否则一天几万行;同一个 通道+条码 5 分钟记一次。 + private static readonly ConcurrentDictionary TouchedLogAt = new(); + + private static bool ShouldLogTouched(string channel, string code) + { + var key = $"{channel}|{code}"; + var now = DateTime.Now; + + if (TouchedLogAt.TryGetValue(key, out var last) && now - last < TimeSpan.FromMinutes(5)) return false; + + TouchedLogAt[key] = now; + return true; + } + + public DeviceService(ApiClient api, AppSettings settings, Session session) + { + _api = api; + _settings = settings; + _session = session; + } + + /// 上报状态(给界面看的一句话;空串 = 一切正常) + public string UploadStatus { get; private set; } = string.Empty; + + /// 是否已开启(本地标记 + 有令牌) + public bool Enabled => _settings.DeviceServiceEnabled && !string.IsNullOrWhiteSpace(_settings.DeviceToken); + + /// 本机 SN(默认机器名,最多 64 字符) + public string Sn + { + get + { + if (!string.IsNullOrWhiteSpace(_settings.DeviceSn)) return _settings.DeviceSn; + var name = Environment.MachineName; + return string.IsNullOrWhiteSpace(name) ? "PC-DESKTOP" : name.ToUpperInvariant(); + } + set + { + var text = (value ?? string.Empty).Trim(); + _settings.DeviceSn = text.Length > 64 ? text[..64] : text; + } + } + + /// 当前主体 id(没有主体时 0) + public int SubjectId => _settings.SubjectId; + + /// 当前主体下**除本机以外**的已绑定设备(开启前提示"会被踢掉") + public async Task> OtherDevicesAsync(CancellationToken ct = default) + { + if (SubjectId <= 0) return Array.Empty(); + + var devices = await _api.DevicesAsync(_session.Token, SubjectId, ct).ConfigureAwait(false); + return devices.Where(item => !string.Equals(item.Sn, Sn, StringComparison.OrdinalIgnoreCase)).ToList(); + } + + /// + /// 开启设备服务:注册本机 → 保存令牌 → 上报通道。 + /// (踢掉其他设备的确认由界面负责,这里只管干活) + /// + /// 不是管理员 / 网络失败 / 主体到期等,message 可直接显示 + public async Task EnableAsync(CancellationToken ct = default) + { + if (SubjectId <= 0) throw new ApiException("还没有选择主体,请先在「服务 → 切换主体」里选一个"); + + var result = await _api.ActivateDeviceAsync(_session.Token, SubjectId, Sn, $"{Environment.MachineName}(本机)", ct) + .ConfigureAwait(false); + + _settings.DeviceServiceEnabled = true; + _settings.DeviceId = result.Id; + _settings.DeviceSn = result.Sn; + _settings.DeviceToken = result.Token; + _settings.DeviceRefreshToken = result.RefreshToken; + _settings.DeviceTokenExpiresAt = result.ExpiresIn ?? string.Empty; + _settings.Save(); + + AppLog.Write($"[device] 设备服务已开启:{result.Sn}(id={result.Id},踢下线 {result.Kicked.Count} 台)"); + + // 拉起扫码记录上报循环(断网期间的积压会一次性补上去) + EnsureUploadLoop(); + TriggerUpload(); + + // 通道不在这里上报:真实通道由 `ScanService` 同步(加了几个扫码通道就报几个)。 + // 以前这里会补一个 `DESKTOP`「本机中控」占位通道,结果工作台绑定页能看到一个 + // 永远没数据的假通道;查询也不是扫码,不需要这个通道来"记账"。 + AppLog.Write("[device] 通道由扫码服务同步(不再上报本机占位通道)"); + + return result; + } + + /// 上报一批通道(扫码服务的每条通道都同步给服务器,供工作台绑定) + public async Task ReportChannelsAsync(IEnumerable<(string ChannelId, string ChannelName)> channels, + CancellationToken ct = default) + { + if (!Enabled) return; + + var list = channels + .Where(item => !string.IsNullOrWhiteSpace(item.ChannelId)) + .Select(item => (item.ChannelId, string.IsNullOrWhiteSpace(item.ChannelName) ? item.ChannelId : item.ChannelName)) + .ToList(); + if (list.Count == 0) return; + + await _api.ReportChannelsAsync(_settings.DeviceToken, list, ct).ConfigureAwait(false); + } + + /// 关闭设备服务:让令牌立即作废并清掉本地状态 + public async Task DisableAsync(CancellationToken ct = default) + { + StopUploadLoop(); + + var deviceId = _settings.DeviceId; + var token = _settings.DeviceToken; + + _settings.DeviceServiceEnabled = false; + _settings.DeviceToken = string.Empty; + _settings.DeviceRefreshToken = string.Empty; + _settings.DeviceTokenExpiresAt = string.Empty; + _settings.Save(); + + if (deviceId > 0 && token.Length > 0 && SubjectId > 0) + { + try + { + await _api.DeactivateDeviceAsync(_session.Token, SubjectId, deviceId, ct).ConfigureAwait(false); + AppLog.Write($"[device] 设备服务已关闭(id={deviceId},令牌已作废)"); + } + catch (Exception ex) + { + // 关服务不该因为网络问题卡住用户 + AppLog.Write($"[device] 通知服务器关闭失败(本地已关闭):{ex.Message}"); + } + } + else + { + AppLog.Write("[device] 设备服务已关闭(本地)"); + } + } + + /// 换了主体/退出登录:本地状态清掉(不动服务器上的旧设备) + public void ResetLocalState() + { + StopUploadLoop(); + + _settings.DeviceServiceEnabled = false; + _settings.DeviceId = 0; + _settings.DeviceToken = string.Empty; + _settings.DeviceRefreshToken = string.Empty; + _settings.DeviceTokenExpiresAt = string.Empty; + _settings.Save(); + } + + /// + /// 上报一条扫码记录(fire-and-forget 的**入队**版本)。 + /// + /// ⚠️ 只在真的"扫了一次码"时调用;**运单查询不要调** —— + /// 查询只是看看,记一条 `DESKTOP` 记录会污染扫码记录表(历史要求)。 + /// 先落本地库,由后台上报循环推给服务器;失败会一直重试,不会丢。 + /// + public void ReportScan(string code) => ReportOnChannel(LocalChannelId, LocalChannelName, code); + + /// + /// 用指定通道记一条扫码记录。 + /// + /// 与 AndroidScanCenter 的 ScanStore + BarcodeReporter 一致: + /// ① 先落本地(连续扫描只刷新「最近一次扫描时间」)→ ② 唤醒后台上报循环 → + /// ③ 服务器 2xx 确认后才把记录标成已上传,否则按退避重试。 + /// + /// **延迟上报**:扫到后 5 分钟没再扫到同一个码才真正上报(见 + /// ),上报的是最后一次扫描时间。 + /// + /// true = 一次新的扫码事件(连续扫描的重复帧返回 false,界面不用重查) + public bool ReportOnChannel(string channelId, string channelName, string code) + { + var barcode = (code ?? string.Empty).Trim(); + if (barcode.Length == 0) return false; + + var channel = string.IsNullOrWhiteSpace(channelId) ? LocalChannelId : channelId; + var name = string.IsNullOrWhiteSpace(channelName) ? channel : channelName; + + // 没开设备服务也照样记本地:开起来之后会把积压的自动补上去(断网/未开启期间不丢码) + var result = ScanRecordStore.Add(channel, name, barcode, DateTime.Now); + if (result.Item is null || result.Kind == ScanAddKind.Repeated) return false; + + if (result.Kind == ScanAddKind.Touched) + { + if (ShouldLogTouched(channel, barcode)) + { + AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 分钟内不再重复记录)"); + } + } + else + { + AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 分钟未再扫到后上报)"); + } + + if (!Enabled) return true; + EnsureUploadLoop(); + SignalUpload(); + return true; + } + + /// 查服务器上当前中控已登记的通道(用于确认同步) + public Task> ChannelsAsync(CancellationToken ct = default) + => _api.ChannelsAsync(_settings.DeviceToken, ct); + + /// 立即触发一次上报(界面的「立即上传」) + public void TriggerUpload() + { + if (!Enabled) return; + EnsureUploadLoop(); + SignalUpload(); + } + + /// 开设备服务时把上报循环拉起来(重复调用无影响) + public void EnsureUploadLoop() + { + if (_uploadTask is { IsCompleted: false }) return; + + _uploadCts = new CancellationTokenSource(); + _uploadTask = Task.Run(() => UploadLoopAsync(_uploadCts.Token)); + } + + /// 停上报循环(关服务 / 退出登录) + public void StopUploadLoop() + { + try + { + _uploadCts?.Cancel(); + } + catch + { + // 忽略 + } + _uploadCts = null; + _uploadTask = null; + UploadStatus = string.Empty; + ScanRecordStore.Flush(); + } + + private void SignalUpload() + { + try + { + if (_uploadSignal.CurrentCount == 0) _uploadSignal.Release(); + } + catch + { + // 忽略 + } + } + + /// + /// 后台上报循环:有信号或每 30 秒检查一次,把**静默满 5 分钟**的待上传记录攒批推送。 + /// + /// 失败时**不标记**那批记录,等退避(1s→2s→5s→10s→30s 封顶)后重发; + /// 服务端按 设备+通道+条码+秒 去重、同一运单 24 小时内覆盖成最新时间, + /// 所以整批重发不会造成重复落库,也不会把时间改回过去。 + /// + private async Task UploadLoopAsync(CancellationToken ct) + { + while (!ct.IsCancellationRequested) + { + try + { + await _uploadSignal.WaitAsync(TimeSpan.FromSeconds(30), ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + + while (!ct.IsCancellationRequested && Enabled) + { + var batch = ScanRecordStore.Pending(50); + if (batch.Count == 0) + { + UploadStatus = string.Empty; + break; + } + + try + { + var rows = batch.Select(item => (item.ChannelId, item.Code, item.ScannedAt)).ToList(); + await _api.ReportRecordsAsync(_settings.DeviceToken, rows, ct).ConfigureAwait(false); + + // 服务器已确认:只有这里才把记录标成已上传 + // (传入上报时的扫描时间:上报期间又扫到的话保持待上传,下一轮带最新时间重发) + ScanRecordStore.MarkUploaded(batch.Select(item => (item.Id, item.ScannedAt))); + _uploadRetryMs = 1000; + UploadStatus = string.Empty; + AppLog.Write($"[scan] 已上报扫码 {batch.Count} 条"); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception ex) + { + UploadStatus = $"上报失败(待上传 {ScanRecordStore.PendingCount()} 条),{_uploadRetryMs / 1000} 秒后重试"; + AppLog.Write($"[scan] 上报扫码失败({batch.Count} 条,{_uploadRetryMs}ms 后重试):{ex.Message}"); + try + { + await Task.Delay(_uploadRetryMs, ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + _uploadRetryMs = Math.Min(_uploadRetryMs * 2, 30000); + } + } + } + } +} diff --git a/desktop/Services/LocalHttpServer.cs b/desktop/Services/LocalHttpServer.cs index d3bb2aa..f4b506b 100644 --- a/desktop/Services/LocalHttpServer.cs +++ b/desktop/Services/LocalHttpServer.cs @@ -1,8 +1,11 @@ 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; @@ -27,14 +30,32 @@ namespace YuncangTrace.LocalService.Services; /// public sealed class LocalHttpServer : IDisposable { - /// 监听端口(前端/插件里写死的 17300) - public const int Port = 17300; + /// 监听端口(前端/插件里写死的 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; @@ -50,9 +71,18 @@ public sealed class LocalHttpServer : IDisposable /// 当前后端地址(由 App 提供,随 `/api/query` 一起返回,排障用) public Func? ServerBaseUrlProvider { get; set; } - public LocalHttpServer(OrderQueryService queryService) + 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); + } } /// 是否已登录(网页靠它判断要不要唤起登录) @@ -161,6 +191,37 @@ public sealed class LocalHttpServer : IDisposable 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); @@ -194,7 +255,7 @@ public sealed class LocalHttpServer : IDisposable return; } - var result = _queryService.Query(code); + var result = (await _queryService.QueryAsync(code).ConfigureAwait(false)).Http; if (result.Ok) { @@ -216,6 +277,7 @@ public sealed class LocalHttpServer : IDisposable { 400 => "bad-request", 404 => "not-found", + 401 => "need-login", _ => "error", }; @@ -246,6 +308,10 @@ public sealed class LocalHttpServer : IDisposable
  • /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); @@ -279,6 +345,759 @@ public sealed class LocalHttpServer : IDisposable } } + /// + /// 按运单下载录像: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) { @@ -286,7 +1105,8 @@ public sealed class LocalHttpServer : IDisposable var origin = request.Headers["Origin"]; response.Headers["Access-Control-Allow-Origin"] = string.IsNullOrEmpty(origin) ? "*" : origin; response.Headers["Vary"] = "Origin"; - response.Headers["Access-Control-Allow-Methods"] = "GET, POST, OPTIONS"; + // 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"; @@ -325,6 +1145,10 @@ public sealed class LocalHttpServer : IDisposable { Stop(); _cts?.Dispose(); + _native?.Dispose(); + _preview?.Dispose(); + _ffmpeg?.Dispose(); + _stream?.Dispose(); _listener.Close(); } } diff --git a/desktop/Services/OrderQueryService.cs b/desktop/Services/OrderQueryService.cs index 36acf02..c3ee78d 100644 --- a/desktop/Services/OrderQueryService.cs +++ b/desktop/Services/OrderQueryService.cs @@ -1,11 +1,15 @@ using System; using System.Collections.Generic; +using System.Linq; +using System.Text.Json; +using System.Threading; +using System.Threading.Tasks; namespace YuncangTrace.LocalService.Services; /// 一次查询的结果(HTTP 层和界面都复用) /// 是否查到 -/// HTTP 状态码(200 / 400 / 404 / 500) +/// HTTP 状态码(200 / 400 / 401 / 404 / 500) /// 失败原因 /// 成功时的数据(**平铺**一个对象,前端按「项目/值」两列直接渲染) public sealed record QueryResult(bool Ok, int StatusCode, string Message, object? Data) @@ -20,32 +24,89 @@ public sealed record QueryResult(bool Ok, int StatusCode, string Message, object } /// -/// 按运单号查信息 +/// 查询结果的两副面孔 /// -/// ⚠️ **这里是接你们真实数据的地方**:现在返回演示数据(任何 code 都返回同一份)。 -/// 真实实现通常是:查本地 SQLite / 扫描本地打包视频目录 / 调内部接口, -/// 然后把结果按字段平铺返回(前端页面按 key-value 展示,字段随你加)。 +/// - :给网页 `/local` 页用的「项目 / 值」扁平字典; +/// - :给桌面端用的结构化对象(校验回放 / 拉流 / 下载都要它)。 +/// +public sealed record PackQueryOutcome(QueryResult Http, PackQuery? Query); + +/// +/// 按运单号查「回放计划」 +/// +/// 数据来自后端 `GET /api/web/pack-query?code=`(**范围限定当前主体**): +/// 后端用**扫码当时的工作台快照**算好「去哪个录像机的哪个通道、拉哪一段时间、画面怎么摆」, +/// 本机负责展示 + 真正去录像机上校验/拉流。 /// public sealed class OrderQueryService { - public QueryResult Query(string? code) + private readonly Func? _api; + private readonly Func? _subjectId; + private readonly Func? _token; + + /// 后端客户端(登录后才有;未登录返回 null,查询会直接回「未登录」) + /// 当前主体 id(登录后由设置里取) + /// 当前用户令牌 + public OrderQueryService(Func? apiProvider = null, Func? subjectIdProvider = null, + Func? tokenProvider = null) + { + _api = apiProvider; + _subjectId = subjectIdProvider; + _token = tokenProvider; + } + + /// 按运单号查回放计划(需要用户令牌 + 当前主体) + public async Task QueryAsync(string? code, CancellationToken ct = default) { var value = (code ?? string.Empty).Trim(); - if (value.Length == 0) return QueryResult.BadRequest("缺少运单号"); + if (value.Length == 0) return new PackQueryOutcome(QueryResult.BadRequest("缺少运单号"), null); - // ↓↓↓ 换成真实查询逻辑 ↓↓↓ - var data = new Dictionary + var api = _api?.Invoke(); + var token = _token?.Invoke(); + if (api is null || string.IsNullOrWhiteSpace(token)) { - ["code"] = value, - ["orderNo"] = "SO-20261017-001", - ["channel"] = "CH-1", - ["printStatus"] = "已打印", - ["scanTime"] = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"), - ["videoPath"] = @"D:\video\2026-10-17\demo.mp4", - ["source"] = "演示数据(请替换 OrderQueryService.Query)", - }; - // ↑↑↑ 换成真实查询逻辑 ↑↑↑ + return new PackQueryOutcome(QueryResult.Failed("本机软件未登录,无法查询"), null); + } - return QueryResult.Success(data); + var subjectId = _subjectId?.Invoke() ?? 0; + if (subjectId <= 0) return new PackQueryOutcome(QueryResult.BadRequest("还没有选择主体,无法查询"), null); + + JsonElement data; + try + { + data = await api.PackQueryAsync(token!, subjectId, value, ct).ConfigureAwait(false); + } + catch (ApiException ex) + { + // 401/403 就是登录态失效,别当成服务器错误 + var status = ex.StatusCode is 401 or 403 ? 401 : 500; + return new PackQueryOutcome(new QueryResult(false, status, ex.Message, null), null); + } + catch (Exception ex) + { + return new PackQueryOutcome(QueryResult.Failed(ex.Message), null); + } + + var query = PackQuery.Parse(value, data); + + // ⚠️ 不要在这里打完整 JSON:一条记录几 KB,扫码密集时日志一天能到几十 MB。 + // 只记结论,排障需要细节看后端日志 / 页面。 + AppLog.Write($"[pack-query] {value} → found={query.Found} reason={query.Reason} " + + $"records={query.Records.Count} streams={query.Streams.Count}"); + + if (!query.Found) + { + // reason:not-found(本主体没扫过)/ foreign(运单存在但属于别的主体) + var message = query.Reason == "foreign" + ? "这个运单号存在,但属于其他主体,当前主体查不到" + : query.Hints.FirstOrDefault() ?? "没有查到该运单的扫码记录"; + return new PackQueryOutcome(QueryResult.NotFound(message), null); + } + + // 网页 /local 页吃的是「项目 / 值」(与桌面端共用同一份 ToRows,不会各说一套) + var rows = new Dictionary(); + foreach (var row in query.ToRows()) rows[row.Key] = row.Value; + + return new PackQueryOutcome(QueryResult.Success(rows), query); } } diff --git a/desktop/Services/PackQuery.cs b/desktop/Services/PackQuery.cs new file mode 100644 index 0000000..7bcb90a --- /dev/null +++ b/desktop/Services/PackQuery.cs @@ -0,0 +1,301 @@ +using System; +using System.Collections.Generic; +using System.Globalization; +using System.Linq; +using System.Text.Json; + +namespace YuncangTrace.LocalService.Services; + +/// 摄像头在合成画布上的位置(后端快照里的 layout) +public sealed record PackLayout(int X, int Y, int Width, int Height, int SortNo, int ZIndex); + +/// 一路回放流:去哪个录像机的哪个通道、拉哪一段时间 +public sealed record PackStream( + int NvrId, + string NvrName, + string NvrHost, + int NvrPort, + string NvrUsername, + int ChannelNo, + int CameraId, + string CameraName, + int StreamType, + PackLayout Layout, + int CanvasWidth, + int CanvasHeight, + DateTimeOffset StartTime, + DateTimeOffset EndTime) +{ + public int DurationSec => (int)Math.Round((EndTime - StartTime).TotalSeconds); + + /// 给人看的名字,如「打包台1-通道34(通道34)」 + public string DisplayName => string.IsNullOrWhiteSpace(CameraName) + ? $"通道{ChannelNo}" + : $"{CameraName}(通道{ChannelNo})"; +} + +/// 一条扫码记录的回放计划 +public sealed record PackRecord( + long Id, + DateTimeOffset ScanTime, + string ChannelId, + string ChannelName, + string DeviceSn, + string WorkstationName, + string WorkstationCode, + string Kind, + DateTimeOffset? StartTime, + DateTimeOffset? EndTime, + int DurationSec, + IReadOnlyList Streams) +{ + public string KindName => Kind switch + { + "group" => "团购(扫码时间前后各留余量)", + "scatter" => "散单(扫码 = 开始,下一次扫码 = 结束)", + _ => "未知工作台类型", + }; +} + +/// +/// `GET /api/web/pack-query` 的结构化结果 +/// +/// 之前是直接拍成「项目:值」的文本给界面看,做回放校验/预览/下载时不够用, +/// 所以解析成强类型:界面显示走 ,拉流走 。 +/// +public sealed record PackQuery( + string Code, + bool Found, + bool Playback, + string Reason, + IReadOnlyList Hints, + IReadOnlyList Records, + IReadOnlyList UnboundTimes, + IReadOnlyList Streams) +{ + /// + /// 拍成「项目 / 值」两列 + /// + /// 同一个列表同时喂两边:桌面端拼成多行文本(), + /// 网页 `/local` 页当 key-value 表格渲染 —— 两处显示不会各说一套。 + /// + public IReadOnlyList> ToRows() + { + var rows = new List> + { + new("运单号", Code), + new("扫码记录数", (Records.Count + UnboundTimes.Count).ToString()), + }; + + if (UnboundTimes.Count > 0) + { + rows.Add(new("绑定工作台", $"无({string.Join("、", UnboundTimes.Select(FormatTime))})")); + } + + for (var i = 0; i < Records.Count; i++) + { + var record = Records[i]; + var prefix = Records.Count == 1 ? string.Empty : $"记录 {i + 1} · "; + + rows.Add(new($"{prefix}扫码时间", FormatTime(record.ScanTime))); + + var channel = string.IsNullOrWhiteSpace(record.ChannelName) + ? $"{record.DeviceSn} / {record.ChannelId}" + : $"{record.DeviceSn} / {record.ChannelId}({record.ChannelName})"; + rows.Add(new($"{prefix}中控 / 通道", channel)); + + var workstation = string.IsNullOrWhiteSpace(record.WorkstationCode) + ? $"{record.WorkstationName} · {record.KindName}" + : $"{record.WorkstationName}({record.WorkstationCode})· {record.KindName}"; + rows.Add(new($"{prefix}工作台", workstation)); + + rows.Add(new($"{prefix}回放区间", record.StartTime is not null && record.EndTime is not null + ? $"{FormatTime(record.StartTime.Value)} ~ {FormatTime(record.EndTime.Value)}({record.DurationSec} 秒)" + : "无法确定(见说明)")); + + if (record.Streams.Count == 0) + { + rows.Add(new($"{prefix}录像机", "—")); + rows.Add(new($"{prefix}摄像头", "没有可拉的回放流(工作台没绑摄像头)")); + } + else + { + var nvrs = record.Streams + .GroupBy(item => $"{item.NvrHost}:{item.NvrPort}") + .Select(group => string.IsNullOrWhiteSpace(group.First().NvrName) + ? group.Key + : $"{group.First().NvrName} {group.Key}"); + rows.Add(new($"{prefix}录像机", string.Join(";", nvrs))); + + var cameras = record.Streams.Select(item => + { + var where = item.CanvasWidth <= 0 + ? string.Empty + : $"({item.CanvasWidth}×{item.CanvasHeight} @ {item.Layout.X},{item.Layout.Y} " + + $"{item.Layout.Width}×{item.Layout.Height})"; + return $"通道{item.ChannelNo} {item.CameraName}{where}"; + }); + rows.Add(new($"{prefix}摄像头", string.Join(";", cameras))); + } + } + + // 「通道没绑工作台」已经在上面单独一行说过了,这里不再重复 + var rest = Hints.Where(item => !item.Contains("没有绑定工作台")).ToList(); + if (rest.Count > 0) rows.Add(new("说明", string.Join(" ", rest))); + + return rows; + } + + /// 拍成多行文本(桌面端文本框用) + public string Render() + => string.Join(Environment.NewLine, ToRows().Select(row => $"{row.Key}:{row.Value}")); + + private static string FormatTime(DateTimeOffset value) => value.ToLocalTime().ToString("yyyy-MM-dd HH:mm:ss"); + + // ==================== 解析 ==================== + + public static PackQuery Parse(string code, JsonElement data) + { + var found = data.TryGetProperty("found", out var foundElement) && foundElement.ValueKind == JsonValueKind.True; + var playback = data.TryGetProperty("playback", out var playbackElement) && playbackElement.ValueKind == JsonValueKind.True; + + var records = new List(); + foreach (var item in ReadArray(data, "records")) + { + var plan = Get(item, "plan"); + var snapshot = Get(item, "snapshot"); + var workstation = Get(snapshot, "workstation"); + + records.Add(new PackRecord( + GetLong(item, "id"), + ReadTime(Get(item, "scanTime")) ?? DateTimeOffset.MinValue, + GetString(item, "channelId") ?? string.Empty, + GetString(item, "channelName") ?? string.Empty, + GetString(item, "deviceSn") ?? string.Empty, + GetString(workstation, "name") ?? string.Empty, + GetString(workstation, "code") ?? string.Empty, + GetString(plan, "kind") ?? string.Empty, + ReadTime(Get(plan, "startTime")), + ReadTime(Get(plan, "endTime")), + GetInt(plan, "durationSec"), + ReadStreams(ReadArray(plan, "streams")))); + } + + var unbound = ReadArray(data, "skipped") + .Select(item => ReadTime(Get(item, "scanTime"))) + .Where(item => item is not null) + .Select(item => item!.Value) + .ToList(); + + return new PackQuery( + code, + found, + playback, + GetString(data, "reason") ?? string.Empty, + ReadStrings(data, "hints"), + records, + unbound, + ReadStreams(ReadArray(data, "streams"))); + } + + private static List ReadStreams(IEnumerable items) + { + var list = new List(); + foreach (var item in items) + { + var layout = Get(item, "layout"); + var start = ReadTime(Get(item, "startTime")); + var end = ReadTime(Get(item, "endTime")); + if (start is null || end is null) continue; + + list.Add(new PackStream( + GetInt(item, "nvrId"), + GetString(item, "nvrName") ?? string.Empty, + GetString(item, "nvrHost") ?? string.Empty, + GetInt(item, "nvrPort"), + GetString(item, "nvrUsername") ?? "admin", + GetInt(item, "channelNo"), + GetInt(item, "cameraId"), + GetString(item, "cameraName") ?? string.Empty, + GetInt(item, "streamType"), + new PackLayout( + GetInt(layout, "x"), GetInt(layout, "y"), + GetInt(layout, "width"), GetInt(layout, "height"), + GetInt(layout, "sortNo"), GetInt(layout, "zIndex")), + GetInt(item, "canvasWidth"), + GetInt(item, "canvasHeight"), + start.Value, + end.Value)); + } + return list; + } + + // ==================== JSON 小工具 ==================== + + private static JsonElement? Get(JsonElement? element, string property) + { + if (element is not { ValueKind: JsonValueKind.Object } obj) return null; + return obj.TryGetProperty(property, out var value) ? value : null; + } + + private static string? GetString(JsonElement? element, string property) + { + var value = Get(element, property); + return value is { ValueKind: JsonValueKind.String } ? value.Value.GetString() : null; + } + + private static long GetLong(JsonElement? element, string property) + { + var value = Get(element, property); + return value is { ValueKind: JsonValueKind.Number } && value.Value.TryGetInt64(out var number) ? number : 0; + } + + private static int GetInt(JsonElement? element, string property) + { + var value = Get(element, property); + if (value is null) return 0; + return value.Value.ValueKind switch + { + JsonValueKind.Number => value.Value.TryGetInt32(out var number) ? number : 0, + JsonValueKind.String => int.TryParse(value.Value.GetString(), out var parsed) ? parsed : 0, + _ => 0, + }; + } + + private static List ReadArray(JsonElement? element, string property) + { + var value = Get(element, property); + if (value is null || value.Value.ValueKind != JsonValueKind.Array) return new List(); + return value.Value.EnumerateArray().ToList(); + } + + private static List ReadStrings(JsonElement? element, string property) + { + var list = new List(); + foreach (var item in ReadArray(element, property)) + { + if (item.ValueKind == JsonValueKind.String) + { + var text = item.GetString(); + if (!string.IsNullOrWhiteSpace(text)) list.Add(text!); + } + } + return list; + } + + /// 后端给的是 UTC ISO(`2026-10-18T14:09:47.000Z`) + private static DateTimeOffset? ReadTime(JsonElement? element) + { + if (element is not { ValueKind: JsonValueKind.String }) return null; + + var text = element.Value.GetString(); + if (string.IsNullOrWhiteSpace(text)) return null; + + if (DateTimeOffset.TryParse(text, CultureInfo.InvariantCulture, + DateTimeStyles.AssumeUniversal | DateTimeStyles.AdjustToUniversal, out var parsed)) + { + return parsed; + } + return null; + } +} diff --git a/desktop/Services/Scan/ChannelConnection.cs b/desktop/Services/Scan/ChannelConnection.cs new file mode 100644 index 0000000..8dcbe50 --- /dev/null +++ b/desktop/Services/Scan/ChannelConnection.cs @@ -0,0 +1,380 @@ +using System; +using System.IO; +using System.Net.Sockets; +using System.Text; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 一条通道的 TCP 长连接(从 AndroidScanCenter 的 ChannelConnections 移植)。 +/// +/// **方向是「设备当服务端、中控当客户端」**:设备在我们的 SOCK 条目端口(默认 8087)上监听, +/// 把串口(扫码枪)的数据推给连上来的人。所以这里为每条通道建一条**出向**连接, +/// 断了自动重连;读到的每一行就是一条条码。 +/// +/// 在线状态以**这条连接**为准(UDP 只说明「设备在网上」)。 +/// +public sealed class ChannelConnection : IDisposable +{ + private const int ConnectTimeoutMs = 4000; + private const int ReconnectMs = 5000; + + /// 单行上限(字节):不带分隔符时也要能吐出去 + private const int MaxLineBytes = 256; + + private readonly ScanChannel _channel; + private readonly CancellationTokenSource _cts = new(); + + /// 串行化写:下发扫码枪设置要一次写完,不能被重连/其它写方打新 + private readonly SemaphoreSlim _writeGate = new(1, 1); + + /// 当前连接(静音切换时要主动关掉它,让循环重新连并重新下发设置) + private TcpClient? _client; + + /// 提前唤醒重连等待(改设置时不必要干等 5 秒) + private readonly SemaphoreSlim _wake = new(0, 1); + + /// 本次断开的原因(我们自己要求重连时写,日志里不能写成连接失败) + private string? _manualReason; + + /// 收到一条条码 + public event Action? Barcode; + + /// 连接状态变了(true=已连上) + public event Action? StateChanged; + + /// 连续重连多次都不行:上报给上层去「自愈」(回查/补建设备的 TCP 服务条目) + public event Action? HealNeeded; + + public ChannelConnection(ScanChannel channel) + { + _channel = channel; + } + + public ScanChannel Channel => _channel; + + /// 本机在这条连接上的源 IP(设备侧 `ClientIP` 应该等于它,心跳用) + public string LocalIp { get; private set; } = string.Empty; + + /// 最后一次收到字节的时刻(有数据 = 连接肯定是活的) + public DateTime LastRxAt { get; private set; } = DateTime.Now; + + /// 启动后台循环(连上→读→断→重连) + public void Start() + { + _ = Task.Run(() => LoopAsync(_cts.Token)); + } + + public void Stop() + { + try + { + _cts.Cancel(); + } + catch + { + // 忽略 + } + SetState(false); + } + + /// + /// 强制重连(改静音用)。 + /// + /// 不在现有 socket 上补写一条静音指令,而是**关掉连接、让循环重新走一遍**: + /// 设置只存在通道配置里一个真值来源,连上时由 整体下发。 + /// 否则「字节发出去了但扫码枪没执行」时无法判断(Android 侧实测撞过)。 + /// + public void RequestReconnect(string reason = "本地请求重连") + { + _manualReason = reason; + try + { + _client?.Dispose(); + } + catch + { + // 忽略 + } + + try + { + if (_wake.CurrentCount == 0) _wake.Release(); + } + catch + { + // 忽略 + } + } + + private async Task LoopAsync(CancellationToken ct) + { + var attempts = 0; + + while (!ct.IsCancellationRequested && _channel.Enabled && !string.IsNullOrWhiteSpace(_channel.LastIp)) + { + TcpClient? client = null; + var reason = string.Empty; + + try + { + client = new TcpClient { NoDelay = true }; + using (var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct)) + { + timeout.CancelAfter(ConnectTimeoutMs); + await client.ConnectAsync(_channel.LastIp, _channel.TcpPort, timeout.Token).ConfigureAwait(false); + } + + _client = client; + // ⚠️ IPv4 也可能以 `::ffff:192.168.11.56` 形式给出(双栈 socket), + // 不归一化的话跟设备侧 `ClientIP`(纯 IPv4)永远对不上(看门狗会误判为假死) + var ep = client.Client.LocalEndPoint as System.Net.IPEndPoint; + LocalIp = ep is null + ? string.Empty + : (ep.Address.IsIPv4MappedToIPv6 ? ep.Address.MapToIPv4() : ep.Address).ToString(); + LastRxAt = DateTime.Now; + + SetState(true); + AppLog.Write(attempts == 0 + ? $"[scan] 通道 {_channel.Number}({_channel.DisplayName})已连接 {_channel.LastIp}:{_channel.TcpPort}" + : $"[scan] 通道 {_channel.Number}({_channel.DisplayName})重连成功(第 {attempts} 次){_channel.LastIp}:{_channel.TcpPort}"); + + // 连上就按通道记住的静音值把整条扫码枪设置(连扫 + 间隔 0 + 静音)下发一遍 + await ApplyScannerSettingsAsync(client, ct).ConfigureAwait(false); + + reason = await ReadLoopAsync(client, ct).ConfigureAwait(false); + } + catch (OperationCanceledException) when (ct.IsCancellationRequested) + { + // 真的是被停掉(关服务/删通道/换地址) + break; + } + catch (OperationCanceledException) + { + // ⚠️ 连接超时也会抛 OperationCanceledException(来自上面的 timeout CTS)。 + // 之前没区分,被当成「取消」直接 break —— 循环静默死掉, + // 界面一直离线、日志一条不打、再也不重连。 + reason = $"连接超时({ConnectTimeoutMs}ms 内没建起来)"; + } + catch (Exception ex) + { + reason = "连接失败:" + ex.Message; + } + finally + { + _client = null; + SetState(false); + try + { + client?.Dispose(); + } + catch + { + // 忽略 + } + } + + if (ct.IsCancellationRequested) break; + + if (_manualReason is not null) + { + reason = _manualReason; + _manualReason = null; + } + + // 连接真断了才记一条(以前只有「已连接」没「断开」,出问题看不出到底是断还是没连) + attempts++; + + // 长时间离线时别每 5 秒刷一行:前 3 次都记,之后每 10 次记一次 + if (attempts <= 3 || attempts % 10 == 0) + { + AppLog.Write($"[scan] 通道 {_channel.Number} 断开({reason}),{ReconnectMs / 1000} 秒后重连" + + (attempts > 1 ? $";已重连 {attempts} 次" : string.Empty)); + } + + // 连续连不上(第 3 次、之后每 10 次):让上层回查设备那条 TCP 服务还在不在 + if (attempts == 3 || attempts % 10 == 0) + { + HealNeeded?.Invoke(_channel); + } + + if (ct.IsCancellationRequested) break; + + try + { + // 可选「被提前唤醒」:改设置时不用干等满 5 秒 + await _wake.WaitAsync(ReconnectMs, ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + } + + AppLog.Write($"[scan] 通道 {_channel.Number} 重连循环结束(服务停止 / 通道被停用或删除)"); + } + + /// + /// 直接给扫码枪发一串字节(调试用):走设备的 TCP→串口 透传。 + /// 返回 false 表示当前没连上。 + /// + public async Task SendRawAsync(byte[] payload) + { + var client = _client; + if (client is null || payload.Length == 0) return false; + + try + { + var stream = client.GetStream(); + await _writeGate.WaitAsync().ConfigureAwait(false); + try + { + await stream.WriteAsync(payload).ConfigureAwait(false); + await stream.FlushAsync().ConfigureAwait(false); + } + finally + { + _writeGate.Release(); + } + + AppLog.Write($"[scan] 通道 {_channel.Number} 已下发串口指令 {payload.Length} 字节:" + + BitConverter.ToString(payload).Replace('-', ' ')); + return true; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 通道 {_channel.Number} 下发串口指令失败:{ex.Message}"); + return false; + } + } + + /// + /// 连上之后立刻把扫码枪配成「连续扫描 + 间隔 0s + 静音状态」(9 + 9 + 10 = 28 字节一次写完)。 + /// + /// 写失败**不当作连接失败**:设置没配上顶多是不出数据,连接本身还是要留着。 + /// + private async Task ApplyScannerSettingsAsync(TcpClient client, CancellationToken ct) + { + try + { + var stream = client.GetStream(); + await _writeGate.WaitAsync(ct).ConfigureAwait(false); + try + { + foreach (var command in ScannerCommands.StartupSequence(_channel.Muted)) + { + await stream.WriteAsync(command, ct).ConfigureAwait(false); + } + await stream.FlushAsync(ct).ConfigureAwait(false); + } + finally + { + _writeGate.Release(); + } + + AppLog.Write($"[scan] 通道 {_channel.Number} 已下发扫码枪设置:连续扫描 + 间隔 0s + " + + (_channel.Muted ? "静音" : "蜂鸣")); + } + catch (Exception ex) + { + AppLog.Write($"[scan] 通道 {_channel.Number} 下发扫码枪设置失败(不影响收码):{ex.Message}"); + } + } + + /// + /// 读数据:按 CR/LF 分行,超长也先吐出来;返回断开原因(给日志用)。 + /// + /// ⚠️ 真机(E10C 1.41.1)实测:设备每 ~0.7s 会往已连上的客户端推一帧 + /// 04 D0 00 00 FF 2C(6 字节二进制,无 CR/LF)。这些字节如果照抄进行缓冲, + /// 会攒到 256 字节才吐,期间真扫码枪那行条码会被**粘在后面一起丢掉**。 + /// 所以这里只累积 **可打印 ASCII**:遇到控制字符/高位字节就把当前行清空(当作帧分隔), + /// 条码(Code128/EAN 等)本来就是纯 ASCII,不受影响。 + /// + private async Task ReadLoopAsync(TcpClient client, CancellationToken ct) + { + var stream = client.GetStream(); + var buffer = new byte[1024]; + var pending = new MemoryStream(); + var noiseBytes = 0; + var noiseLogged = false; + + try + { + while (!ct.IsCancellationRequested) + { + var read = await stream.ReadAsync(buffer, ct).ConfigureAwait(false); + if (read <= 0) return "设备关闭了连接"; // 对端关了 + + LastRxAt = DateTime.Now; + + for (var i = 0; i < read; i++) + { + var b = buffer[i]; + if (b is (byte)'\n' or (byte)'\r') + { + Flush(pending); + continue; + } + + if (b < 0x20 || b > 0x7E) + { + // 二进制噪声(设备心跳帧):丢掉已攒的半行,继续 + pending.SetLength(0); + noiseBytes++; + if (!noiseLogged && noiseBytes >= 6) + { + noiseLogged = true; + AppLog.Write($"[scan] 通道 {_channel.Number} 收到设备二进制帧,已忽略(非条码)"); + } + continue; + } + + pending.WriteByte(b); + if (pending.Length >= MaxLineBytes) Flush(pending); + } + } + + return "已停止"; + } + catch (OperationCanceledException) + { + return "已停止"; + } + catch (Exception ex) + { + // 设备断电重启时常见:Connection reset by peer / 对方强制关闭 + return ex.InnerException?.Message ?? ex.Message; + } + } + + private void Flush(MemoryStream pending) + { + if (pending.Length == 0) return; + + var text = Encoding.UTF8.GetString(pending.ToArray()); + pending.SetLength(0); + + var code = ScanProtocol.CleanBarcode(text); + if (code is null) return; + + _channel.LastCode = code; + _channel.LastCodeAt = DateTime.Now; + Barcode?.Invoke(_channel, code); + } + + private void SetState(bool connected) + { + if (_channel.Connected == connected) return; + + _channel.Connected = connected; + StateChanged?.Invoke(_channel, connected); + } + + public void Dispose() + { + Stop(); + _cts.Dispose(); + } +} diff --git a/desktop/Services/Scan/DeviceConfig.cs b/desktop/Services/Scan/DeviceConfig.cs new file mode 100644 index 0000000..403c9d6 --- /dev/null +++ b/desktop/Services/Scan/DeviceConfig.cs @@ -0,0 +1,504 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Net; +using System.Net.Sockets; +using System.Text; +using System.Text.Json; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// 设备上的一条 socket 配置(SOCK 段条目) +/// 原始字段(整条写回时用;真机上有设备会把别人的条目清掉,要靠它恢复) +public sealed record SockEntry(string Name, string Protocol, int LocalPort, + IReadOnlyDictionary? Raw = null); + +/// socket 条目的**运行状态**(CID 10001 才有 `ClientIP`,读配置没有) +public sealed record SockState(string Name, string Protocol, string State, string ClientIp) +{ + /// 设备侧记录的已连客户端 IP 列表(逗号分隔,可能多个) + public string[] Clients => ClientIp.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries); +} + +/// 设备侧「给中控用的 TCP 服务」的约定(照抄 AndroidScanCenter 的 TcpServerConfig) +public static class SockConfig +{ + /// + /// 设备固件看起来**最多只允许 3 条 SOCK 条目**:真机实测第 4 条写入回 `RC=0`、 + /// 能连上,但 ~1 分钟内会被设备默默丢掉(端口关闭),无限循环。 + /// 所以条目已满时改为「复用一条非保留条目」。 + /// + public const int MaxEntries = 3; + + /// 别人在用的条目名,絶不能动:Android 中控的 `scancenter`、推 WMS 的 `netp` + private static readonly string[] Reserved = + { + "scancenter", + "netp", + }; + + /// 这条条目是不是别人的(保留不动) + public static bool IsReserved(string name) + => Reserved.Any(item => item.Equals(name, StringComparison.OrdinalIgnoreCase)); + + /// + /// 构造一条完整的 SOCK 配置。 + /// + /// ⚠️ SOCK 段是**整条写**的:少传字段等于把那条配置改坏,所以字段集按官方工具原样给全。 + /// 设备按 `Name` 管条目,写我们这条不会动别的条(现场有其他条目:HTTP 推 WMS 等)。 + /// + public static Dictionary BuildEntry(string name) + { + return new Dictionary + { + ["Name"] = string.IsNullOrWhiteSpace(name) ? ScanProtocol.SockName : name, + ["Protocol"] = "TCP-SERVER", + ["LocalPort"] = ScanProtocol.TcpPort, + ["maxAccept"] = 5, + // 数据源选串口:扫码枪接在设备的 RS232/RS485 口上 + ["Rout"] = "uart", + ["BufSize"] = 512, + ["KeepAlive"] = 60, + ["ConnectMode"] = "Always", + ["Timeout"] = 0, + // 监听模式下 Server/ServerPort 没意义,明确清空,免得设备去连一个莫名其妙的地址 + ["Server"] = "", + ["ServerPort"] = 0, + ["StopSerial"] = "", + ["HeartBeatEn"] = 0, + ["HeartBeatTime"] = 0, + ["HeartBeatCode"] = "", + ["RegistMode"] = "Disable", + ["RegistCode"] = "", + ["Security"] = "Disable", + ["SecuKey"] = "", + ["VcomEn"] = 0, + ["VpTag"] = "", + }; + } + + /// 我们那条是否就绪:名字对得上、协议是 TCP-SERVER、端口也对(三项都要看) + public static bool IsReady(IEnumerable entries, string name) + => entries.Any(item => item.Name.Equals(name, StringComparison.OrdinalIgnoreCase) + && item.Protocol.Equals("TCP-SERVER", StringComparison.OrdinalIgnoreCase) + && item.LocalPort == ScanProtocol.TcpPort); + + /// 把设备上现有条目拼成一行(出错时要能看清设备上到底有哪几条) + public static string Describe(IEnumerable entries) + => string.Join(" / ", entries.Select(item => $"{item.Name}:{item.Protocol}:{item.LocalPort}")); +} + +/// 「确保设备 TCP 服务」的结果 +public enum TcpServerEnsureKind +{ + /// 本来就有可用的(不做任何写入) + AlreadyReady, + + /// 新建成功 + Created, + + /// 原来有但配置不对,已修正 + Fixed, + + /// 读不到设备的 SOCK 段(无应答) + ReadFailed, + + /// 写入失败 + WriteFailed, + + /// 写完回读发现还是不对(设备 RC=0 不代表真生效) + VerifyFailed, +} + +/// 「确保设备 TCP 服务」的结果 + 明细 +public sealed record TcpServerEnsureResult(TcpServerEnsureKind Kind, string Detail, string SockName = "") +{ + /// 三条「就绪」的结果都算成功 + public bool Ok => Kind is TcpServerEnsureKind.AlreadyReady or TcpServerEnsureKind.Created or TcpServerEnsureKind.Fixed; + + /// 给界面看的一句话 + public string Message => Kind switch + { + TcpServerEnsureKind.AlreadyReady => $"设备 TCP 服务已就绪(端口 {ScanProtocol.TcpPort})", + TcpServerEnsureKind.Created => $"已在设备上创建 TCP 服务(端口 {ScanProtocol.TcpPort})", + TcpServerEnsureKind.Fixed => $"已修正设备的 TCP 服务配置(端口 {ScanProtocol.TcpPort})", + TcpServerEnsureKind.ReadFailed => $"读不到设备 socket 配置:{Detail}", + TcpServerEnsureKind.WriteFailed => $"写入设备 socket 配置失败:{Detail}", + _ => $"写入后回读不符(设备上是:{Detail})", + }; +} + +/// +/// 设备配置写入(JCMD):SOCK 条目读写、落 flash、「确保 TCP 服务」。 +/// +/// 与 的分工:那边管发现和 SYS 读写,这里补上 +/// 添加通道时必须做的两件事 —— 让设备有一条给中控用的 TCP 服务、把设备名写进设备。 +/// +public static class DeviceConfig +{ + /// 读设备 SOCK 条目(CID 10003 的 SOCK 段;分片会按 `Remain` 续取) + public static async Task?> ReadSockEntriesAsync(this DeviceScanner _, string ip, + CancellationToken ct = default) + { + var merged = await ReadSectionAsync(ip, "SOCK", ScanProtocol.CidGetConfig, ct).ConfigureAwait(false); + if (merged is null) return null; + + var list = new List(); + if (merged.Value.ValueKind == JsonValueKind.Array) + { + foreach (var item in merged.Value.EnumerateArray()) + { + if (item.ValueKind != JsonValueKind.Object) continue; + + var raw = new Dictionary(StringComparer.OrdinalIgnoreCase); + foreach (var property in item.EnumerateObject()) raw[property.Name] = property.Value.Clone(); + + list.Add(new SockEntry( + GetString(item, "Name"), + GetString(item, "Protocol"), + GetInt(item, "LocalPort"), + raw)); + } + } + return list.Count == 0 ? null : list; + } + + /// + /// 读 SOCK 的**运行状态**(CID 10001)。 + /// + /// 只有这个来源带 `ClientIP` / `State`,用来做「假死」判定:设备断电重启时 + /// TCP 不会发 FIN/RST,中控这侧的 `ReadAsync` 会永久挂住 —— 只能回查设备侧 + /// 还认不认这条连接。 + /// + public static async Task?> ReadSockStatesAsync(this DeviceScanner _, string ip, + CancellationToken ct = default) + { + var merged = await ReadSectionAsync(ip, "SOCK", ScanProtocol.CidGetState, ct).ConfigureAwait(false); + if (merged is null) return null; + + var list = new List(); + if (merged.Value.ValueKind == JsonValueKind.Array) + { + foreach (var item in merged.Value.EnumerateArray()) + { + if (item.ValueKind != JsonValueKind.Object) continue; + list.Add(new SockState( + GetString(item, "SockName").Length > 0 ? GetString(item, "SockName") : GetString(item, "Name"), + GetString(item, "Protocol"), + GetString(item, "State"), + GetString(item, "ClientIP"))); + } + } + return list.Count == 0 ? null : list; + } + + /// + /// 确保设备上有一条「给中控用的 TCP 服务」。没有它这条通道就是死通道(永远连不上)。 + /// + /// 流程与 AndroidScanCenter 一致:读 SOCK → 就绪则不写 → 否则整条写入 → **回读确认**。 + /// 回读不能省:设备 `RC=0` 只代表报文收到了,端口冲突/条目名非法它不报错。 + /// + /// ⚠️ 设备最多只放得下 条(实测第 4 条会被静默丢弃), + /// 所以条目已满时**复用一条非保留条目**(把它的名字拿去改成我们的 8087), + /// 实际用的名字通过 返回,调用方要记住它。 + /// + /// 上次实际用的条目名(已知就直接用,避免又换一个) + public static async Task EnsureTcpServerAsync(this DeviceScanner scanner, string ip, + string? preferredName = null, CancellationToken ct = default) + { + var entries = await ReadSockEntriesWithRetryAsync(scanner, ip, ct).ConfigureAwait(false); + if (entries is null) return new TcpServerEnsureResult(TcpServerEnsureKind.ReadFailed, "设备无应答"); + + var name = string.IsNullOrWhiteSpace(preferredName) ? ScanProtocol.SockName : preferredName.Trim(); + + if (SockConfig.IsReady(entries, name)) + { + return new TcpServerEnsureResult(TcpServerEnsureKind.AlreadyReady, "", name); + } + + var existed = entries.Any(item => item.Name.Equals(name, StringComparison.OrdinalIgnoreCase)); + var reused = string.Empty; + + if (!existed && entries.Count >= SockConfig.MaxEntries) + { + // 条目满了:找一条不是别人的(不是 Android 的 scancenter、不是推 WMS 的 netp)来复用 + var candidate = entries.FirstOrDefault(item => !SockConfig.IsReserved(item.Name)); + if (candidate is null) + { + return new TcpServerEnsureResult(TcpServerEnsureKind.VerifyFailed, + $"设备 socket 条目已满({SockConfig.Describe(entries)}),且没有可复用的条目"); + } + + name = candidate.Name; + reused = candidate.Name; + } + + AppLog.Write($"[scan] 设备 {ip} 现有 socket 条目:{SockConfig.Describe(entries)};" + + (reused.Length > 0 + ? $"条目已满,复用「{reused}」改成我们的端口 {ScanProtocol.TcpPort}" + : existed + ? $"将修复「{name}」条目(端口 {ScanProtocol.TcpPort})" + : $"将新建「{name}」条目(端口 {ScanProtocol.TcpPort})")); + + var written = await WriteSectionAsync(ip, "SOCK", SockConfig.BuildEntry(name), ct).ConfigureAwait(false); + if (!written) return new TcpServerEnsureResult(TcpServerEnsureKind.WriteFailed, "写 SOCK 段失败", name); + + // 必须落 flash:SET_CONFIG 只改运行态,不落盘的话设备一旦重载/重启就丢, + // 现象是「刚才还能连,过一会儿就连接被拒」(端口没在监听了) + if (!await SaveToFlashAsync(ip, ct).ConfigureAwait(false)) + { + AppLog.Write($"[scan] 设备 {ip} 的 SOCK 配置已生效但未落 flash(重启后会丢)"); + } + + var after = await ReadSockEntriesWithRetryAsync(scanner, ip, ct).ConfigureAwait(false); + if (after is null) return new TcpServerEnsureResult(TcpServerEnsureKind.ReadFailed, "写入后回读无应答", name); + + // ⚠️ 真机踩过的坑:这台设备写 SOCK 段时,偶尔会把**别人的条目一起清掉** + //(实测把 netp 那条推 WMS 的 HTTP 配置弄没了)。写前已经拿到原始字段, + // 这里发现丢条就原样写回去,绝不静默把别人的配置吃掉。 + var lost = entries + .Where(item => !item.Name.Equals(name, StringComparison.OrdinalIgnoreCase)) + .Where(item => after.All(current => !current.Name.Equals(item.Name, StringComparison.OrdinalIgnoreCase))) + .ToList(); + + foreach (var item in lost) + { + if (item.Raw is null) continue; + + AppLog.Write($"[scan] ⚠️ 设备 {ip} 把条目「{item.Name}」弄丢了,正在原样写回"); + var restored = await WriteSectionAsync(ip, "SOCK", item.Raw, ct).ConfigureAwait(false); + AppLog.Write(restored + ? $"[scan] 设备 {ip} 条目「{item.Name}」已写回" + : $"[scan] 设备 {ip} 条目「{item.Name}」写回失败,请人工检查"); + } + + if (lost.Count > 0) + { + await SaveToFlashAsync(ip, ct).ConfigureAwait(false); + after = await ReadSockEntriesWithRetryAsync(scanner, ip, ct).ConfigureAwait(false); + if (after is null) return new TcpServerEnsureResult(TcpServerEnsureKind.ReadFailed, "写回后回读无应答", name); + } + + if (!SockConfig.IsReady(after, name)) + { + return new TcpServerEnsureResult(TcpServerEnsureKind.VerifyFailed, SockConfig.Describe(after), name); + } + + return new TcpServerEnsureResult( + existed || reused.Length > 0 ? TcpServerEnsureKind.Fixed : TcpServerEnsureKind.Created, + SockConfig.Describe(after), + name); + } + + /// + /// 把设备名写进设备(SYS.HostName,UTF-8 支持中文)+ 落 flash。 + /// + /// 实测改完不用重启:读回是新值,广播里也已经是新名。 + /// 落 flash(CID 10017)不能省 —— `SET_CONFIG` 只改运行态,不落盘一次重载就丢。 + /// + public static async Task WriteHostNameAsync(this DeviceScanner scanner, string ip, string name, + CancellationToken ct = default) + { + var trimmed = (name ?? string.Empty).Trim(); + if (trimmed.Length == 0) return true; + + var patch = new Dictionary { ["HostName"] = trimmed }; + if (!await WriteSectionAsync(ip, "SYS", patch, ct).ConfigureAwait(false)) return false; + + if (!await SaveToFlashAsync(ip, ct).ConfigureAwait(false)) + { + // 运行态已改成功,只是没落盘 —— 名字已经生效,不算失败,但要在日志里说清楚 + AppLog.Write($"[scan] 设备名 {trimmed} 已生效,但保存到 flash 失败(设备重载后会丢)"); + } + return true; + } + + /// 写任意配置段(CID 10005)。SYS 增量写;SOCK 整条写。 + public static async Task WriteSectionAsync(string ip, string section, object patch, + CancellationToken ct = default) + { + var body = JsonSerializer.Serialize(new + { + JCMD = 1, + PL = new Dictionary { [section] = patch }, + CID = ScanProtocol.CidSetConfig, + }); + + var reply = await SendAsync(ip, body, ScanProtocol.CidSetConfig + 1, ct).ConfigureAwait(false); + AppLog.Write($"[scan] 写设备配置 {ip}({section}):{reply}"); + return reply == 0; + } + + /// 把当前配置落 flash(CID 10017 `{"Action":"Set"}`) + public static async Task SaveToFlashAsync(string ip, CancellationToken ct = default) + { + var body = "{\"JCMD\":1,\"PL\":{\"Action\":\"Set\"},\"CID\":" + ScanProtocol.CidSaveFlash + "}"; + var reply = await SendAsync(ip, body, ScanProtocol.CidSaveFlash + 1, ct).ConfigureAwait(false); + AppLog.Write($"[scan] 保存设备配置到 flash {ip}:{reply}"); + return reply == 0; + } + + // ---------------- 内部 ---------------- + + /// 读 SOCK 条目,失败重试(现场 UDP 丢包约 6%,一次不回不能当「没有」) + private static async Task?> ReadSockEntriesWithRetryAsync(DeviceScanner scanner, string ip, + CancellationToken ct) + { + for (var attempt = 0; attempt < 3; attempt++) + { + var entries = await scanner.ReadSockEntriesAsync(ip, ct).ConfigureAwait(false); + if (entries is not null) return entries; + try + { + await Task.Delay(300, ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + } + return null; + } + + /// 读配置段(CID 10003)或状态段(CID 10001),分片按 `Remain` 续取后合并。读不到返回 null。 + private static async Task ReadSectionAsync(string ip, string section, int cid, + CancellationToken ct) + { + if (!IPAddress.TryParse(ip, out var address)) throw new ArgumentException($"IP 不合法:{ip}"); + + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.Client.ReceiveTimeout = 2500; + + var request = "{\"JCMD\":1,\"PL\":[\"" + section + "\"],\"CID\":" + cid + "}"; + var payload = ScanProtocol.Utf8(request); + await udp.SendAsync(payload, payload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + + var list = new List(); + var objects = new Dictionary(StringComparer.OrdinalIgnoreCase); + var any = false; + + for (var round = 0; round < 4; round++) + { + JsonDocument doc; + try + { + var buffer = await ScanProtocol.ReceiveWithTimeoutAsync(udp, 2500, ct).ConfigureAwait(false); + if (buffer is null) + { + break; // 超时(设备不应答) + } + + var text = Encoding.UTF8.GetString(buffer); + if (!text.TrimStart().StartsWith('{')) continue; + doc = JsonDocument.Parse(text); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception) + { + break; // 超时 / 坏包 + } + + int nextCid; + using (doc) + { + var root = doc.RootElement; + if (!root.TryGetProperty("CID", out var cidElement) || !cidElement.TryGetInt32(out var cidValue)) continue; + if (cidValue != cid + 1 && cidValue != cid + 2) continue; + + var rc = root.TryGetProperty("RC", out var rcElement) && rcElement.TryGetInt32(out var rcValue) ? rcValue : -1; + if (rc != 0) break; + + if (root.TryGetProperty("PL", out var pl) && pl.ValueKind == JsonValueKind.Object + && pl.TryGetProperty(section, out var content)) + { + any = true; + if (content.ValueKind == JsonValueKind.Array) + { + foreach (var item in content.EnumerateArray()) list.Add(item.Clone()); + } + else if (content.ValueKind == JsonValueKind.Object) + { + foreach (var property in content.EnumerateObject()) objects[property.Name] = property.Value.Clone(); + } + } + + var remain = root.TryGetProperty("Remain", out var remainElement) + && remainElement.TryGetInt32(out var remainValue) && remainValue == 1; + if (!remain) break; + + nextCid = cidValue; + } + + var next = "{\"JCMD\":1,\"Remain\":1,\"CID\":" + nextCid + "}"; + var nextPayload = ScanProtocol.Utf8(next); + await udp.SendAsync(nextPayload, nextPayload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + } + + if (!any) return null; + + // 数组段(SOCK)与对象段(SYS)合并成一份 + if (list.Count > 0) + { + var json = "[" + string.Join(",", list.Select(item => item.GetRawText())) + "]"; + using var merged = JsonDocument.Parse(json); + return merged.RootElement.Clone(); + } + + var objJson = "{" + string.Join(",", objects.Select(pair => JsonSerializer.Serialize(pair.Key) + ":" + pair.Value.GetRawText())) + "}"; + using var mergedDoc = JsonDocument.Parse(objJson); + return mergedDoc.RootElement.Clone(); + } + + /// 发一条 JCMD 单播并等指定 CID 的回复;返回 RC(-1 = 没回/坏包) + private static async Task SendAsync(string ip, string json, int expectedCid, CancellationToken ct) + { + if (!IPAddress.TryParse(ip, out var address)) throw new ArgumentException($"IP 不合法:{ip}"); + + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.Client.ReceiveTimeout = 2500; + + var payload = ScanProtocol.Utf8(json); + await udp.SendAsync(payload, payload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + + for (var round = 0; round < 3; round++) + { + try + { + var buffer = await ScanProtocol.ReceiveWithTimeoutAsync(udp, 2500, ct).ConfigureAwait(false); + if (buffer is null) return -1; // 超时 + + using var doc = JsonDocument.Parse(Encoding.UTF8.GetString(buffer)); + var root = doc.RootElement; + if (!root.TryGetProperty("CID", out var cid) || !cid.TryGetInt32(out var cidValue)) continue; + if (cidValue != expectedCid) continue; + + return root.TryGetProperty("RC", out var rc) && rc.TryGetInt32(out var rcValue) ? rcValue : -1; + } + catch (OperationCanceledException) + { + return -1; + } + catch (Exception) + { + return -1; + } + } + return -1; + } + + private static string GetString(JsonElement element, string name) + => element.TryGetProperty(name, out var value) && value.ValueKind == JsonValueKind.String + ? value.GetString() ?? string.Empty + : string.Empty; + + private static int GetInt(JsonElement element, string name) + => element.TryGetProperty(name, out var value) && value.TryGetInt32(out var number) ? number : 0; +} diff --git a/desktop/Services/Scan/DeviceScanner.cs b/desktop/Services/Scan/DeviceScanner.cs new file mode 100644 index 0000000..c5e25ee --- /dev/null +++ b/desktop/Services/Scan/DeviceScanner.cs @@ -0,0 +1,302 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Net; +using System.Net.NetworkInformation; +using System.Net.Sockets; +using System.Text; +using System.Text.Json; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// 局域网里发现到的一台扫码设备(UDP 48899 广播回复) +public sealed record DiscoveredDevice(string Mac, string Ip, string HostName, string Model, string Version, string State) +{ + public string Display => $"{HostName}({(string.IsNullOrEmpty(Ip) ? "?" : Ip)} · {Mac} · {Model})"; +} + +/// 设备 SYS 段配置(JCMD 10003 读回) +public sealed record DeviceSysConfig( + string HostName, + string IpAddr, + string Mask, + string GateWay, + string Dns, + bool DhcpEn, + string User, + string Password) +{ + public string Display => $"{HostName} · {(DhcpEn ? "DHCP" : "静态")} {IpAddr}"; +} + +/// +/// 设备发现与 JCMD 配置(从 AndroidScanCenter 的 DeviceScanner 移植到桌面端)。 +/// +/// 要点(见 AndroidScanCenter/docs/udp-48899-protocol.md): +/// - 往 `255.255.255.255:48899`(以及各网段的定向广播)发**明文 JSON**, +/// 设备的回复会回到**发送方的源端口**,所以必须**同一个 socket** 收发, +/// **不能**绑 48899 去收; +/// - 按 **MAC 去重**(一台设备会因为收到多个广播而回多个包); +/// - JCMD 配置/重启走 **UDP 单播到设备 IP:48899**,`{"JCMD":1,"CID":...}`, +/// `RC=0` 为成功;升级前不要发 `DO_RELOAD`(会把改动抹掉)。 +/// +public sealed class DeviceScanner +{ + private static readonly TimeSpan ReplyWait = TimeSpan.FromSeconds(1.6); + + /// 广播发现设备(每块网卡各广播一次) + public async Task> DiscoverAsync(CancellationToken ct = default) + { + var devices = new Dictionary(StringComparer.OrdinalIgnoreCase); + + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.EnableBroadcast = true; + + var targets = BroadcastTargets(); + var payload = ScanProtocol.Utf8(ScanProtocol.BroadcastPayload); + + foreach (var target in targets) + { + try + { + await udp.SendAsync(payload, payload.Length, new IPEndPoint(target, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + } + catch (Exception ex) + { + AppLog.Write($"[scan] 广播到 {target} 失败:{ex.Message}"); + } + } + + using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct); + timeout.CancelAfter(ReplyWait); + + while (!timeout.IsCancellationRequested) + { + try + { + var received = await udp.ReceiveAsync(timeout.Token).ConfigureAwait(false); + var text = Encoding.UTF8.GetString(received.Buffer); + if (!text.TrimStart().StartsWith('{')) continue; + + using var doc = JsonDocument.Parse(text); + var root = doc.RootElement; + if (!root.TryGetProperty("MAC", out var macElement) || macElement.ValueKind != JsonValueKind.String) continue; + + var mac = (macElement.GetString() ?? string.Empty).Trim().ToUpperInvariant(); + if (mac.Length == 0) continue; + + devices[mac] = new DiscoveredDevice( + mac, + received.RemoteEndPoint.Address.ToString(), + GetString(root, "HostName"), + GetString(root, "Type"), + GetString(root, "Version"), + GetString(root, "State")); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 解析发现回复失败:{ex.Message}"); + } + } + + AppLog.Write($"[scan] 发现 {devices.Count} 台设备"); + return devices.Values.OrderBy(item => item.Mac, StringComparer.Ordinal).ToList(); + } + + /// 读设备 SYS 配置(CID 10003;`Remain=1` 时用响应 CID 续取) + public async Task ReadSysConfigAsync(string ip, CancellationToken ct = default) + { + if (!IPAddress.TryParse(ip, out var address)) throw new ArgumentException($"IP 不合法:{ip}"); + + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.Client.ReceiveTimeout = 2500; + + var request = "{\"JCMD\":1,\"PL\":[\"SYS\"],\"CID\":" + ScanProtocol.CidGetConfig + "}"; + var payload = ScanProtocol.Utf8(request); + await udp.SendAsync(payload, payload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + + var all = new Dictionary(StringComparer.OrdinalIgnoreCase); + for (var round = 0; round < 4; round++) + { + JsonDocument doc; + try + { + var buffer = await ScanProtocol.ReceiveWithTimeoutAsync(udp, 2500, ct).ConfigureAwait(false); + if (buffer is null) break; // 超时 + + var text = Encoding.UTF8.GetString(buffer); + if (!text.TrimStart().StartsWith('{')) continue; + doc = JsonDocument.Parse(text); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception) + { + break; // 超时 / 坏包:结束 + } + + using (doc) + { + var root = doc.RootElement; + if (!root.TryGetProperty("CID", out var cid) || !cid.TryGetInt32(out var cidValue)) continue; + if (cidValue != ScanProtocol.CidGetConfig + 1 && cidValue != ScanProtocol.CidGetConfig + 2) continue; + + var rc = root.TryGetProperty("RC", out var rcElement) && rcElement.TryGetInt32(out var rcValue) ? rcValue : -1; + if (rc != 0) break; + + if (root.TryGetProperty("PL", out var pl) && pl.ValueKind == JsonValueKind.Object + && pl.TryGetProperty("SYS", out var sys) && sys.ValueKind == JsonValueKind.Object) + { + foreach (var property in sys.EnumerateObject()) + { + all[property.Name] = property.Value.Clone(); + } + } + + var remain = root.TryGetProperty("Remain", out var remainElement) + && remainElement.TryGetInt32(out var remainValue) && remainValue == 1; + if (!remain) break; + + // 没取完:用响应 CID 续取 + var next = "{\"JCMD\":1,\"Remain\":1,\"CID\":" + cidValue + "}"; + var nextPayload = ScanProtocol.Utf8(next); + await udp.SendAsync(nextPayload, nextPayload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + } + } + + if (all.Count == 0) return null; + + return new DeviceSysConfig( + GetString(all, "HostName"), + GetString(all, "IpAddr"), + GetString(all, "Mask"), + GetString(all, "GateWay"), + GetString(all, "Dns"), + GetInt(all, "DhcpEn") == 1, + GetString(all, "User"), + GetString(all, "Password")); + } + + /// + /// 写设备 SYS 配置(CID 10005,**增量**:只传要改的字段) + /// + /// ⚠️ 切 DHCP 会把 `IpAddr/Mask/GateWay` 清成 0.0.0.0;改回静态必须三个一起写。 + /// 写完**不要**发 `DO_RELOAD`(会把改动抹掉),想立刻生效用 `RestartAsync`。 + /// + public Task WriteSysConfigAsync(string ip, IReadOnlyDictionary patch, + CancellationToken ct = default) + => DeviceConfig.WriteSectionAsync(ip, "SYS", patch, ct); + + /// 重启设备(CID 20003;实测会延后几十秒到几分钟才真正复位) + public async Task RestartAsync(string ip, CancellationToken ct = default) + { + if (!IPAddress.TryParse(ip, out var address)) throw new ArgumentException($"IP 不合法:{ip}"); + + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.Client.ReceiveTimeout = 2000; + + var payload = ScanProtocol.Utf8("{\"JCMD\":1,\"CID\":" + ScanProtocol.CidDoRestart + "}"); + await udp.SendAsync(payload, payload.Length, new IPEndPoint(address, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + + try + { + var buffer = await ScanProtocol.ReceiveWithTimeoutAsync(udp, 2000, ct).ConfigureAwait(false); + if (buffer is null) + { + AppLog.Write($"[scan] 重启设备 {ip}:无应答"); + return false; + } + + using var doc = JsonDocument.Parse(Encoding.UTF8.GetString(buffer)); + var root = doc.RootElement; + var rc = root.TryGetProperty("RC", out var rcElement) && rcElement.TryGetInt32(out var rcValue) ? rcValue : -1; + AppLog.Write($"[scan] 重启设备 {ip}:RC={rc}"); + return rc == 0; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 重启设备失败 {ip}:{ex.Message}"); + return false; + } + } + + /// 广播目标:255.255.255.255 + 每块网卡的定向广播地址 + private static List BroadcastTargets() + { + var targets = new List { IPAddress.Broadcast }; + + try + { + foreach (var nic in NetworkInterface.GetAllNetworkInterfaces()) + { + if (nic.OperationalStatus != OperationalStatus.Up) continue; + if (nic.NetworkInterfaceType == NetworkInterfaceType.Loopback) continue; + + foreach (var unicast in nic.GetIPProperties().UnicastAddresses) + { + if (unicast.Address.AddressFamily != AddressFamily.InterNetwork) continue; + if (unicast.IPv4Mask is null) continue; + + var address = unicast.Address.GetAddressBytes(); + var mask = unicast.IPv4Mask.GetAddressBytes(); + if (address.Length != 4 || mask.Length != 4) continue; + + var broadcast = new byte[4]; + for (var i = 0; i < 4; i++) broadcast[i] = (byte)(address[i] | (mask[i] ^ 255)); + var target = new IPAddress(broadcast); + if (!targets.Contains(target)) targets.Add(target); + } + } + } + catch (Exception ex) + { + AppLog.Write($"[scan] 枚举网卡失败:{ex.Message}"); + } + + return targets; + } + + private static string GetString(JsonElement element, string property) + { + if (!element.TryGetProperty(property, out var value)) return string.Empty; + return value.ValueKind switch + { + JsonValueKind.String => (value.GetString() ?? string.Empty).Trim(), + JsonValueKind.Number => value.ToString(), + _ => string.Empty, + }; + } + + private static string GetString(IReadOnlyDictionary map, string key) + => map.TryGetValue(key, out var value) ? RawText(value) : string.Empty; + + private static string RawText(JsonElement value) => value.ValueKind switch + { + JsonValueKind.String => (value.GetString() ?? string.Empty).Trim(), + JsonValueKind.Number => value.ToString(), + _ => string.Empty, + }; + + private static int GetInt(IReadOnlyDictionary map, string key) + { + if (!map.TryGetValue(key, out var value)) return 0; + return value.ValueKind switch + { + JsonValueKind.Number => value.TryGetInt32(out var number) ? number : 0, + JsonValueKind.String => int.TryParse(value.GetString(), out var parsed) ? parsed : 0, + _ => 0, + }; + } +} diff --git a/desktop/Services/Scan/DiscoveryMonitor.cs b/desktop/Services/Scan/DiscoveryMonitor.cs new file mode 100644 index 0000000..8e2fd4f --- /dev/null +++ b/desktop/Services/Scan/DiscoveryMonitor.cs @@ -0,0 +1,272 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Net; +using System.Net.NetworkInformation; +using System.Net.Sockets; +using System.Text; +using System.Text.Json; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 常驻的设备发现(真正的「开着 UDP 口一直听」)。 +/// +/// 为什么不能只 bind 48899 被动收:**设备不会主动广播**(实测绑 48899 静听 40 秒, +/// 只能收到我们自己发出去的探测包),它只回**探测者**,而且回复发到**发送方的源端口** +/// (见 AndroidScanCenter/docs/udp-48899-protocol.md),所以在 48899 上 bind 收不到回复。 +/// +/// 所以做法是:**一个 socket 一直开着**,每 毫秒往 +/// `255.255.255.255` + 各网段定向广播发一次探测,然后在这**同一个 socket** 上持续收, +/// 按 MAC 合并、超过 没见过就摘掉。 +/// 这样界面是「一进来就在刷」的连续感,而不是「扫一轮停 5 秒」的一截一截。 +/// +public sealed class DiscoveryMonitor : IDisposable +{ + /// 多久探测一次(设备回包通常几十毫秒就回来) + private const int ProbeIntervalMs = 3000; + + /// 多久没再见到就算掉线(比探测间隔大,扛得住偶尔丢包) + private const int DeviceTimeoutMs = 12000; + + private readonly DeviceScanner _scanner = new(); + private readonly CancellationTokenSource _cts = new(); + private readonly Dictionary _devices = + new(StringComparer.OrdinalIgnoreCase); + + private Task? _loop; + + /// 设备列表有变化(新增/更新/掉线) + public event Action? Changed; + + /// 当前看到的设备(按 MAC 排序的快照) + public IReadOnlyList Devices + { + get + { + lock (_devices) + { + return _devices.Values.Select(item => item.Device) + .OrderBy(item => item.Mac, StringComparer.Ordinal) + .ToList(); + } + } + } + + public void Start() + { + if (_loop is not null) return; + _loop = Task.Run(() => LoopAsync(_cts.Token)); + AppLog.Write("[scan] 设备发现已开始(常驻 UDP,每 3 秒探测一次)"); + } + + private async Task LoopAsync(CancellationToken ct) + { + using var udp = new UdpClient(AddressFamily.InterNetwork); + udp.EnableBroadcast = true; + + var targets = BroadcastTargets(); + var payload = ScanProtocol.Utf8(ScanProtocol.BroadcastPayload); + var nextProbe = DateTime.MinValue; + + while (!ct.IsCancellationRequested) + { + var now = DateTime.Now; + + // 到点就探测一次(同一个 socket 发,回复才会回到这里) + if (now >= nextProbe) + { + foreach (var target in targets) + { + try + { + await udp.SendAsync(payload, payload.Length, new IPEndPoint(target, ScanProtocol.UdpPort)) + .WaitAsync(ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + return; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 广播到 {target} 失败:{ex.Message}"); + } + } + nextProbe = now.AddMilliseconds(ProbeIntervalMs); + } + + // 一直收:每次最多等 500ms,收完继续等(不关 socket、不留空档) + try + { + UdpReceiveResult? received = null; + using (var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct)) + { + timeout.CancelAfter(500); + try + { + received = await udp.ReceiveAsync(timeout.Token).ConfigureAwait(false); + } + catch (OperationCanceledException) when (!ct.IsCancellationRequested) + { + // 500ms 没包,很正常(没设备回 / 本轮已收完) + } + } + + if (received is not null) HandleReply(received.Value); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 收发现回复失败(忽略):{ex.Message}"); + } + + PruneStale(); + } + } + + /// 解析一条发现回复(按 MAC 合并;同一条会回多包,无所谓) + private void HandleReply(UdpReceiveResult reply) + { + string text; + try + { + text = Encoding.UTF8.GetString(reply.Buffer); + } + catch + { + return; + } + + if (!text.TrimStart().StartsWith('{')) return; + + string mac; + DiscoveredDevice device; + + try + { + using var doc = JsonDocument.Parse(text); + var root = doc.RootElement; + if (!root.TryGetProperty("MAC", out var macElement) || macElement.ValueKind != JsonValueKind.String) return; + + mac = (macElement.GetString() ?? string.Empty).Trim().ToUpperInvariant(); + if (mac.Length == 0) return; + + device = new DiscoveredDevice( + mac, + reply.RemoteEndPoint.Address.ToString(), + GetString(root, "HostName"), + GetString(root, "Type"), + GetString(root, "Version"), + GetString(root, "State")); + } + catch + { + return; + } + + var changed = false; + + lock (_devices) + { + if (!_devices.TryGetValue(mac, out var previous)) + { + _devices[mac] = (device, DateTime.Now); + changed = true; + } + else + { + // 名字/IP/状态变了才算变化(避免每 3 秒都刷一次界面) + if (previous.Device.Ip != device.Ip + || previous.Device.HostName != device.HostName + || previous.Device.State != device.State) + { + changed = true; + } + _devices[mac] = (device, DateTime.Now); + } + } + + if (changed) Changed?.Invoke(); + } + + private static string GetString(JsonElement element, string name) + => element.TryGetProperty(name, out var value) && value.ValueKind == JsonValueKind.String + ? value.GetString() ?? string.Empty + : string.Empty; + + private void PruneStale() + { + var deadline = DateTime.Now.AddMilliseconds(-DeviceTimeoutMs); + var removed = false; + + lock (_devices) + { + foreach (var mac in _devices.Where(item => item.Value.LastSeen < deadline).Select(item => item.Key).ToList()) + { + _devices.Remove(mac); + removed = true; + } + } + + if (removed) Changed?.Invoke(); + } + + /// 广播目标:255.255.255.255 + 每块网卡的定向广播地址 + private static List BroadcastTargets() + { + var targets = new List { IPAddress.Broadcast }; + + try + { + foreach (var nic in NetworkInterface.GetAllNetworkInterfaces()) + { + if (nic.OperationalStatus != OperationalStatus.Up) continue; + if (nic.NetworkInterfaceType == NetworkInterfaceType.Loopback) continue; + + foreach (var info in nic.GetIPProperties().UnicastAddresses) + { + if (info.Address.AddressFamily != AddressFamily.InterNetwork) continue; + + var mask = info.IPv4Mask; + if (mask is null) continue; + + var ip = info.Address.GetAddressBytes(); + var m = mask.GetAddressBytes(); + if (ip.Length != 4 || m.Length != 4) continue; + + var broadcast = new byte[4]; + for (var i = 0; i < 4; i++) broadcast[i] = (byte)(ip[i] | (m[i] ^ 0xFF)); + + var address = new IPAddress(broadcast); + if (!targets.Contains(address)) targets.Add(address); + } + } + } + catch (Exception ex) + { + AppLog.Write($"[scan] 枚举网卡失败(只用 255.255.255.255):{ex.Message}"); + } + + return targets; + } + + public void Dispose() + { + try + { + _cts.Cancel(); + } + catch + { + // 忽略 + } + + _cts.Dispose(); + AppLog.Write("[scan] 设备发现已停止"); + } +} diff --git a/desktop/Services/Scan/ScanChannel.cs b/desktop/Services/Scan/ScanChannel.cs new file mode 100644 index 0000000..a5dd387 --- /dev/null +++ b/desktop/Services/Scan/ScanChannel.cs @@ -0,0 +1,255 @@ +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Net.Sockets; +using System.Text; +using System.Text.Json; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 一条扫码通道 = 一台已纳入管理的扫码设备(原 AndroidScanCenter 的 Channel)。 +/// +/// 绑定键是 **MAC**(设备 DHCP,IP 会变),`LastIp` 只是「最后一次见到」的缓存。 +/// 通道**不再区分团购/散单**——团散在「工作台」上区分。 +/// +public sealed class ScanChannel +{ + /// 设备 MAC(12 位十六进制,大写) + public string Mac { get; set; } = string.Empty; + + /// 通道号(添加时分配最小空号,之后固定;上报时就是 channelId) + public int Number { get; set; } + + /// 显示名(默认取设备 HostName,可改) + public string Name { get; set; } = string.Empty; + + /// 最后一次见到的 IP + public string LastIp { get; set; } = string.Empty; + + /// 设备 TCP 端口(设备当服务端;桌面端用 8087,避开 Android 中控的 8086) + public int TcpPort { get; set; } = ScanProtocol.TcpPort; + + /// + /// 设备上我们实际用的 SOCK 条目名。 + /// + /// 默认是 (packcenter);但设备最多只能放 3 条条目, + /// 满了时会**复用一条非保留条目**(把它的名字拿去改成 8087),那时这里记的就是被复用的名字。 + /// + public string SockName { get; set; } = string.Empty; + + /// 是否启用(停用就不连、不上报) + public bool Enabled { get; set; } = true; + + /// 扫码枪是否静音(现场偏好,暂只记录) + public bool Muted { get; set; } + + public long AddedAtMs { get; set; } = DateTimeOffset.Now.ToUnixTimeMilliseconds(); + + // ---------------- 运行时状态(不落盘) ---------------- + + /// TCP 连接状态 + [System.Text.Json.Serialization.JsonIgnore] + public bool Connected { get; set; } + + /// 最近一条条码 + [System.Text.Json.Serialization.JsonIgnore] + public string LastCode { get; set; } = string.Empty; + + /// 最近条码时间 + [System.Text.Json.Serialization.JsonIgnore] + public DateTime? LastCodeAt { get; set; } + + [System.Text.Json.Serialization.JsonIgnore] + public string DisplayName => string.IsNullOrWhiteSpace(Name) ? (string.IsNullOrEmpty(Mac) ? "(未知)" : Mac) : Name.Trim(); + + /// 上报给服务端的 channelId(用通道号,稳定且短) + [System.Text.Json.Serialization.JsonIgnore] + public string ChannelId => Number.ToString(); +} + +/// 通道配置读写(普通模式 `%LOCALAPPDATA%\YuncangTrace\channels.json`;服务模式 `%ProgramData%\YuncangTrace\channels.json`) +public static class ChannelStore +{ + private static string Dir => AgentPaths.DataRoot; + + private static string FilePath => AgentPaths.ChannelsFile; + + private static readonly JsonSerializerOptions Options = new() + { + WriteIndented = true, + Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping, + }; + + /// 读通道列表(读不到返回空列表,绝不抛) + public static List Load() + { + try + { + if (!File.Exists(FilePath)) return new List(); + + var list = JsonSerializer.Deserialize>(File.ReadAllText(FilePath), Options) + ?? new List(); + + NormalizeNumbers(list); + MigratePort(list); + return list; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 读取通道配置失败:{ex.Message}"); + return new List(); + } + } + + /// 保存通道列表(只落盘持久字段,运行时状态由 JsonIgnore 排除) + public static void Save(IEnumerable channels) + { + try + { + Directory.CreateDirectory(Dir); + File.WriteAllText(FilePath, JsonSerializer.Serialize(channels.ToList(), Options)); + } + catch (Exception ex) + { + AppLog.Write($"[scan] 保存通道配置失败:{ex.Message}"); + } + } + + /// 老数据/缺号的数据补齐通道号(分配最小空号,删掉的不复用) + private static void NormalizeNumbers(List list) + { + var used = new HashSet(list.Where(item => item.Number > 0).Select(item => item.Number)); + foreach (var channel in list.Where(item => item.Number <= 0)) + { + var number = 1; + while (used.Contains(number)) number++; + channel.Number = number; + used.Add(number); + } + } + + /// 分配最小的空号 + public static int NextNumber(IEnumerable channels) + { + var used = new HashSet(channels.Select(item => item.Number)); + var number = 1; + while (used.Contains(number)) number++; + return number; + } + + /// + /// 旧配置里存的是 8086(早期跟 Android 中控共用的端口)→ 改成桌面端自己的端口。 + /// 改了之后设备上还没这条条目,靠「连不上时自愈」自动建。 + /// + private static void MigratePort(List list) + { + var migrated = list.Where(item => item.TcpPort != ScanProtocol.TcpPort).ToList(); + if (migrated.Count == 0) return; + + foreach (var channel in migrated) + { + AppLog.Write($"[scan] 通道 {channel.Number} 端口 {channel.TcpPort} → {ScanProtocol.TcpPort}(不再与 Android 中控的 8086 共用)"); + channel.TcpPort = ScanProtocol.TcpPort; + } + + Save(list); + } + + /// 通道号上限(与原中控一致:现场是工位号,量级几十) + public const int MaxNumber = 50; + + /// 某个号是否已被别的通道占用( 用于「改自己」时排除自己) + public static ScanChannel? FindByNumber(IEnumerable channels, int number, string? exceptMac = null) + { + return channels.FirstOrDefault(item => item.Number == number + && (exceptMac is null || !item.Mac.Equals(exceptMac, StringComparison.OrdinalIgnoreCase))); + } +} + +/// 扫码链路用到的常量(与设备固件一致) +public static class ScanProtocol +{ + /// UDP 发现 / JCMD 端口(设备监听) + public const int UdpPort = 48899; + + /// + /// 设备侧 TCP 监听端口(设备当服务端,把串口数据推给连上来的人)。 + /// + /// ⚠️ 不用 8086:那是 Android 中控(条目 `scancenter`)在用的。同一台设备上 + /// 两条连接都往串口写,设置会互相覆盖(Android 那边重连时会把静音顶掉)。 + /// 桌面端用**自己的条目名 + 自己的端口**,互不干扰。 + /// + public const int TcpPort = 8087; + + /// 广播报文(`ConnectMode` 必须是 Forbidden:只发现,不改设备服务器配置) + public const string BroadcastPayload = + "{\"Agent\":0,\"Type\":\"EP_Tool\",\"PasswordEn\":0,\"ServPort\":0,\"Version\":\"3.1.3f\"," + + "\"ConnectMode\":\"Forbidden\",\"Zone\":\"EPort\",\"ServEn\":1,\"ServAddr\":\"0.0.0.0\",\"ClientEn\":0}"; + + // JCMD 命令号 + /// 读配置(10003→10004) + public const int CidGetConfig = 10003; + + /// 读运行状态(10001→10002):只有它回来的 SOCK 条目才带 `ClientIP` + public const int CidGetState = 10001; + + /// 写配置(10005→10006,增量;SOCK 段是整条写) + public const int CidSetConfig = 10005; + + /// 把配置落 flash(10017→10018):不落盘的话一次重载就丢(原中控已实测) + public const int CidSaveFlash = 10017; + + public const int CidDoRestart = 20003; + + /// 桌面端自己的 SOCK 条目名(不能跟 Android 的 `scancenter` 重名) + public const string SockName = "packcenter"; + + /// 条码合法性(与原中控一致:去空白后 4~64 位,不含控制字符) + public static string? CleanBarcode(string? raw) + { + if (string.IsNullOrWhiteSpace(raw)) return null; + + // 设备每 ~0.7s 推一帧 `04 D0 00 00 FF 2C`:控制字节会被当分帧清掉, + // 但结尾那个 0x2C(',')是可打印字符,会粘在紧接着的条码前面, + // 现场出现的就是 `,6901028011778`。条码本体不会以非字母数字开头/结尾, + // 所以首尾的非字母数字一律削掉(**中间的保留**,GS1 内部可能有 `-` `/`)。 + var text = raw.Trim(); + text = System.Text.RegularExpressions.Regex.Replace(text, "^[^0-9A-Za-z]+", string.Empty); + text = System.Text.RegularExpressions.Regex.Replace(text, "[^0-9A-Za-z]+$", string.Empty); + + if (text.Length is < 4 or > 64) return null; + if (text.Any(ch => char.IsControl(ch))) return null; + return text; + } + + /// + /// 收一个 UDP 包,带**真实超时**。 + /// + /// ⚠️ `UdpClient.Client.ReceiveTimeout` 只对**同步** `Receive` 生效, + /// `ReceiveAsync` 完全不看它 —— 设备不回应时会一直挂着(自愈/读配置就卡死在那里)。 + /// + /// 收到返回字节;超时返回 null(调用方据此当“没应答”处理) + public static async Task ReceiveWithTimeoutAsync(UdpClient udp, int timeoutMs, + CancellationToken ct = default) + { + using var cts = CancellationTokenSource.CreateLinkedTokenSource(ct); + cts.CancelAfter(timeoutMs); + + try + { + var received = await udp.ReceiveAsync(cts.Token).ConfigureAwait(false); + return received.Buffer; + } + catch (OperationCanceledException) when (!ct.IsCancellationRequested) + { + return null; // 超时 + } + } + + /// UTF-8 无 BOM 字节(UDP/TCP 报文都用它) + public static byte[] Utf8(string text) => new UTF8Encoding(false).GetBytes(text); +} diff --git a/desktop/Services/Scan/ScanRecordStore.cs b/desktop/Services/Scan/ScanRecordStore.cs new file mode 100644 index 0000000..c235744 --- /dev/null +++ b/desktop/Services/Scan/ScanRecordStore.cs @@ -0,0 +1,631 @@ +using System; +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Text.Json; +using System.Text.Json.Serialization; +using System.Threading; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 一条扫码记录(本地库,也是上报队列的元素)。 +/// +/// 与 AndroidScanCenter 的 scan_record 表对应:先落本地、再上报, +/// **上报成功(服务器确认)才把 置 true**,失败的下一轮重试, +/// 所以断网期间的条码不会丢。 +/// +public sealed class ScanRecordItem +{ + /// 自增序号(= 写入顺序,去重和分页都靠它) + public long Id { get; set; } + + /// 通道号(上报时的 channelId) + public string ChannelId { get; set; } = string.Empty; + + /// 通道名(记录用;通道改名后老记录保持当时的名字) + public string ChannelName { get; set; } = string.Empty; + + /// 条码 + public string Code { get; set; } = string.Empty; + + /// + /// **最近一次**扫到这个条码的时间(本地时间)。 + /// + /// 连续扫描时同一个码会反复扫到,这里一直刷新成最后一次; + /// 停 没再扫到才上报,上报的就是这个时间。 + /// + public DateTime ScannedAt { get; set; } + + /// 服务器是否已确认收到 + public bool Uploaded { get; set; } + + /// + /// 旧版本「24 小时内重复扫描、不上报」留下的标记(只为兼容历史本地库)。 + /// + /// 新规则不再产生这种记录:同一运单在服务器侧只保留一条, + /// 后扫到的时间会覆盖前一次,所以这里只为让老记录继续显示成「重复·不上报」。 + /// + public bool Suppressed { get; set; } + + /// 确认时间 + public DateTime? UploadedAt { get; set; } + + /// 上次落盘时的 (连续扫描时省得每 80ms 写一次盘) + [JsonIgnore] + public DateTime? PersistedScannedAt { get; set; } + + [JsonIgnore] + public string TimeText => ScannedAt.ToString("MM-dd HH:mm:ss"); + + [JsonIgnore] + public string UploadText => Uploaded ? "已上传" : Suppressed ? "重复·不上报" : "待上传"; + + [JsonIgnore] + public string UploadedAtText => UploadedAt is null ? "—" : UploadedAt.Value.ToString("MM-dd HH:mm:ss"); +} + +/// 新增/刷新一条扫码记录的结果类型 +public enum ScanAddKind +{ + /// 条码为空等非法输入,没落库 + Invalid, + + /// 连续扫描:跟该通道上一次是同一个码,只刷新了最近扫描时间,界面不用重查 + Repeated, + + /// 新建了一条待上报记录 + Created, + + /// + /// 刷新了已有记录的时间:同一个码还有未上报的记录,或已上报的记录被重新激活 + /// (扫码枪范围大、多个面单轮流被扫到时走这条)。 + /// + Touched, +} + +/// 的结果 +public readonly record struct ScanAddResult(ScanAddKind Kind, ScanRecordItem? Item) +{ + /// 是否是一次「新的扫码事件」(连续扫描的重复帧不算) + public bool IsScanEvent => Kind is ScanAddKind.Created or ScanAddKind.Touched; +} + +/// +/// 本地扫码记录库(`%LOCALAPPDATA%\YuncangTrace\scan-records.json`)。 +/// +/// 为什么要有它(照搬 AndroidScanCenter 的经验): +/// - **断网不丢**:条码先落本地,服务器确认后才标记已上传,否则一直重试; +/// - **通道回放**:现场要能翻「这台设备刚才扫了什么」,不能只留一条「最近条码」; +/// - **连续扫描去重**:同一个码每 ~80ms 报一次,只刷新「最近一次扫到的时间」, +/// 不新增记录(所以「A A A B A」记成 A、B 两条,A 的时间是最后一次扫到的时刻); +/// - **延迟上报**:扫到后 (5 分钟)内没再扫到才进上报队列, +/// 上报的是**最后一次**扫描时间。面单一直放在扫码器上时,时间会一直往后刷, +/// 直到面单被贴走/拿开,这才是包裹真正离开工作台的时刻; +/// - 同一个码在 24 小时内再次扫到时会**复用/重新激活同一条本地记录**(不新增行), +/// 5 分钟静默后重新上报,**服务器侧覆盖**原来那条记录的时间和工作台快照 +/// (不再像旧版本那样「24 小时内重复的不上报」)。 +/// +/// 全部操作加锁:调用方既有收条码的连接线程,也有界面线程和上报重试线程。 +/// +public static class ScanRecordStore +{ + /// 每个通道最多保留多少条(不封顶的话文件会一直长;删最旧的) + private const int MaxPerChannel = 5000; + + /// + /// 延迟上报的静默窗口:扫到后这么久没再扫到同一个码,才允许上报。 + /// 连续扫描时每次扫到都会把时间往后推,所以上报的是「最后一次扫描」。 + /// + public static readonly TimeSpan SettleDelay = TimeSpan.FromMinutes(5); + + /// + /// 同一运单在本地复用同一条记录的窗口(与后端的合并窗口一致:24 小时)。 + /// + /// 已上报的记录又被扫到(扫码枪范围大、两个面单轮流被扫)时, + /// **重新激活这一条**而不是新增一行,避免同一个运单在本地堆出多条; + /// 超过 24 小时再扫,才算一条新的记录。 + /// + public static readonly TimeSpan MergeWindow = TimeSpan.FromHours(24); + + /// 连续扫描时最多多久落一次盘(本地库是整文件重写,不能每 80ms 写一次) + private static readonly TimeSpan PersistInterval = TimeSpan.FromSeconds(30); + + private static readonly object Gate = new(); + private static List _items = new(); + private static long _nextId = 1; + private static bool _loaded; + private static DateTime _loadedWriteTime = DateTime.MinValue; + private static bool _dirty; + private static DateTime _lastSaveAt = DateTime.MinValue; + private static Timer? _flushTimer; + + /// 记录有变化(新增 / 标记已上传 / 清空),界面据此刷新 + public static event Action? Changed; + + /// + /// 扫码记录**上报成功**(服务器已确认)。参数 = 这批记录里新上传的条码(已去重)。 + /// + /// 桌面端用它来补一次「扫码时查不到(还没上报)→ 上报成功后自动重查」。 + /// + public static event Action>? Uploaded; + + private static string Dir => AgentPaths.DataRoot; + + private static string FilePath => AgentPaths.RecordsFile; + + private static readonly JsonSerializerOptions Options = new() + { + WriteIndented = false, + Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping, + }; + + /// 读盘(只读一次;读不到就当空库,绝不抛) + private static void EnsureLoaded() + { + if (_loaded) + { + // 服务模式:后台服务是**写入方**,桌面端只读展示 → 文件变了就重新加载 + if (AgentPaths.MachineMode && !AgentPaths.IsServiceProcess) ReloadIfChanged(); + return; + } + + _loaded = true; + LoadFromDisk(); + } + + private static void LoadFromDisk() + { + try + { + if (!File.Exists(FilePath)) + { + _items = new List(); + _nextId = 1; + _loadedWriteTime = DateTime.MinValue; + return; + } + + var list = JsonSerializer.Deserialize>(File.ReadAllText(FilePath), Options); + if (list is null) return; + + _items = list.Where(item => !string.IsNullOrWhiteSpace(item.Code)).ToList(); + foreach (var item in _items) item.PersistedScannedAt = item.ScannedAt; + _nextId = _items.Count == 0 ? 1 : _items.Max(item => item.Id) + 1; + _loadedWriteTime = File.GetLastWriteTimeUtc(FilePath); + } + catch (Exception ex) + { + AppLog.Write($"[scan] 读取扫码记录失败(按空库继续):{ex.Message}"); + } + } + + /// 别的进程(后台服务)写过文件了就重新加载(只在服务模式的桌面端调用) + private static void ReloadIfChanged() + { + DateTime writeTime; + try + { + if (!File.Exists(FilePath)) return; + writeTime = File.GetLastWriteTimeUtc(FilePath); + } + catch + { + return; + } + + if (writeTime == _loadedWriteTime) return; + + _dirty = false; + LoadFromDisk(); + } + + /// + /// 记一条扫码记录。 + /// + /// - 连续扫描(跟该通道上一条是同一个码、且还没上报)→ 只刷新 , + /// 返回 (界面不用重查,避免刷屏); + /// - 同一个码还有一条没上报的记录(例如 A B A)→ 刷新那条的时间,返回 ; + /// - 同一个码 24 小时内**已经上报过**、现在又被扫到(扫码枪范围大 / 两个面单轮流被扫)→ + /// **重新激活原来那条**(不新增行),静默 5 分钟后再上报覆盖服务器记录; + /// - 其它情况新建一条记录。 + /// + public static ScanAddResult Add(string channelId, string channelName, string code, DateTime scannedAt) + { + var key = (channelId ?? string.Empty).Trim(); + var text = (code ?? string.Empty).Trim(); + if (key.Length == 0 || text.Length == 0) return new ScanAddResult(ScanAddKind.Invalid, null); + + ScanAddResult result; + lock (Gate) + { + EnsureLoaded(); + + var name = (channelName ?? string.Empty).Trim(); + var windowStart = scannedAt - MergeWindow; + + // 连续扫描:同一个码每 ~80ms 报一次,只把时间刷到最新 + var last = _items.LastOrDefault(item => item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase)); + if (last is not null && last.Code.Equals(text, StringComparison.Ordinal)) + { + if (!last.Uploaded && !last.Suppressed) + { + Touch(last, scannedAt, name); + result = new ScanAddResult(ScanAddKind.Repeated, last); + } + else if (last.ScannedAt > windowStart) + { + // 已经上报过、24 小时内又被扫到 → 重新激活这一条(不再新增本地行) + Reopen(last, scannedAt, name); + result = new ScanAddResult(ScanAddKind.Touched, last); + } + else + { + result = new ScanAddResult(ScanAddKind.Created, Create(key, name, text, scannedAt)); + } + } + else + { + // 同一个码中途又扫到(A B A):优先刷新那条还没上报的记录, + // 避免同一个包裹在界面上堆出多条。 + var pending = _items.LastOrDefault(item => + item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase) + && item.Code.Equals(text, StringComparison.Ordinal) + && !item.Uploaded + && !item.Suppressed); + + if (pending is not null) + { + Touch(pending, scannedAt, name); + result = new ScanAddResult(ScanAddKind.Touched, pending); + } + else + { + // 已经上报过的同一条码(24 小时内)→ 重新激活原来那条, + // 静默 5 分钟后再上报,后端会覆盖成最新扫描时间 + 工作台快照。 + var uploaded = _items + .Where(item => item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase) + && item.Code.Equals(text, StringComparison.Ordinal) + && item.ScannedAt > windowStart) + .OrderByDescending(item => item.ScannedAt) + .ThenByDescending(item => item.Id) + .FirstOrDefault(); + + if (uploaded is not null) + { + Reopen(uploaded, scannedAt, name); + result = new ScanAddResult(ScanAddKind.Touched, uploaded); + } + else + { + result = new ScanAddResult(ScanAddKind.Created, Create(key, name, text, scannedAt)); + } + } + } + } + + SaveThrottled(); + if (result.IsScanEvent) Changed?.Invoke(); + return result; + } + + /// 新建一条待上报记录(调用方已加锁) + private static ScanRecordItem Create(string channelId, string channelName, string code, DateTime scannedAt) + { + var added = new ScanRecordItem + { + Id = _nextId++, + ChannelId = channelId, + ChannelName = channelName, + Code = code, + ScannedAt = scannedAt, + Uploaded = false, + Suppressed = false, + }; + _items.Add(added); + TrimChannel(channelId); + _dirty = true; + return added; + } + + /// + /// 把记录的「最近扫描时间」刷新到最新(调用方已加锁)。 + /// 落盘做 30 秒节流:连续扫描时内存里每次都要更新,但没必要每 80ms 重写整个文件。 + /// + private static void Touch(ScanRecordItem item, DateTime scannedAt, string channelName) + { + item.ScannedAt = scannedAt; + if (!string.IsNullOrWhiteSpace(channelName)) item.ChannelName = channelName; + + if (item.PersistedScannedAt is null + || scannedAt - item.PersistedScannedAt.Value >= PersistInterval) + { + _dirty = true; + } + } + + /// + /// 重新激活一条**已上报**(或旧规则标记为重复)的记录(调用方已加锁)。 + /// + /// 扫码枪范围太大时,两个面单会轮流被扫:A 刚上报完、过一会儿又被扫到。 + /// 这时不新增本地行,而是把原来那条改回「待上传」并刷新时间, + /// 静默 5 分钟后再上报 —— 后端会把同一条记录覆盖成最新扫描时间。 + /// + private static void Reopen(ScanRecordItem item, DateTime scannedAt, string channelName) + { + item.ScannedAt = scannedAt; + if (!string.IsNullOrWhiteSpace(channelName)) item.ChannelName = channelName; + item.Uploaded = false; + item.UploadedAt = null; + item.Suppressed = false; + _dirty = true; + } + + /// + /// 可以上报的一批(按写入顺序,头进头出)。 + /// + /// **默认只返回静默满 (5 分钟)的记录**:扫到后 5 分钟内又扫到同一个码, + /// 会被刷新,这条就继续等,不会提前上报。 + /// + public static List Pending(int limit) => Pending(limit, SettleDelay); + + /// 可以上报的一批(指定静默窗口;调试/测试可传 ) + public static List Pending(int limit, TimeSpan settle) + { + var cutoff = DateTime.Now - settle; + lock (Gate) + { + EnsureLoaded(); + return _items + .Where(item => !item.Uploaded && !item.Suppressed && item.ScannedAt <= cutoff) + .OrderBy(item => item.Id) + .Take(limit) + .ToList(); + } + } + + /// 待上报条数(含还在静默期的记录;不含旧版本标记的重复记录) + public static int PendingCount() + { + lock (Gate) + { + EnsureLoaded(); + return _items.Count(item => !item.Uploaded && !item.Suppressed); + } + } + + /// 已经静默满 5 分钟、可以真正上报的条数 + public static int ReadyCount() + { + var cutoff = DateTime.Now - SettleDelay; + lock (Gate) + { + EnsureLoaded(); + return _items.Count(item => !item.Uploaded && !item.Suppressed && item.ScannedAt <= cutoff); + } + } + + /// 这个条码是否有「还没上报」的本地记录(桌面端用来提示“等待上报后自动查询”) + public static bool HasPending(string code) + { + var text = (code ?? string.Empty).Trim(); + if (text.Length == 0) return false; + + lock (Gate) + { + EnsureLoaded(); + return _items.Any(item => !item.Uploaded && !item.Suppressed && item.Code.Equals(text, StringComparison.Ordinal)); + } + } + + /// 某通道(null/空 = 全部)最近的记录,新的一头在前 + public static List Recent(string? channelId, int limit = 500) + { + lock (Gate) + { + EnsureLoaded(); + var query = _items.AsEnumerable(); + if (!string.IsNullOrWhiteSpace(channelId)) + { + query = query.Where(item => item.ChannelId.Equals(channelId.Trim(), StringComparison.OrdinalIgnoreCase)); + } + return query.OrderByDescending(item => item.Id).Take(limit).ToList(); + } + } + + /// + /// 分页取记录(新的一头在前) + /// + /// 本地库每通道最多 5000 条,全塞进 ListView 会卡;界面按页取(默认 200 条/页)。 + /// + /// null/空 = 全部通道 + /// 页码,0 起 + /// 每页条数(<=0 时按 200) + /// 当前页记录 / 总条数(用于算页数) + public static (List Items, int Total) Page(string? channelId, int page, int pageSize = 200) + { + if (pageSize <= 0) pageSize = 200; + if (page < 0) page = 0; + + lock (Gate) + { + EnsureLoaded(); + + var query = _items.AsEnumerable(); + if (!string.IsNullOrWhiteSpace(channelId)) + { + query = query.Where(item => item.ChannelId.Equals(channelId.Trim(), StringComparison.OrdinalIgnoreCase)); + } + + var ordered = query.OrderByDescending(item => item.Id).ToList(); + var total = ordered.Count; + var items = ordered.Skip(page * pageSize).Take(pageSize).ToList(); + return (items, total); + } + } + + /// 总条数 / 待上传条数(界面统计用;含还在 5 分钟静默期的记录) + public static (int Total, int Pending) Stats() + { + lock (Gate) + { + EnsureLoaded(); + return (_items.Count, _items.Count(item => !item.Uploaded && !item.Suppressed)); + } + } + + /// + /// 服务器确认收到:标记为已上传(**只在拿到成功响应后调用**)。 + /// + /// 传入每条记录**上报时**的扫描时间:如果上报期间又扫到了同一个码 + /// ( 已经更新),这条保持「待上传」, + /// 下一轮会带着最新时间再上报一次,避免最新时间被这次成功回执覆盖掉。 + /// + public static void MarkUploaded(IEnumerable<(long Id, DateTime ScannedAt)> uploaded) + { + var map = uploaded.GroupBy(item => item.Id).ToDictionary(group => group.Key, group => group.First().ScannedAt); + if (map.Count == 0) return; + + var codes = new List(); + lock (Gate) + { + EnsureLoaded(); + var now = DateTime.Now; + var marked = 0; + foreach (var item in _items.Where(item => map.ContainsKey(item.Id) && !item.Uploaded)) + { + if (item.ScannedAt != map[item.Id]) continue; // 上报期间又扫到,保持待上传 + item.Uploaded = true; + item.UploadedAt = now; + marked++; + if (!codes.Contains(item.Code)) codes.Add(item.Code); + } + if (marked == 0) return; + _dirty = true; + } + + SaveThrottled(); + Changed?.Invoke(); + if (codes.Count > 0) Uploaded?.Invoke(codes); + } + + /// 清空(channelId 为空 = 清全部) + public static int Clear(string? channelId = null) + { + int removed; + lock (Gate) + { + EnsureLoaded(); + if (string.IsNullOrWhiteSpace(channelId)) + { + removed = _items.Count; + _items = new List(); + } + else + { + var key = channelId.Trim(); + removed = _items.RemoveAll(item => item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase)); + } + if (removed == 0) return 0; + _dirty = true; + } + + Save(force: true); + Changed?.Invoke(); + return removed; + } + + /// 强制落盘(退出前调用) + public static void Flush() + { + lock (Gate) + { + EnsureLoaded(); + // 连续扫描时 ScannedAt 可能还没到落盘间隔 → 退出前把最新的也写下去 + if (!_dirty && _items.All(item => item.PersistedScannedAt == item.ScannedAt)) return; + } + Save(force: true); + } + + /// 每个通道的超额部分(最旧的)删掉 + private static void TrimChannel(string channelId) + { + var mine = _items.Where(item => item.ChannelId.Equals(channelId, StringComparison.OrdinalIgnoreCase)) + .OrderByDescending(item => item.Id) + .ToList(); + if (mine.Count <= MaxPerChannel) return; + + var drop = new HashSet(mine.Skip(MaxPerChannel).Select(item => item.Id)); + _items.RemoveAll(item => drop.Contains(item.Id)); + } + + /// + /// 写盘节流:连续扫码时不要每条都整表重写(最多 2 秒一次)。 + /// ⚠️ 被节流掉的那次**必须补写**,否则「已上传」标记会丢在内存里 —— + /// 重启后记录又变回待上传(虽然服务端会去重,但状态就是错的)。 + /// + private static void SaveThrottled() + { + bool wait; + lock (Gate) + { + if (!_dirty) return; // 连续扫描只刷了时间、还没到落盘间隔 → 不用写 + wait = (DateTime.Now - _lastSaveAt).TotalSeconds < 2; + } + + if (wait) + { + ScheduleDelayedFlush(); + return; + } + + Save(force: false); + } + + /// 被节流后补一次写盘(只排一个定时器,不堆积) + private static void ScheduleDelayedFlush() + { + lock (Gate) + { + if (_flushTimer is not null) return; + + _flushTimer = new Timer(_ => + { + lock (Gate) + { + _flushTimer?.Dispose(); + _flushTimer = null; + } + Save(force: false); + }, null, 2200, Timeout.Infinite); + } + } + + private static void Save(bool force) + { + string json; + lock (Gate) + { + if (!_dirty && !force) return; + if (!force && (DateTime.Now - _lastSaveAt).TotalSeconds < 2) return; + + json = JsonSerializer.Serialize(_items, Options); + foreach (var item in _items) item.PersistedScannedAt = item.ScannedAt; + _dirty = false; + _lastSaveAt = DateTime.Now; + } + + try + { + Directory.CreateDirectory(Dir); + var temp = FilePath + ".tmp"; + File.WriteAllText(temp, json); + File.Copy(temp, FilePath, overwrite: true); + File.Delete(temp); + } + catch (Exception ex) + { + AppLog.Write($"[scan] 保存扫码记录失败:{ex.Message}"); + } + } +} diff --git a/desktop/Services/Scan/ScanService.cs b/desktop/Services/Scan/ScanService.cs new file mode 100644 index 0000000..1c42d20 --- /dev/null +++ b/desktop/Services/Scan/ScanService.cs @@ -0,0 +1,664 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Threading; +using System.Threading.Tasks; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 扫码服务(从 AndroidScanCenter 移植到桌面端):管通道配置 + TCP 收码 + 上报服务器。 +/// +/// - 只有**设备服务开启**(主体管理员)并且扫码服务启动时才真正连设备; +/// - 每条通道一条 TCP 连接,收到条码 → 过滤 → 交给 上报; +/// - 通道也上报给服务器(`POST /api/scan/channels`),施工时在「工作台」里绑定通道(团散在工作台区分)。 +/// +public sealed class ScanService +{ + private readonly DeviceService _device; + private readonly DeviceScanner _scanner = new(); + private readonly Dictionary _connections = new(StringComparer.OrdinalIgnoreCase); + private readonly SemaphoreSlim _gate = new(1, 1); + + // 通道自动同步:任何变动 → 唤醒后台循环 → 推上去 + 回查确认,失败退避重试直到成功 + private readonly SemaphoreSlim _syncSignal = new(0, 1); + private CancellationTokenSource? _syncCts; + private Task? _syncTask; + private int _syncRetryMs = 1000; + + // 看门狗:设备断电重启时 TCP 不发 FIN,read 会永久挂住 → 定期回查设备侧 ClientIP + private CancellationTokenSource? _watchdogCts; + private Task? _watchdogTask; + + /// 每个通道上次自愈的时间(每台设备 60 秒最多查一次) + private readonly Dictionary _lastHealAt = new(StringComparer.OrdinalIgnoreCase); + + /// 每个通道上次写「连不上/自愈」日志的时间(离线设备不要每 60 秒刷屏) + private readonly Dictionary _healLogAt = new(StringComparer.OrdinalIgnoreCase); + + /// 常驻发现(开关打开时才有) + private DiscoveryMonitor? _monitor; + + /// 发现列表变了(新增/更新/掉线) + public event Action? DiscoveredChanged; + + /// 是否正在持续发现 + public bool Monitoring => _monitor is not null; + + /// 当前发现到的设备 + public IReadOnlyList DiscoveredDevices + => _monitor?.Devices ?? Array.Empty(); + + /// 打开「扫描」:常驻 UDP(每 3 秒探测、一直收),不是扫一轮停一会儿 + public void StartDiscovery() + { + if (_monitor is not null) return; + + _monitor = new DiscoveryMonitor(); + _monitor.Changed += OnDiscoveredChanged; + _monitor.Start(); + OnDiscoveredChanged(); + } + + /// 关掉「扫描」 + public void StopDiscovery() + { + if (_monitor is null) return; + + _monitor.Changed -= OnDiscoveredChanged; + _monitor.Dispose(); + _monitor = null; + DiscoveredChanged?.Invoke(); + } + + private void OnDiscoveredChanged() + { + // 顺手把已有通道的 IP 刷新一下(DHCP 换地址就能立刻重连到新地址) + ApplyDiscoveredIps(_monitor?.Devices ?? Array.Empty()); + DiscoveredChanged?.Invoke(); + } + + public ScanService(DeviceService device) + { + _device = device; + } + + /// 通道同步状态(给界面看的一句话) + public string ChannelSyncStatus { get; private set; } = string.Empty; + + /// 扫码记录上报状态(空串 = 没有积压、也没报错) + public string UploadStatus => _device.UploadStatus; + + /// 立即把积压的扫码记录推一次 + public void TriggerUpload() => _device.TriggerUpload(); + + /// 通道列表引用(配置页/主界面共用一份,改完调 ) + public List Channels { get; private set; } = new(); + + /// 扫码服务是否已启动 + public bool Running { get; private set; } + + /// 通道状态变化(界面刷新用) + public event Action? Changed; + + /// + /// 收到一条**新**条码(连续扫描时同一个码只报一次)。 + /// + /// 落本地记录、延迟上报、同步通道都在本类内部完成,订阅者只用于"提示/展示"。 + /// ⚠️ **不要用这个事件去查运单**:扫码和运单查询是两条独立链路, + /// 历史上就是在这里自动查了一次,用户看到的是"没点查询,打包查询却一直在自动查"。 + /// 运单查询只允许用户主动发起(输入框回车 / 点查询 / 协议叫醒)。 + /// + public event Action? Barcode; + + /// 读通道配置 + public void Load() + { + Channels = ChannelStore.Load(); + } + + /// 存通道配置 + public void SaveChannels() + { + ChannelStore.Save(Channels); + } + + /// 发现局域网设备(UDP 48899 广播);顺手把已有通道的 IP 刷新成最新 + public async Task> DiscoverAsync(CancellationToken ct = default) + { + var devices = await _scanner.DiscoverAsync(ct).ConfigureAwait(false); + ApplyDiscoveredIps(devices); + return devices; + } + + /// + /// 设备 DHCP 换 IP 后必须重连:通道靠 MAC 绑定,`LastIp` 只是缓存, + /// 不刷新的话会一直重连一个旧地址(Android 侧 `Connection#setIp` 就是干这个的)。 + /// + private void ApplyDiscoveredIps(IReadOnlyList devices) + { + var changed = new List(); + + foreach (var device in devices) + { + if (string.IsNullOrWhiteSpace(device.Ip)) continue; + + var channel = Channels.FirstOrDefault(item => item.Mac.Equals(device.Mac, StringComparison.OrdinalIgnoreCase)); + if (channel is null || channel.LastIp.Equals(device.Ip, StringComparison.Ordinal)) continue; + + AppLog.Write($"[scan] 通道 {channel.Number} 设备 IP 变了:{channel.LastIp} → {device.Ip},重新连接"); + channel.LastIp = device.Ip; + changed.Add(channel); + } + + if (changed.Count == 0) return; + + SaveChannels(); + Changed?.Invoke(); + + foreach (var channel in changed) + { + if (Running && channel.Enabled) StartConnection(channel); + } + } + + /// 给某条通道的扫码枪发一串原始字节(调试用,走设备透传) + public async Task SendCommandAsync(ScanChannel channel, byte[] payload) + { + if (!_connections.TryGetValue(channel.Mac, out var connection)) return false; + return await connection.SendRawAsync(payload).ConfigureAwait(false); + } + + /// + /// 切换某条通道的扫码枪静音(与 AndroidScanCenter 一致): + /// **只存本地 + 让这条连接重新走一遍**,不在现有 socket 上补写指令 —— + /// 连上时会按最新值把「连续扫描 + 间隔 0 + 静音」整条下发。 + /// + public void SetMuted(ScanChannel channel, bool muted) + { + if (channel.Muted == muted) return; + + channel.Muted = muted; + SaveChannels(); + Changed?.Invoke(); + + if (_connections.TryGetValue(channel.Mac, out var connection)) + { + // 设备当前没通也不怕:下次连上时按记住的值下发 + connection.RequestReconnect("扫码枪设置变更,主动重连"); + AppLog.Write($"[scan] 通道 {channel.Number}「{channel.DisplayName}」" + (muted ? "已设为静音" : "已恢复蜂鸣") + ",正在重新下发设置"); + } + else + { + AppLog.Write($"[scan] 通道 {channel.Number}「{channel.DisplayName}」" + (muted ? "已设为静音" : "已恢复蜂鸣") + "(设备未连通,连上后自动生效)"); + } + } + + public Task ReadConfigAsync(string ip, CancellationToken ct = default) + => _scanner.ReadSysConfigAsync(ip, ct); + + public Task WriteConfigAsync(string ip, IReadOnlyDictionary patch, CancellationToken ct = default) + => _scanner.WriteSysConfigAsync(ip, patch, ct); + + /// 确保设备上有一条给中控用的 TCP 服务(没有它这条通道永远收不到码) + public Task EnsureTcpServerAsync(string ip, string? preferredName = null, + CancellationToken ct = default) + => _scanner.EnsureTcpServerAsync(ip, preferredName, ct); + + /// 把设备名写进设备(SYS.HostName + 落 flash) + public Task WriteHostNameAsync(string ip, string name, CancellationToken ct = default) + => _scanner.WriteHostNameAsync(ip, name, ct); + + public Task RestartAsync(string ip, CancellationToken ct = default) + => _scanner.RestartAsync(ip, ct); + + /// + /// 添加通道(按 MAC 去重)。 + /// + /// 顺序与 AndroidScanCenter 一致,且**先配设备、后落本地**: + /// ① 确保设备有 TCP-SERVER 服务(失败就整个失败,本地什么都不写); + /// ② 设备名与设备自报的不一样就写进设备(失败不阻断,只影响设备面板/其他上位机看到的叫法); + /// ③ 才把通道写进本地配置并开始连。 + /// 回滚本地行不通:中间设备名可能已经写上去了,回滚只能回一半。 + /// + /// 指定通道号(<=0 或被占用时退回最小空号) + /// 进度文案回调(界面显示用) + public async Task AddChannelAsync(string mac, string name, string ip, int number, + string? reportedHostName = null, Action? stage = null, CancellationToken ct = default) + { + var key = (mac ?? string.Empty).Trim().ToUpperInvariant(); + var trimmed = (name ?? string.Empty).Trim(); + + // 已存在:只更新名字/IP/通道号,不重配设备 + var existing = Channels.FirstOrDefault(item => item.Mac.Equals(key, StringComparison.OrdinalIgnoreCase)); + if (existing is not null) + { + existing.LastIp = string.IsNullOrWhiteSpace(ip) ? existing.LastIp : ip; + if (trimmed.Length > 0) existing.Name = trimmed; + if (number > 0 && ChannelStore.FindByNumber(Channels, number, existing.Mac) is null) existing.Number = number; + SaveChannels(); + Changed?.Invoke(); + if (Running) StartConnection(existing); + return new AddChannelResult(existing, true, "该设备已在通道列表里,已更新名称/通道号"); + } + + // ① 设备 TCP 服务(失败直接中止) + stage?.Invoke("正在检查设备 TCP 服务…"); + var ensure = await EnsureTcpServerAsync(ip, null, ct).ConfigureAwait(false); + if (!ensure.Ok) return new AddChannelResult(null, false, ensure.Message); + + // ② 设备名(可选,失败不阻断) + var patchNote = string.Empty; + if (trimmed.Length > 0 && !trimmed.Equals((reportedHostName ?? string.Empty).Trim(), StringComparison.Ordinal)) + { + stage?.Invoke($"正在把设备名「{trimmed}」写入设备…"); + var ok = await WriteHostNameAsync(ip, trimmed, ct).ConfigureAwait(false); + if (!ok) patchNote = "(设备名写入失败,不影响收码)"; + } + + // ③ 落本地 + var wanted = number > 0 && ChannelStore.FindByNumber(Channels, number) is null + ? number + : ChannelStore.NextNumber(Channels); + var channel = new ScanChannel + { + Mac = key, + Name = trimmed.Length > 0 ? trimmed : key, + LastIp = ip, + Number = wanted, + TcpPort = ScanProtocol.TcpPort, + SockName = ensure.SockName, + Enabled = true, + }; + Channels.Add(channel); + SaveChannels(); + Changed?.Invoke(); + RequestChannelSync(); + + if (Running) StartConnection(channel); + + var message = $"通道 {channel.Number}「{channel.DisplayName}」已添加{ensure.Message}{patchNote}"; + return new AddChannelResult(channel, true, message, ensure.Kind); + } + + /// 删除通道 + public void RemoveChannel(ScanChannel channel) + { + StopConnection(channel); + Channels.Remove(channel); + SaveChannels(); + Changed?.Invoke(); + RequestChannelSync(); + } + + /// 启用 / 停用通道 + public void SetEnabled(ScanChannel channel, bool enabled) + { + channel.Enabled = enabled; + SaveChannels(); + + if (enabled && Running) StartConnection(channel); + else StopConnection(channel); + + Changed?.Invoke(); + RequestChannelSync(); + } + + /// 启动扫码服务:连接所有启用的通道 + (后台)同步通道列表到服务器 + public Task StartAsync() + { + Load(); + Running = true; + + foreach (var channel in Channels.Where(item => item.Enabled)) StartConnection(channel); + + RequestChannelSync(); + EnsureWatchdog(); + AppLog.Write($"[scan] 扫码服务已启动,通道 {Channels.Count(item => item.Enabled)} 个"); + Changed?.Invoke(); + return Task.CompletedTask; + } + + /// 停止扫码服务(断开所有连接) + public void Stop() + { + Running = false; + foreach (var connection in _connections.Values.ToList()) connection.Stop(); + _connections.Clear(); + + try + { + _syncCts?.Cancel(); + } + catch + { + // 忽略 + } + _syncCts = null; + _syncTask = null; + + try + { + _watchdogCts?.Cancel(); + } + catch + { + // 忽略 + } + _watchdogCts = null; + _watchdogTask = null; + + StopDiscovery(); + + AppLog.Write("[scan] 扫码服务已停止"); + Changed?.Invoke(); + } + + /// + /// 看门狗(每 30 秒):连接看着在线但**很久没收到字节**时,回查设备侧还认不认这条连接。 + /// + /// 设备断电重启时 TCP 层不会发 FIN/RST,中控这侧阻塞的 `ReadAsync` 会永久挂住, + /// 既不报断开也不重连 —— 只有回查设备侧 `SOCK.ClientIP`(CID 10001)才能发现。 + /// + private void EnsureWatchdog() + { + if (_watchdogTask is { IsCompleted: false }) return; + + _watchdogCts = new CancellationTokenSource(); + _watchdogTask = Task.Run(() => WatchdogLoopAsync(_watchdogCts.Token)); + } + + private async Task WatchdogLoopAsync(CancellationToken ct) + { + while (!ct.IsCancellationRequested) + { + try + { + await Task.Delay(TimeSpan.FromSeconds(15), ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + + foreach (var connection in _connections.Values.ToList()) + { + var channel = connection.Channel; + if (!channel.Connected) continue; + + // 设备平时一直在推帧(~0.7s 一帧),20 秒一个字节都没有就可疑了 + if ((DateTime.Now - connection.LastRxAt).TotalSeconds < 20) continue; + + try + { + var states = await _scanner.ReadSockStatesAsync(channel.LastIp, ct).ConfigureAwait(false); + + // ⚠️ 读不到(UDP 完全没应答)= 设备已断电/断网/离线。 + // 以前这里「读不到就不断言」,结果设备真离线了界面还一直是「在线」 + // (设备断电时 TCP 不发 FIN,本地 socket 一直挂着)。 + if (states is null) + { + AppLog.Write($"[scan] 通道 {channel.Number}({channel.DisplayName})设备无应答" + + $"({channel.LastIp} 已 {Math.Round((DateTime.Now - connection.LastRxAt).TotalSeconds)}s 没数据),判为离线并重连"); + connection.RequestReconnect("设备无应答(疑似断电/离线)"); + continue; + } + + var name = string.IsNullOrWhiteSpace(channel.SockName) ? ScanProtocol.SockName : channel.SockName; + var mine = states.FirstOrDefault(item => + item.Name.Equals(name, StringComparison.OrdinalIgnoreCase)); + + // 设备能应答、但我们那条条目不见了:说明设备重载/配置被改,重连让它自愈 + if (mine is null) + { + AppLog.Write($"[scan] 通道 {channel.Number} 设备上已没有「{name}」条目,强制重连(会自愈)"); + connection.RequestReconnect($"设备上已没有「{name}」条目"); + continue; + } + + if (mine.Clients.Any(ip => ip.Equals(connection.LocalIp, StringComparison.Ordinal))) continue; + + AppLog.Write($"[scan] 通道 {channel.Number} 设备侧已不认这条连接" + + $"(ClientIP=[{mine.ClientIp}],本机 {connection.LocalIp}),强制重连"); + connection.RequestReconnect($"设备侧已不认这条连接(ClientIP=[{mine.ClientIp}])"); + } + catch (OperationCanceledException) + { + break; + } + catch (Exception ex) + { + AppLog.Write($"[scan] 通道 {channel.Number} 假死检查失败(忽略):{ex.Message}"); + } + } + } + } + + /// + /// 把通道列表同步到服务器(`POST /api/scan/channels` 之后再用 `GET` **回查确认**)。 + /// + /// 不用手动点:添加 / 删除 / 启用停用 都会调 , + /// 后台循环一直重试到服务器确实有这批通道为止(断网、服务器重启都不用手管)。 + /// + public void RequestChannelSync() + { + EnsureSyncLoop(); + try + { + if (_syncSignal.CurrentCount == 0) _syncSignal.Release(); + } + catch + { + // 忽略 + } + } + + private void EnsureSyncLoop() + { + if (_syncTask is { IsCompleted: false }) return; + + _syncCts = new CancellationTokenSource(); + _syncTask = Task.Run(() => SyncLoopAsync(_syncCts.Token)); + } + + private async Task SyncLoopAsync(CancellationToken ct) + { + while (!ct.IsCancellationRequested) + { + try + { + // 只等信号:**不靠超时**。以前写成 WaitAsync(30s) + 无条件推送, + // 结果每 30 秒就往服务器重推一次通道、刷一条日志(看起来像“一直在重连”)。 + await _syncSignal.WaitAsync(ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + break; + } + + await PushChannelsUntilConfirmedAsync(ct).ConfigureAwait(false); + } + } + + /// 推一次 + 回查确认;不成功就退避重试,直到服务器真的有这批通道 + private async Task PushChannelsUntilConfirmedAsync(CancellationToken ct) + { + while (!ct.IsCancellationRequested) + { + if (!_device.Enabled) + { + SetSyncStatus("设备服务未开启,通道等开启后再同步"); + return; + } + + var local = Channels.Where(item => item.Enabled) + .Select(item => (item.ChannelId, item.DisplayName)) + .ToList(); + + if (local.Count == 0) + { + SetSyncStatus("当前没有启用的通道"); + return; + } + + try + { + await _device.ReportChannelsAsync(local, ct).ConfigureAwait(false); + + // 服务器回查:确保它真的收到了(POST 成功≠入库成功,例如主体变更/令牌失效) + var remote = await _device.ChannelsAsync(ct).ConfigureAwait(false); + var missing = local.Where(item => !remote.Contains(item.ChannelId)).Select(item => item.ChannelId).ToList(); + + if (missing.Count == 0) + { + _syncRetryMs = 1000; + SetSyncStatus($"通道已同步({local.Count} 个)"); + AppLog.Write($"[scan] 通道已同步到服务器并确认:{local.Count} 个"); + return; + } + + throw new InvalidOperationException($"服务器上还缺通道 {string.Join('/', missing)}"); + } + catch (OperationCanceledException) + { + return; + } + catch (Exception ex) + { + SetSyncStatus($"通道同步失败,{_syncRetryMs / 1000} 秒后重试"); + AppLog.Write($"[scan] 通道同步失败({_syncRetryMs}ms 后重试):{ex.Message}"); + try + { + await Task.Delay(_syncRetryMs, ct).ConfigureAwait(false); + } + catch (OperationCanceledException) + { + return; + } + _syncRetryMs = Math.Min(_syncRetryMs * 2, 30000); + } + } + } + + private void SetSyncStatus(string status) + { + if (ChannelSyncStatus == status) return; + ChannelSyncStatus = status; + Changed?.Invoke(); + } + + private void StartConnection(ScanChannel channel) + { + StopConnection(channel); + if (string.IsNullOrWhiteSpace(channel.LastIp)) return; + + var connection = new ChannelConnection(channel); + connection.Barcode += OnBarcode; + connection.StateChanged += (_, _) => Changed?.Invoke(); + connection.HealNeeded += healChannel => _ = HealAsync(healChannel); + _connections[channel.Mac] = connection; + connection.Start(); + } + + /// + /// 自愈:连不上时回查设备上我们那条 TCP 服务(`packcenter / TCP-SERVER / 8087`)还在不在, + /// 被删了/被改了就重建(照搬 AndroidScanCenter 的 healIfNeeded)。 + /// + /// 只在「连不上」时查(连得上就不动设备配置),每台设备 60 秒最多查一次。 + /// + private async Task HealAsync(ScanChannel channel) + { + if (!Running || !_device.Enabled) return; + if (string.IsNullOrWhiteSpace(channel.LastIp)) return; + + var now = DateTime.Now; + if (_lastHealAt.TryGetValue(channel.Mac, out var last) && (now - last).TotalSeconds < 60) return; + _lastHealAt[channel.Mac] = now; + + // 离线设备每 60 秒会自愈一次;日志只在第一次 / 每 10 分钟记一遍 + var shouldLog = !_healLogAt.TryGetValue(channel.Mac, out var lastLog) + || (now - lastLog).TotalMinutes >= 10; + if (shouldLog) _healLogAt[channel.Mac] = now; + + try + { + if (shouldLog) + { + AppLog.Write($"[scan] 通道 {channel.Number} 连不上({channel.LastIp}),回查设备的 TCP 服务…"); + } + + var result = await _scanner.EnsureTcpServerAsync(channel.LastIp, channel.SockName).ConfigureAwait(false); + + if (shouldLog || result.Ok) + { + AppLog.Write($"[scan] 通道 {channel.Number} 自愈:{result.Message}"); + } + + if (result.Ok) + { + if (!string.IsNullOrWhiteSpace(result.SockName) && result.SockName != channel.SockName) + { + channel.SockName = result.SockName; + SaveChannels(); + } + + if (_connections.TryGetValue(channel.Mac, out var connection)) + { + connection.RequestReconnect("设备 TCP 服务已就绪,立即重连"); + } + } + } + catch (OperationCanceledException) + { + // 忽略 + } + catch (Exception ex) + { + if (shouldLog) + { + AppLog.Write($"[scan] 通道 {channel.Number} 自愈失败(稍后再试):{ex.Message}"); + } + } + } + + private void StopConnection(ScanChannel channel) + { + if (!_connections.TryGetValue(channel.Mac, out var existing)) return; + + try + { + existing.Stop(); + existing.Dispose(); + } + catch + { + // 忽略 + } + _connections.Remove(channel.Mac); + channel.Connected = false; + } + + /// + /// 收到条码。 + /// + /// ⚠️ 连续扫描模式下同一个码每 ~80ms 报一次: + /// - 记录库只把「最近扫描时间」刷到最新,不新增记录; + /// - 这里只在**新扫码事件**(换了条码 / 已上报过的码又扫到)时通知界面, + /// 否则订阅者会被连续扫描刷屏。订阅者**只能做展示**,不能据此发起运单查询。 + /// 真正的上报在扫到后 5 分钟没再扫到同一个码时才做(时间取最后一次扫描)。 + /// + private void OnBarcode(ScanChannel channel, string code) + { + var added = _device.ReportOnChannel(channel.ChannelId, channel.DisplayName, code); + + if (added) Barcode?.Invoke(channel, code); + Changed?.Invoke(); + } +} + +/// 添加通道的结果( 为空表示失败, 是给用户看的一句话) +public sealed record AddChannelResult( + ScanChannel? Channel, + bool Ok, + string Message, + TcpServerEnsureKind EnsureKind = TcpServerEnsureKind.AlreadyReady); diff --git a/desktop/Services/Scan/ScannerCommands.cs b/desktop/Services/Scan/ScannerCommands.cs new file mode 100644 index 0000000..8edefac --- /dev/null +++ b/desktop/Services/Scan/ScannerCommands.cs @@ -0,0 +1,51 @@ +using System; +using System.Collections.Generic; + +namespace YuncangTrace.LocalService.Services.Scan; + +/// +/// 扫码枪的设置指令(照搬 AndroidScanCenter 的 ScannerCommands,来源:设备商 +/// 《网口配置-文档介绍-V4.0》第 14 页「串口指令表」)。 +/// +/// ⚠️ 这些指令发给的是**扫码枪**,不是网口设备:我们通过已有的 TCP 连接写进去, +/// 设备按 `Rout=uart` 透传到串口。 +/// +/// ⚠️ 静音那两条是 **10 字节**(其余 9 字节),**不要**按 9 字节去"凑"长度, +/// 校验位也照抄,改错了设备会静默丢弃(现象是"发了没反应")。 +/// +public static class ScannerCommands +{ + /// 触发模式 → 连续扫描:扫码枪自己一直扫,不用主机触发 + public static readonly byte[] TriggerContinuous = + { 0x07, 0xC6, 0x04, 0x08, 0x00, 0x8A, 0x04, 0xFE, 0x99 }; + + /// 识读间隔 → 0s:连扫时两条之间不等待 + public static readonly byte[] IntervalZero = + { 0x07, 0xC6, 0x04, 0x08, 0x00, 0x89, 0x00, 0xFE, 0x9E }; + + /// + /// 静音 → 使能:扫到码不蜂鸣。 + /// 参数是「静音」,0x01 = 使能(安静)、0x00 = 禁止(照旧响)—— 是**反的**。 + /// + public static readonly byte[] MuteOn = + { 0x08, 0xC6, 0x04, 0x08, 0x00, 0xF2, 0x0C, 0x01, 0xFE, 0x27 }; + + /// 静音 → 禁止:恢复蜂鸣 + public static readonly byte[] MuteOff = + { 0x08, 0xC6, 0x04, 0x08, 0x00, 0xF2, 0x0C, 0x00, 0xFE, 0x28 }; + + /// + /// 连上之后按顺序下发的设置(9 + 9 + 10 = 28 字节,一次写完)。 + /// + /// 为什么放在"连上时"而不是做成一个按钮:这些是**扫码枪**的状态, + /// 枪自己断电重启就丢了;而连接每重建一次都会走这里,等于自动兜住。 + /// 静音取**通道记住的值**(不是固定值),否则每次重连都会把人的设置覆盖掉 + /// —— 现场看到的现象就是"设了过一会儿自己又响了"。 + /// + public static IReadOnlyList StartupSequence(bool muted) => new[] + { + TriggerContinuous, + IntervalZero, + muted ? MuteOn : MuteOff, + }; +} diff --git a/desktop/Views/AddChannelWindow.xaml b/desktop/Views/AddChannelWindow.xaml new file mode 100644 index 0000000..0bd0e13 --- /dev/null +++ b/desktop/Views/AddChannelWindow.xaml @@ -0,0 +1,42 @@ + + + + + + + +