fix(osd): 空闲回退写回摄像头名,不再写工作台名

- 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>
This commit is contained in:
liufumingren 2026-11-01 06:55:07 +08:00
parent b8629dd0dc
commit 1dc3404eae
6 changed files with 28 additions and 16 deletions

View File

@ -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 字幕」)
- [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址

View File

@ -115,7 +115,7 @@ class ScanController extends Controller {
*
* 只返回绑定了本机扫码通道的工作台,每项带 `channels`(本机通道)与 `cameras`
* (摄像头名 / 录像机通道号 / 录像机凭据)。设备端据此把「摄像头名 + 运单号」
* 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成工作台名称。
* 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成摄像头自己的名字。
*/
async workstations() {
const { ctx } = this;

View File

@ -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`。
### 摄像头识别结果 → 记录 + 安卓播报通知

View File

@ -8,7 +8,7 @@ namespace YuncangTrace.LocalService.Services.Scan;
/// OSD 文本拼装(录像机通道名,GBK,最多 <see cref="MaxBytes"/> 字节)。
///
/// 现场要求:扫到运单号后,把「摄像头名 + 空格 + 运单号」写到该工作台所有摄像头的 OSD;
/// 没扫码时还原成工作台名称。设备只认 GBK 且字段只有 31 字节——
/// 没扫码时还原成**摄像头自己的名字**。设备只认 GBK 且字段只有 31 字节——
/// **运单号必须完整**(它才是取证要看的),所以超长时先压摄像头名,压完还超才截运单号。
/// </summary>
internal static class OsdText

View File

@ -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);
// 扫码枪那条路也要按「通道 → 工作台类型」决定记录规则(散单取第一次、团购取最后一次)

View File

@ -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)时优先保运单号,压摄像头名(见 <see cref="OsdText"/>)。
/// </summary>
public sealed class WorkstationOsdService : IDisposable
{
/// <summary>多久没命中就还原成工作台名称(现场约定 1 分钟)</summary>
/// <summary>多久没命中就还原成摄像头名(现场约定 1 分钟)</summary>
private static readonly TimeSpan IdleReset = TimeSpan.FromMinutes(1);
/// <summary>配置兜底拉取间隔(变更靠服务端通知立即生效)</summary>
@ -143,7 +143,7 @@ public sealed class WorkstationOsdService : IDisposable
}
}
/// <summary>停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成工作台名)</summary>
/// <summary>停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成摄像头名)</summary>
public void Stop()
{
CancellationTokenSource? cts;
@ -438,7 +438,7 @@ public sealed class WorkstationOsdService : IDisposable
return TimeSpan.FromSeconds(Math.Min(seconds, 60));
}
/// <summary>当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则是工作台名称</summary>
/// <summary>当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则还原成**摄像头名**</summary>
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);
}
/// <summary>
/// 空闲/退役时要写回去的文本:**摄像头自己的名字**(现场约定)。
/// 摄像头没有名字时才退回工作台名——写空会把通道名清掉,反而更容易看错。
/// </summary>
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;