alger music 中文文档 下载 App

批量下载:从歌单一次性下载多首歌曲

批量入口

AlgerMusicPlayer 有多处批量下载触发点:

场景操作
下载整个歌单歌单页面 → 右上角菜单 → 批量下载
下载整个专辑专辑页面 → 全部下载
下载多张专辑收藏或艺人页 → 多选专辑 → 批量下载
下载搜索结果搜索结果页 → 多选 → 下载

批量下载控制

并发数量

设置 → 下载 → 并发下载数,默认为 3。根据网络带宽和磁盘写入速度调整:

太高会导致网络拥塞和磁盘写入瓶颈。

下载队列

批量下载触发后会进入下载队列,可以:

v5.1.0 重构了播放列表持久化,队列状态防抖写入,不会因为频繁操作导致状态丢失。

失败重试

下载失败时(网络波动、音源超时),Alger 会自动重试 2~3 次。连续失败后跳过该条继续下一个,不会卡住整个批量任务。

失败的条目可以在下载历史里看到,手动重试。

批量下载灰色歌曲

歌单里混合了灰色歌曲和正常歌曲时:

批量下载的文件命名

批量下载时文件命名规则与单曲下载一致,由设置里的命名模板统一控制。参考:下载文件命名