Spotube 播放跳帧 / 卡顿 / 无声——从网络到本地排查

跳帧的常见原因和修复步骤

第一步：确认是所有音频源都卡还是某个特定源

1. 用 YouTube Audio 插件播放一首歌 → 听有没有卡顿
2. 切到 Piped Audio → 同一首歌再听
3. 切到本地 FLAC 文件 → 再听

如果只有某个音频源卡 → 问题在那个音频源插件或它连接的服务（比如某个 Piped 实例挂了）。如果全部都卡 → 继续第二步。

第二步：网络问题

Spotube 播放流式音频需要持续稳定的带宽（128kbps AAC 需要至少 200kbps 的稳定带宽，FLAC 需要 800kbps+）。

快速测试：

• 在浏览器里打开 spotube.cc/downloads 下载一个 10MB 文件 → 看速度稳不稳定
• 如果下载速度剧烈波动（有时 2MB/s 有时 50KB/s）→ 网络抖动，Spotube 很难稳定播放
• 临时开 VPN 或换网络（手机热点 vs Wi-Fi）试试

已知问题：中国大陆 / 香港 / 台湾 / 欧洲部分地区直接访问 YouTube API 会被限速或不稳定 → 建议：

• 换 Piped（选一个你所在地区稳定的实例）
• 或挂代理（Spotube 支持系统代理，桌面端在设置里填 HTTP proxy）
• 或先用 YouTube 插件下载，再本地播放

第三步：MPV 引擎本身

Spotube 的播放内核是 libmpv。如果连本地文件播放都卡：

1. Spotube 设置 → Playback → Playback engine → 确认选的是 MPV
2. 切换硬件加速模式：

• Windows：在 Spotube 设置里选 Direct3D11 / D3D12 / Vulkan 轮流试
• macOS：VideoToolbox（默认，最稳）
• Linux：VAAPI / NVDEC / DXVA 轮流试

1. 如果是 Linux + Flatpak：flatpak override --socket=wayland com.github.KRTirtho.Spotube（Wayland 下需要）

第四步：系统音频独占

桌面端有时其他应用独占了音频设备：

• 检查有没有 Discord、Zoom、浏览器标签页等正在发声
• Windows 上右键音量图标 → 声音设置 → 管理声音设备 → 右键当前输出设备 → 属性 → 高级 → 取消"允许应用程序独占控制此设备"
• macOS 上打开"音频 MIDI 设置" → 确认音频设备没有被锁定

第五步：Spotube 自身的 CPU 占用

Spotube 播放时 CPU 占用应该在 5% 以下。如果超过 20%：

1. Spotube 设置 → Theme → 关闭 "动态封面色"（这个 feature 每首歌切时会做 palette 提取，可能短时间吃 CPU）
2. 关闭本地后台的扫描和下载（同时做太多事 CPU 可能顶不住）
3. 重启 Spotube

无声排查

Spotube 显示正在播放进度走，但没有声音：

1. 检查系统音量（Spotube 自己的音量 + OS 的音量）
2. 检查音频设备（是不是选错了输出设备）
3. Spotube 设置 → Playback → Audio device → 手动选正确的输出设备
4. Windows 上可能需要重装音频驱动
5. macOS 上如果是外接声卡：拔掉重插

v5.1.0 已知修复

v5.1.0 修复了几个导致跳帧的问题：

• 单连接流式传输替代 chunked streaming（#2316）→ 减少连接中断时的卡顿
• FLAC 播放支持 → 之前 FLAC 强制重采样导致的卡顿被修复
• 播放下一首不工作 → 已修复
• Android 16KB page size 支持 → 新设备兼容问题

如果你在 v5.0.x 遇到跳帧，升级到 v5.1.0 通常能好。