From caa6704ed8aecb77e829504c2a739e30f5404aa9 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Thu, 13 Aug 2026 12:37:32 +0800 Subject: [PATCH] docs: document automatic liveview routing (#51) --- Troubleshooting.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Troubleshooting.md b/Troubleshooting.md index a3a2718..d87a686 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -44,9 +44,10 @@ | `discovery_unavailable` | 未设置获准的 `SENSE_ONVIF_DISCOVERY_IP`，或该 IP 不属于本机网卡。可改用手工 ONVIF 地址。 | | `authentication_failed` | 在设备管理中分别检查 ONVIF 与 RTSP 凭据，只有设备确实共用账号时才勾选“RTSP 与 ONVIF 使用相同账号”；不要把凭据写进地址。Sense 支持 ONVIF Basic 与 Digest，并会安全归一化摄像机广播的跨主机 Media/RTSP 地址。 | | `clock_skew` | 校准摄像机时间后重新探测。 | -| `process_failed` | 检查仓库外 `SENSE_MEDIAMTX_BINARY`、基础配置和进程退出原因；达到三次重启上限后需人工处理。 | +| 接入成功但提示“媒体服务未就绪” / `process_failed` | 接入资料和 Profile 已保存，实时监看路径也已建立；检查仓库外 `SENSE_MEDIAMTX_BINARY`、基础配置和进程退出原因，修复后到视频服务重新对账。达到三次重启上限后需人工处理。 | | `apply_failed` / `unconverged` | 检查 localhost Control API 是否启用并为 v3；确认媒体路径和外部进程状态。 | -| 画面等待、断开或会话过期 | 先在视频服务执行对账，再重新连接；播放会话最长两分钟。 | +| 实时监看没有设备 | 先在视频接入完成一次检查；系统会自动建立媒体路径。若已接入仍为空，检查接入结果的媒体状态和视频服务对账。 | +| 画面等待、断开或会话过期 | 查看实时监看中的业务设备名和码流状态，必要时到视频服务执行对账后重新连接；播放会话最长两分钟。 | | 区域提示需要重新校准 | Profile 分辨率已变化，按新画面重新绘制并发布新版本，不能静默复用旧坐标。 | 自动测试不访问真实摄像头或未授权网络。PostgreSQL、MediaMTX、目标浏览器与实验室摄像机的联合验证必须在获准部署环境完成。 @@ -64,3 +65,4 @@ `demo` 只用于临时查看。生产数据持久性、真实设备和媒体链路不能用 demo 验证替代。 +