🎥 视频流支持说明与排查指南
为了确保您在数字孪生平台获得最佳的视频流体验，我们特此提供本指南，详细说明平台支持的视频格式、硬件加速条件，并指导您进行基本的视频流排查。
1. 平台支持的视频流格式
我们的数字孪生平台主要支持以下主流视频编码格式，并特别强调对 YUV420 像素格式的优化和支持：
| 视频编码格式 | 像素格式 | 备注 |
|---|---|---|
| H.264 / AVC | YUV420 | 业界最广泛使用的编码标准，兼容性极佳。 |
| H.265 / HEVC | YUV420 | 新一代高效视频编码，在相同画质下拥有更高的压缩率。 |
| VP9 | YUV420 | Google 开发的开放、免版税视频编码格式，常用于Web视频。 |
| AV1 | YUV420 | 新一代开放、免版税视频编码格式，提供更高的压缩效率。 |
重要提示： 平台对视频流的硬解（GPU加速）处理，主要集中在上述列出的 YUV420 像素格式。确保您的视频源符合这些编码和像素格式，是获得流畅体验的基础。
2. GPU 硬件加速支持 (硬解)
为了最大化视频流的解码效率和性能，我们的平台支持对特定协议和编码格式的视频流进行 GPU 硬件加速。
| 加速类型 | 支持的协议 | 支持的视频编码 |
|---|---|---|
| GPU 硬件加速 (硬解) | RTSP (Real-Time Streaming Protocol) | H.264/AVC (YUV420) H.265/HEVC (YUV420) VP9 (YUV420) AV1 (YUV420) |
关键说明：
- RTSP 协议限制： 目前，我们的 GPU 硬件加速功能仅支持 RTSP 协议的视频流。
- 非 RTSP 协议处理： 对于其他协议的视频流（例如 HLS、RTMP、HTTP-FLV 等），即使其编码格式在我们支持的范围内，平台也将默认采用软件解码。软件解码会更多地占用 CPU 资源，在某些情况下可能会影响性能，尤其是在高分辨率或多路视频同时播放时。
- 崩溃风险： 如果非 RTSP 协议的视频流在平台内部错误地尝试调用 RTSP 专用的硬件解码器，可能导致解码失败甚至平台崩溃。
3. 如何开启硬件加速
开启硬件加速，可以通过GPU内置的视频解码，效率更高。
- 启动 DTS Explorer Launcher： 通过安装DTS Explorer，会附带安装DTS Explorer Launcher，在开始菜单启动。
添加附加参数： 在附加参数框，输入以下命令：
附加参数：
-hwAccelMedia创建快捷方式：创建快捷方式到桌面。方便使用。
4. 如何测试视频流 (使用 VLC Media Player)
VLC Media Player 是一款功能强大的开源播放器，具有出色的兼容性，常用于测试各类视频流。
- 下载 VLC： 访问 VLC 官网 下载并安装。
- 打开网络串流：
- 打开 VLC。
- 点击菜单栏的 “媒体” (Media) -> “打开网络串流” (Open Network Stream)。
- 粘贴 URL： 在弹出的窗口中，将您的视频流 URL (RTSP, HLS 等) 粘贴到输入框中。
- 点击播放： 点击 “播放” (Play) 按钮。
- 观察结果：
- 如果 VLC 能正常流畅播放，则表明视频流本身是健康的，问题可能出在平台对该流的处理上。
- 如果 VLC 也无法播放或出现卡顿、错误，则视频流本身可能存在问题。
5. 故障排查建议
当您在平台播放视频流遇到问题时，请按照以下步骤进行排查：
确认开启硬解：
- 开启硬解了吗？如果视频流播放有问题，请优先开启硬解。
确认协议类型：
- 视频流是 RTSP 协议吗？ 如果是，并且编码为 H.264/H.265/VP9/AV1 (YUV420)，那么它应该能获得 GPU 硬件加速。
- 如果是非 RTSP 协议 (如 HLS)？ 平台将使用软件解码。如果出现性能问题，请确认 CPU 占用率是否过高。
- 排查方向： 确保您的视频流协议与平台预期（尤其是硬件加速）相符。
检查编码格式和像素格式：
- 使用VideoInfoExtractor工具检查您的视频流是否为 H.264/H.265/VP9/AV1，并且像素格式为 YUV420。
- 排查方向： 不支持的编码或像素格式会导致解码失败。
使用 VLC 单独测试：
- 将有问题的视频流 URL (尤其是 HLS 主播放列表中的某个独立子流，或 RTSP 流) 放入 VLC 中测试。
- 排查方向： 区分是视频源本身的问题，还是平台处理的问题。
HLS 码率切换问题 (特定于 HLS 协议)：
- 如果您播放的是 HLS 流，且单个清晰度子流在平台中可以单独播放，而加载主 M3U8 列表时崩溃，则问题可能出在平台处理 自适应码率切换 的逻辑上。
- 排查方向： 检查平台在不同码率流之间切换时的解码器初始化、资源释放和参数配置等环节。
尝试禁用硬件加速 (如果适用)：
- 如果您怀疑是硬件加速导致的问题 (特别是 RTSP 流)，可以尝试在平台内部设置中禁用视频流的硬件加速，强制使用软件解码。
- 排查方向： 这有助于判断问题是否与 GPU 驱动、硬件兼容性或硬件解码器实现相关。
通过以上步骤，您应该能够对视频流的问题有一个初步的判断。如果问题依然无法解决，请将您进行的所有测试步骤、FFprobe 输出、VLC 播放结果以及平台崩溃时的日志信息提供给我们的技术支持团队，我们将竭诚为您提供进一步的帮助。