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:
parent
b8629dd0dc
commit
1dc3404eae
@ -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 字幕」)
|
||||
- [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址
|
||||
|
||||
|
||||
@ -115,7 +115,7 @@ class ScanController extends Controller {
|
||||
*
|
||||
* 只返回绑定了本机扫码通道的工作台,每项带 `channels`(本机通道)与 `cameras`
|
||||
* (摄像头名 / 录像机通道号 / 录像机凭据)。设备端据此把「摄像头名 + 运单号」
|
||||
* 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成工作台名称。
|
||||
* 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成摄像头自己的名字。
|
||||
*/
|
||||
async workstations() {
|
||||
const { ctx } = this;
|
||||
|
||||
@ -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`。
|
||||
|
||||
### 摄像头识别结果 → 记录 + 安卓播报通知
|
||||
|
||||
|
||||
@ -8,7 +8,7 @@ namespace YuncangTrace.LocalService.Services.Scan;
|
||||
/// OSD 文本拼装(录像机通道名,GBK,最多 <see cref="MaxBytes"/> 字节)。
|
||||
///
|
||||
/// 现场要求:扫到运单号后,把「摄像头名 + 空格 + 运单号」写到该工作台所有摄像头的 OSD;
|
||||
/// 没扫码时还原成工作台名称。设备只认 GBK 且字段只有 31 字节——
|
||||
/// 没扫码时还原成**摄像头自己的名字**。设备只认 GBK 且字段只有 31 字节——
|
||||
/// **运单号必须完整**(它才是取证要看的),所以超长时先压摄像头名,压完还超才截运单号。
|
||||
/// </summary>
|
||||
internal static class OsdText
|
||||
|
||||
@ -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);
|
||||
// 扫码枪那条路也要按「通道 → 工作台类型」决定记录规则(散单取第一次、团购取最后一次)
|
||||
|
||||
@ -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;
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user