本地文件与设备库——Symfonium 怎么读取你手机里的音乐

两种读取模式

Symfonium 支持两种方式读取设备本地文件：

• Android MediaStore 模式：让 Android 系统先把设备里的音频索引好，Symfonium 从系统数据库拉取列表。优点是接入简单，缺点是只能看到 Android 媒体库里有的文件，系统没扫描到的或被标记为"不可见"的目录会漏掉。
• Symfonium 自定义解析器：Symfonium 自己遍历指定路径、自己解析标签。能覆盖 MediaStore 模式下看不到的目录（比如存储卡上的非标准路径），但会多占一些扫描时间。

第一次添加本地媒体源时，向导会默认用 Symfonium 的自定义解析器。

权限授予

打开 设置 → Manage media providers → Add media provider → Local device：

1. 选择读取模式（推荐保持 Symfonium 自定义解析器）
2. 点 Grant permission，允许 Symfonium 访问音频文件
3. 如果想指定额外路径（比如存储卡的某个目录），在步骤里选择路径

在 Android TV 上，向导会直接停在权限这一步，没有前两个选项。

标签解析

Symfonium 自带一套自定义标签解析器，覆盖常见音频格式的标签标准：

• ID3v1 / ID3v2（MP3）
• Vorbis Comment（FLAC、Opus、Ogg Vorbis）
• iTunes / MP4 原子（AAC、ALAC、M4A）
• APE Tag（Monkey's Audio）
• RIFF INFO（WAV）
• Cue Sheet（分轨）

如果你的文件标签写得乱或不完整，Symfonium 可能只能按文件名或目录结构来分类。

艺术家信息文件夹

除了音频文件自身的标签，Symfonium 还会在艺术家信息文件夹里查找额外资料，比如艺术家简介、头像、流派分组等。这部分文件按目录约定组织，放在音乐库根目录下特定位置即可被自动识别。

MediaStore 模式的局限性

如果切回 MediaStore 模式，Symfonium 看到的是 Android 系统对本机音频的索引。这意味着：

• 系统认为不是音频文件的会被排除
• 被 .nomedia 文件标记的目录不会被扫到
• 部分厂商定制 ROM 对媒体库扫描做了额外限制，可能导致文件数偏少或延迟

建议：除非你明确有某个 MediaStore 专属的使用场景，否则保持 Symfonium 自定义解析器更稳。