这里汇总音视频使用过程中的常见问题与排查方法。排查顺序建议遵循「先设备、再网络、后平台」：先确认设备配置与状态，再检查网络连通，最后确认平台侧参数。

设备注册不上线

现象：在设备列表看不到设备，或设备一直处于离线状态。

排查步骤：

1. 核对 SIP 参数五项一致：设备侧配置的服务器 ID、域、IP、端口、注册密码需与平台分配的参数完全一致，任一不一致都会导致注册失败；
2. 确认 5060 端口与网络可达：设备能访问平台 SIP 服务的 5060 端口（UDP），平台侧防火墙、安全组需放行 5060，跨公网接入时尤其注意；
3. 确认注册密码正确：密码错误时设备会注册失败或被拒绝，重新核对后重试；
4. 检查设备传输协议（UDP/TCP）与平台支持方式是否一致。

能注册但通道为 0

现象：设备已在线，但设备列表或通道列表显示通道数量为 0。

排查步骤：

1. 执行目录同步 / 通道刷新，重新拉取设备通道；
2. 检查设备侧是否开启了「目录推送 / 主动上报」，多数厂家需开启后设备才会把通道目录上报到平台；
3. 检查目录订阅是否开启：关闭目录订阅时，设备不会主动上报通道变化，只能依赖手动刷新；
4. 核对设备通道编号是否已配置，部分 NVR 需为通道配置编号后才会随目录上报。

实时预览点播失败或超时

现象：点击播放后长时间无画面、提示超时或播放失败。

排查步骤：

1. 确认设备在线：离线设备无法点播，先看设备状态；
2. 核对收流地址（公网 / 内网 IP）：平台通知设备向某个 IP 发流，若配置的收流地址与设备实际可达网络不匹配（如公网部署却配了内网 IP），设备发流无法到达平台，导致收流超时；
3. 放行媒体端口：GB28181 信令走 5060，但媒体 RTP 流走随机高端 UDP 端口，只放行 5060 不够，需要在 NAT / 防火墙放行媒体端口，或限定并放行一个媒体端口区间；
4. 确认网络链路稳定，设备发流与平台收流之间无丢包或拥塞；
5. 仍失败时，可尝试切换设备主码流编码（如 H.265 切 H.264）后重试，排除编码兼容性问题。

录像查询返回空

现象：设备端录像按时间段查询后没有任何录像片段。

排查步骤：

1. 核对平台与设备时间 / 时区同步：国标信令使用 UTC 时间，平台与设备时区或时间不一致时，设备按错误时间检索，结果会为空或错位；请将设备时间、时区与平台对齐并统一校时；
2. 确认检索的通道与时间段范围内设备确实有录像；
3. 确认设备在线且支持国标录像检索能力；
4. 云录像为空时，检查该通道是否已开启录像计划，以及录像模式关联是否正确。

回放黑屏或无法播放

现象：录像回放时画面黑屏、花屏或无法起播。

排查步骤：

1. 优先切换编码验证：部分流媒体对 H.265 PS 流兼容性较差，建议先将设备主码流编码切换为 H.264 再验证，可排除大部分编码兼容问题；
2. 确认设备在线，设备端回放直接与设备交互，离线无法回放；
3. 检查回放时间段与录像是否真实存在（参考「录像查询返回空」）；
4. 云录像回放异常时，确认录像文件完整，必要时重新下载该片段验证。

拉流 / 推流失败

现象：拉流代理无法拉取视频流，或推流端推送后平台看不到流。

排查步骤：

1. 先验证源流地址可用：用 VLC 等通用播放器直接播放源地址，确认地址格式、用户名密码正确且网络可达，源地址不可用时一切配置都无从谈起；
2. 拉流失败时，检查平台到源地址的网络连通性（含防火墙、端口）；
3. 推流失败时，确认推流地址完整复制（含鉴权信息），鉴权信息过期或缺失会被拒绝；
4. 确认推流端已开始推送，且推流网络与平台可达。

更新日志

2026/8/4 07:04

查看所有更新日志

• 7e927-文档站全面重构：目录重排、首页重写、案例独立成站、应用市场下线于 2026/8/4
• 117c7-Merge #14 into master from docs/use-av-card-modules于 2026/8/1
• 4342f-音视频使用文档对标 wvp-pro 细化扩写于 2026/8/1

贡献者: godLei6, 杨磊

上一页告警事件

下一页物联卡