排障：预览失败、卡顿与高延迟
排障：预览失败、卡顿与高延迟
按症状对照；更多上下文见 实时预览 与各端 SDK 文档。
预览失败
轻应用播放错误（轻应用组件）：
1001：解密失败 — 检查播放器code/ 设备密钥，见 码流与告警图片解密。1002：设备响应异常 — 确认设备在线、通道正确、流地址未过期（用时再取流，勿提前缓存）。
同页常见问题：
- 直播/录像播放建立 websocket 返回 404：可能存在流源超时无效。实时录像、对讲、直播、录像下载的流地址，要避免提前请求，需要使用时再触发接口获取，避免流源超时无效，避免同时请求不同流源导致流源混乱。
- 接入时报
Uncaught SyntaxError: Unexpected token '<'、WasmLib 加载失败：说明 WasmLib 路径引入错误，可通过WasmLibPath配置资源路径；绝对路径可配置"/"，具体路径根据项目 public 文件路径调整。
queryLiveStatus streams.status：0 正常直播；1 封面异常（检查 coverUrl）；2 视频源异常；3 码流转换异常；4 云存储访问异常；10 暂停。liveStatus 1 开启 / 2 暂停时需 modifyLivePlanStatus 或控制台恢复。
云直播仅 H.264 + AAC，编码不符时在设备 Web 管理页调整，见 创建设备直播地址。
原生端预览失败：查 OpenSDK 日志与 token/设备绑定；对比 选择集成方式 所选协议路径。
卡顿
轻应用多路同屏时 CPU/GPU 压力大（解密 + canvas 渲染）。建议：
- 同页减少并发播放器数量，或降低分辨率/码流。
- PC 浏览器：Chrome / Firefox / Edge ≥ 55；多线程解码建议 Chrome/Edge ≥ 91、Firefox ≥ 97（见 轻应用组件 支持表）。
- 原生端卡顿：查设备与网络，参考各端 OpenSDK 预览集成文档。
高延迟
参考 选择集成方式 对比表（出流与延迟为典型值，非 SLA）：
| 移动应用对接 | 云直播对接 | 轻应用对接 | 桌面应用对接 | |
|---|---|---|---|---|
| 出流速度 | 1-2秒 | 3-8秒 | 1-3秒 | 1-2秒 |
| 实时延迟 | 1-2秒 | 8-10秒 | 2-3秒 | 1-2秒 |
轻应用使用说明 另有「秒出流，低延迟」，没有秒数。秒数只以上表为准。
降低延迟：优先私有协议路径（移动/桌面 OpenSDK，见对比表「实时延迟」列）；云直播 HLS 延迟较高属预期，可换集成方式或接受 8–10s 量级。