Kazumi 中文文档 下载 App

播放卡顿与加载失败的分层排查法

播放问题的排查讲究分层,从最廉价的原因试起。

第一层:画质处理太重

症状:开着超分辨率后播放卡顿。这是官方问答里的高频问题:

弹幕刷屏也会压垮渲染——热门番开播时试试开「海量弹幕」的叠加绘制,或关掉当集弹幕(见弹幕设置页)。

第二层:内存与缓存

症状:整体卡、拖进度条频繁缓冲、系统提示内存吃紧。应用为了流畅会尽量把视频缓存进内存,内存紧张的设备:

顺带回答另一个官方 FAQ:播放时内存占用高是设计行为——拿内存换流畅,介意就开低内存模式,而不是当 bug 报。

第三层:源与嗅探

症状:黑屏、转圈不出画面、进度条不走。这层在应用设置之外:

  1. 同一部番换个线路/换条规则试——源站抽风是最常见原因;
  2. 换 WebView 兜底:规则高级选项里关「内置播放器」(见高级选项页);
  3. 怀疑平台差异:安卓与鸿蒙的嗅探方案稳定性弱于桌面端(见平台差异页),同一规则桌面能放、手机放不出时先想到这个;
  4. 内置播放器正常、外部播放器放不出,那是反盗链,见外部播放页。

还是不行

播放设置里开调试模式收集日志,配合「关于」页里的错误日志,带着信息去项目 Issues 区提问——提 issue 需要附日志文件,这是官方要求的标准动作。