From 1dc3404eae76a431f1861a65edce7b351e36cd0c Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sun, 1 Nov 2026 06:55:07 +0800 Subject: [PATCH] =?UTF-8?q?fix(osd):=20=E7=A9=BA=E9=97=B2=E5=9B=9E?= =?UTF-8?q?=E9=80=80=E5=86=99=E5=9B=9E=E6=91=84=E5=83=8F=E5=A4=B4=E5=90=8D?= =?UTF-8?q?=EF=BC=8C=E4=B8=8D=E5=86=8D=E5=86=99=E5=B7=A5=E4=BD=9C=E5=8F=B0?= =?UTF-8?q?=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - DesiredText:60 秒没扫到时还原成**摄像头自己的名字**(摄像头没名字才退回工作台名, 避免把通道名写空) - 配置里被移除的摄像头同样还原成摄像头名 - 同步注释与文档(桌面 README / 根 README / 后端接口注释) - 实测(真实 NVR 通道 35/37):首次="测试A/测试B"、扫码="测试A 7734… / 测试B 7734…"、 70 秒后回退="测试A/测试B",三个阶段的并行时间差 50~103ms Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- README.md | 2 +- backend/app/controller/device/scan.js | 2 +- desktop/README.md | 6 ++-- desktop/Services/Scan/OsdText.cs | 2 +- desktop/Services/Scan/ScanService.cs | 2 +- .../Services/Scan/WorkstationOsdService.cs | 30 +++++++++++++------ 6 files changed, 28 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index bed3dda..ff34a1e 100644 --- a/README.md +++ b/README.md @@ -81,7 +81,7 @@ packService/ - [x] **顶栏下载入口(2026-10-29)**:所有页面右上角都有「桌面端 / Android 扫码台」下载按钮(**不看权限**), 版本号读 `/download/version.json` 与 `/download/android_client/version.json`,没发布过安装包时按钮置灰 - [x] **工作台 OSD 字幕(2026-11-01)**:设备服务按工作台把「摄像头名 + 运单号」写进每路摄像头的 OSD - (= 录像机通道名,录像/回放都带);运单号没变不重写,连续 60 秒没扫到还原成工作台名; + (= 录像机通道名,录像/回放都带);运单号没变不重写,连续 60 秒没扫到还原成摄像头名; 配置由 GET /api/scanner/workstations 下发(详见 [desktop/README.md](desktop/README.md) 的「工作台 OSD 字幕」) - [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址 diff --git a/backend/app/controller/device/scan.js b/backend/app/controller/device/scan.js index 3b025d6..b2ed1eb 100644 --- a/backend/app/controller/device/scan.js +++ b/backend/app/controller/device/scan.js @@ -115,7 +115,7 @@ class ScanController extends Controller { * * 只返回绑定了本机扫码通道的工作台,每项带 `channels`(本机通道)与 `cameras` * (摄像头名 / 录像机通道号 / 录像机凭据)。设备端据此把「摄像头名 + 运单号」 - * 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成工作台名称。 + * 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成摄像头自己的名字。 */ async workstations() { const { ctx } = this; diff --git a/desktop/README.md b/desktop/README.md index 1f280c8..ecfb8df 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -917,7 +917,7 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧( | --- | --- | | 扫到运单号(扫码枪 / 面单识别,连续重复命中都算「在扫」) | 该工作台**所有摄像头**:`摄像头名 + 空格 + 运单号`(如 `2号线面单 SF1164748936737`) | | **运单号没变** | **不重写**(连续扫描只续在场计时) | -| 连续 **60 秒**没有任何命中 | 全部还原成**工作台名称** | +| 连续 **60 秒**没有任何命中 | 全部还原成**摄像头自己的名字**(摄像头没名字才退回工作台名) | - 配置来源:`GET /api/scanner/workstations`(设备令牌)——只下发**绑了本机扫码通道**的工作台, 每项带本机通道、全部绑定摄像头(名称 / 录像机通道号 / 录像机凭据); @@ -930,11 +930,11 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧( 录像机只是把配置分别转给各摄像头,实测两路并发读改写 20 次全部成功、其余字段零差异), 但**同一通道**必须串行(「读整包 → 改 → 写回」会互相覆盖,批内已按通道去重); 写完一批还有待写的会立刻接着来,不会空等;失败按 5s→10s→20s→40s→60s 退避; - 配置里被移除的摄像机会先还原一次工作台名再忘掉; + 配置里被移除的摄像机会先还原一次摄像头名再忘掉; - 状态在 `agent-status.json` 的 `Osd`(每路摄像头的当前文本 / 最近写入时间 / 错误,**不含密码**)。 > ⚠️ 改通道名 = 改录像机上的通道名:NVR 本机界面、其他客户端、以及我们「拉取通道」读到的名字都会变。 -> 服务停止时**不主动清 OSD**(下次启动会按配置还原成工作台名);要动态的长文本字幕只能本地 `ffmpeg drawtext`。 +> 服务停止时**不主动清 OSD**(下次启动会按配置还原成摄像头名);要动态的长文本字幕只能本地 `ffmpeg drawtext`。 ### 摄像头识别结果 → 记录 + 安卓播报通知 diff --git a/desktop/Services/Scan/OsdText.cs b/desktop/Services/Scan/OsdText.cs index 441df5d..3b8ecbb 100644 --- a/desktop/Services/Scan/OsdText.cs +++ b/desktop/Services/Scan/OsdText.cs @@ -8,7 +8,7 @@ namespace YuncangTrace.LocalService.Services.Scan; /// OSD 文本拼装(录像机通道名,GBK,最多 字节)。 /// /// 现场要求:扫到运单号后,把「摄像头名 + 空格 + 运单号」写到该工作台所有摄像头的 OSD; -/// 没扫码时还原成工作台名称。设备只认 GBK 且字段只有 31 字节—— +/// 没扫码时还原成**摄像头自己的名字**。设备只认 GBK 且字段只有 31 字节—— /// **运单号必须完整**(它才是取证要看的),所以超长时先压摄像头名,压完还超才截运单号。 /// internal static class OsdText diff --git a/desktop/Services/Scan/ScanService.cs b/desktop/Services/Scan/ScanService.cs index 437589d..1441756 100644 --- a/desktop/Services/Scan/ScanService.cs +++ b/desktop/Services/Scan/ScanService.cs @@ -87,7 +87,7 @@ public sealed class ScanService _device = device; LabelScan = new LabelScanMonitor(device, (channelId, code, wsType, afterAbsence) => ReportCameraScanAsync(channelId, ChannelNameOf(channelId), code, wsType, afterAbsence)); - // 工作台 OSD 字幕:扫码/识别命中 → 写「摄像头名 + 运单号」,1 分钟没扫 → 还原工作台名 + // 工作台 OSD 字幕:扫码/识别命中 → 写「摄像头名 + 运单号」,1 分钟没扫 → 还原摄像头名 Osd = new WorkstationOsdService(device); ScanActivity += (channelId, code, at) => Osd.OnScanActivity(channelId, code, at); // 扫码枪那条路也要按「通道 → 工作台类型」决定记录规则(散单取第一次、团购取最后一次) diff --git a/desktop/Services/Scan/WorkstationOsdService.cs b/desktop/Services/Scan/WorkstationOsdService.cs index 7425026..6bccc30 100644 --- a/desktop/Services/Scan/WorkstationOsdService.cs +++ b/desktop/Services/Scan/WorkstationOsdService.cs @@ -66,19 +66,19 @@ public sealed class OsdSnapshot /// 规则(现场约定): /// 1. 扫到运单号(扫码枪或面单识别,连续重复命中都算)→ 该工作台所有摄像头 OSD = `摄像头名 + 空格 + 运单号`; /// 2. **运单号没变就不重写**(每次写设备配置要 1~3 秒,还会刷配置区);连续命中只续「在场」计时; -/// 3. 连续 **60 秒**没有任何命中 → 全部还原成**工作台名称**; +/// 3. 连续 **60 秒**没有任何命中 → 全部还原成**摄像头自己的名字**(不是工作台名); /// 4. 配置(工作台/摄像头/通道)由服务端下发,启动拉一次 + 每 1 分钟兜底 + 收到通知立即拉。 /// /// 实现要点: /// - 设备写入走**后台批量队列**(不堵扫码线程):不同通道**并行**下发(一批最多 4 路), /// 同一通道保证串行(同一通道的「读整包 → 改 → 写回」会互相覆盖); /// - 每次写之前重新算目标文本,避免把过期的运单号写上去; -/// - 写失败按 5s→10s→…→60s 退避,不刷日志;配置里移除的摄像头会**还原一次**工作台名再忘掉; +/// - 写失败按 5s→10s→…→60s 退避,不刷日志;配置里移除的摄像头会**还原一次**摄像头名再忘掉; /// - 文本超过 31 字节(GBK)时优先保运单号,压摄像头名(见 )。 /// public sealed class WorkstationOsdService : IDisposable { - /// 多久没命中就还原成工作台名称(现场约定 1 分钟) + /// 多久没命中就还原成摄像头名(现场约定 1 分钟) private static readonly TimeSpan IdleReset = TimeSpan.FromMinutes(1); /// 配置兜底拉取间隔(变更靠服务端通知立即生效) @@ -143,7 +143,7 @@ public sealed class WorkstationOsdService : IDisposable } } - /// 停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成工作台名) + /// 停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成摄像头名) public void Stop() { CancellationTokenSource? cts; @@ -438,7 +438,7 @@ public sealed class WorkstationOsdService : IDisposable return TimeSpan.FromSeconds(Math.Min(seconds, 60)); } - /// 当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则是工作台名称 + /// 当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则还原成**摄像头名** private static string DesiredText(WorkstationState workstation, CameraState camera, DateTime now) { var active = workstation.LastActivityAt is DateTime at @@ -447,7 +447,17 @@ public sealed class WorkstationOsdService : IDisposable return active ? OsdText.Combine(camera.Camera.Name, workstation.LastCode) - : workstation.WorkstationName; + : IdleText(camera.Camera.Name, workstation.WorkstationName); + } + + /// + /// 空闲/退役时要写回去的文本:**摄像头自己的名字**(现场约定)。 + /// 摄像头没有名字时才退回工作台名——写空会把通道名清掉,反而更容易看错。 + /// + private static string IdleText(string? cameraName, string? fallback) + { + var name = OsdText.Combine(cameraName, null); + return name.Length > 0 ? name : OsdText.TruncateGbk(fallback, OsdText.MaxBytes); } private void Apply(ParsedConfig parsed, string reason) @@ -489,16 +499,18 @@ public sealed class WorkstationOsdService : IDisposable } } - // 被移除的摄像头:还原成它原来所属工作台的名称(best-effort),然后忘掉 + // 被移除的摄像头:还原成它自己的名字(best-effort),然后忘掉 foreach (var pair in _cameras) { if (nextCameras.ContainsKey(pair.Key)) continue; var state = pair.Value; if (string.IsNullOrEmpty(state.LastText)) continue; - if (string.Equals(state.LastText, state.WorkstationName, StringComparison.Ordinal)) continue; - _retired.Enqueue(new RetiredWrite(state.Camera, state.WorkstationName)); + var idle = IdleText(state.Camera.Name, state.WorkstationName); + if (string.Equals(state.LastText, idle, StringComparison.Ordinal)) continue; + + _retired.Enqueue(new RetiredWrite(state.Camera, idle)); } _workstations = nextWorkstations;