docs(desktop): 说明多摄像头工作台的 OSD 是依次写入

同一台录像机的配置是整包读-改-写,不能并发,所以第二路通常比第一路晚 1~3 秒上屏。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-01 06:30:42 +08:00
parent c7cf7127d4
commit 9e57925dd7

View File

@ -925,7 +925,9 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧(
- 写的是**录像机通道名**(`NET_DVR_SET_PICCFG_V30` 读-改-写整包 + 回读校验),
所以实时流、回放、下载的录像里都带这段字;摄像头本身不改;
- 字段只有 **31 字节(GBK)**:超长时先压摄像头名、保住完整运单号(见 `OsdText`);
- 每次写设备配置要 1~3 秒,写入在**单线程队列**里串行执行(不阻塞扫码/识别),
- 每次写设备配置要 1~3 秒,写入在**单线程队列**里串行执行(不阻塞扫码/识别);
一个工作台绑了多路摄像头时是**依次**写入的,第二路通常比第一路晚 1~3 秒上屏
(同一台录像机的配置是「读整包 → 改 → 写回」,并发会读到写了一半的结构体);
失败按 5s→10s→20s→40s→60s 退避;配置里被移除的摄像机会先还原一次工作台名再忘掉;
- 状态在 `agent-status.json` 的 `Osd`(每路摄像头的当前文本 / 最近写入时间 / 错误,**不含密码**)。