本地音乐扫描:从硬盘导入你的曲库
功能背景
v5.1.0 之前 AlgerMusicPlayer 只处理网易云在线资源。v5.1.0 新增本地音乐扫描播放,把你硬盘上的 FLAC / MP3 / WAV 等文件也纳入管理。
添加扫描目录
设置 → 本地音乐 → 添加目录,选择电脑上存放音乐的文件夹。支持:
- 单文件夹
- 多文件夹(逐个添加)
- 子文件夹自动递归扫描
扫描逻辑
文件格式
AlgerMusicPlayer 扫描以下格式:
| 格式 | 扩展名 | 音质 |
|---|---|---|
| FLAC | .flac | 无损 |
| WAV | .wav | 无损 |
| ALAC | .m4a | 无损 |
| MP3 | .mp3 | 有损(320kbps 内) |
| AAC | .m4a | 有损 |
| OGG | .ogg | 有损 |
| APE | .ape | 无损(需要额外解码器) |
元数据解析
扫描时会解析每个文件的:
- 文件名
- ID3 标签(艺术家、专辑、曲目号、年份)
- 内嵌封面图(自动提取)
v5.1.0 修复了元数据解析的并发限流和封面体积限制问题——旧版大目录扫描会卡死,新版做了控制。
增量扫描(重要)
下次打开 AlgerMusicPlayer 时会自动增量扫描:
- 已扫描过、文件没变的跳过(不重复解析)
- 新增的文件:解析并加入库
- 删除的文件:从库中移除
并发控制
v5.1.0 增加了并发限流,防止扫描几千首 FLAC 文件时把电脑 CPU 占满:
- 默认最多同时解析 4 个文件
- 大目录扫描不会卡 UI
扫描后的表现
扫描完成后:
- 左侧导航栏出现「本地音乐」分组
- 按艺术家 → 专辑 → 曲目自动分类
- 本地音乐可以和网易云在线歌曲混排播放
- 支持搜索(本地 + 网易云同时搜)
本地音乐 API 安全加固(v5.1.0)
v5.1.0 修复了本地音乐 API 安全问题:API 仅监听回环地址(localhost),防止外部网络访问本地服务进程。