NeriPlayer 中文文档 下载 App

下载任务的可调并发、Range 续传、应用重启恢复与标签写入容错

下载架构

NeriPlayer 的下载不走系统 DownloadManager,而是用应用内的 AudioDownloadManager 直接管理:

续传策略

传输类型续传方式
直接 HTTP 传输按 Range 头分块,支持断点续传
平台需显式 Range按分块 Range 请求
HLS按分片续传,失败分片跳过继续

下载队列的持久化

标签写入的容错

下载完成后应用会尝试把歌曲的元数据(标题、歌手、专辑、封面)写入音频标签(ID3v2 / Vorbis Comment)。如果标签写入失败:

保存的额外数据

下载完成后除了音频本身,还会同步保存:

高风险网络提示

批量或单曲下载在高风险网络(移动 / 漫游)下会主动弹出提示,让用户确认后再继续下载——避免把「省流量」只做成设置页里的摆设。