播放卡顿或失败：按顺序排查这几点

播放出问题时别急着卸载重装，按下面的顺序排查，绝大多数情况能在两分钟内解决。

排查清单

1. 先确认网络

• 换一个视频试试：只有单个视频异常，多半是源或网络波动；
• 切换 Wi-Fi / 移动数据对比，路由器抽风的概率不低。

2. 降画质

• 高码率 4K/1080P 对带宽要求高，先降到 720P 看是否流畅；
• 流畅后逐级升档，找到当前网络的舒适区。

3. 检查解码与硬解

• 解码格式切换（AVC / HEVC）对比，个别机型对特定编码的硬解支持差；
• 硬件加速异常时（花屏、绿屏、黑屏）尝试关闭硬解，或反之开启，见画质音质页；
• 开了超分辨率的先关掉再试，该功能对性能有要求。

4. 清缓存与重启

• 应用内清理缓存，或系统设置里清除应用缓存（注意别清数据，会丢本地缓存视频）；
• 杀掉应用重新打开，设备长期不重启的也重启一下。

5. 更新版本

• 接口变动导致的批量播放失败，通常几天内就有修复版本，升级后即恢复，见更新数据页。

仍未解决

到仓库 Issues 区搜索你的机型与报错关键词，没有同类反馈再提交 issue，附上设备型号、系统版本、应用版本与复现步骤。

大面积播放异常（所有视频都失败）大概率是接口或服务端变动，等更新比反复设置更有效。