Spotube 中文文档 下载 App

Spotube 默认音频源设置——多音频源并存时的优先级

为什么需要默认音频源

Spotube 最常见的使用方式是 MetadataSearchAPI + AudioAPI 组合——元数据插件给曲目信息,音频源插件给音频流。当你装了多个音频源插件(YouTube + Piped + Invidious + Qobuz)时:

v5.1.0 之前 Spotube 用自动规则选,v5.1 起允许用户显式设置默认。

默认音频源设置位置

Spotube 设置 → Audio source plugins → 顶部:

当前默认音频源:[ YouTube Audio     ▾ ]
可用默认:YouTube Audio / Piped / Invidious / Qobuz Audio / Dab

下拉选哪个就是哪个。如果只有一个音频源插件,Spotube 自动把它设为默认(不需要手动选)。

Spotube 选音频源的优先级规则

当你尝试播放某首歌时,Spotube 按以下顺序决定用哪个 AudioAPI:

  1. 手动指定(最高优先级)→ 播放页右下角 "源切换" 按钮(v5.1 新功能)
  2. 用户设置的默认 → 见上面
  3. 插件声明的 availability → audioApi.isAvailable(track) == true 的都进候选
  4. 按音质排序 → FLAC > WAV > AAC > MP3(同等码率下)
  5. 按码率排序 → 同样格式 320kbps > 128kbps
  6. 第一个可用的(兜底)→ 有就放,没有报 "No audio source available"

优先级规则的例外

手动切换单首歌的音频源

v5.1.0 新增的便捷功能——播放页右下角有一个"源"按钮:

  1. 点开弹出所有候选 AudioAPI 列表
  2. 每个旁边显示该源能给这首歌的格式和码率(比如 YouTube: 128kbps AAC / Qobuz: 16bit FLAC)
  3. 点一个 → 切换,Spotube 立即用新源重新缓冲
  4. 只影响当前这首歌,下一首仍按默认规则走

不同场景下的推荐配置

你的场景推荐默认音频源说明
普通用户,无订阅YouTube 或 Piped免费、无门槛、曲库全
隐私敏感Piped 或 Invidious不登录 Google 账号、无追踪
Qobuz Hi-Fi 订阅用户Qobuz Audio无损优先,v5.1 完整支持 FLAC
印度 / 南亚曲目JioSaavn宝莱坞区域曲库最全
电台爱好者Dab Radio几千个全球电台,混合队列里混入直播

多个音频源插件的性能影响

同时装多个音频源插件会增加:

通常不是问题——Spotube 的插件加载很轻量。

默认元数据源设置

Spotube 同样允许设置默认元数据源(MetadataSearchAPI)。逻辑和音频源一样:Spotube 搜索时会并行调所有启用的 MetadataSearchAPI,但可以设优先级。

默认元数据源设置在 Metadata provider plugins 页顶部。