流媒体服务支持
SPlayer for Android 支持连接自建流媒体服务器与 WebDAV 网盘，把私人曲库接入统一的浏览与播放体验。
支持的服务类型：Navidrome、Jellyfin、Emby、Subsonic、OpenSubsonic、WebDAV。
功能特性
- 多服务器支持：可同时配置多个服务器并随时切换，启动时自动连接上次使用的服务器；
- 分类浏览：按 单曲 / 歌手 / 专辑 / 歌单 四个标签页浏览库中资源；
- 无缝集成：流媒体歌曲可以像在线歌曲一样加入播放列表、播放与缓存；
- 歌词支持：Jellyfin / Emby 读取服务端歌词接口，OpenSubsonic 读取结构化歌词并转换为 LRC；
- 搜索：全库关键词搜索。
配置指南
- 进入 设置 → 网络与连接 → 流媒体服务，打开 启用流媒体；
- 在 服务器管理 中点击 添加服务器；
- 填写服务器信息：
| 字段 | 说明 |
|---|---|
| 服务类型 | Navidrome / Jellyfin / Emby / Subsonic / OpenSubsonic / WebDAV |
| 服务器名称 | 自定义名称，如 My Navidrome |
| 服务器地址 | 含协议与端口，如 http://192.168.1.10:4533；WebDAV 形如 https://example.com/dav |
| 库根目录 | 仅 WebDAV，音乐库相对根路径，默认 / |
| 认证方式 | 仅 WebDAV：basic（推荐）/ anonymous；digest 暂不支持 |
| 用户名 / 密码 | 匿名认证时可留空 |
- 点击 确认 保存，列表中出现 已连接 徽标即连接成功；
- 在侧边栏 流媒体 页面浏览与播放，顶部下拉框可切换服务器。
各服务类型能力对照
| 能力 | Navidrome / Subsonic / OpenSubsonic | Jellyfin / Emby | WebDAV |
|---|---|---|---|
| 认证方式 | 用户名 + 密码（salt + md5 token） | 用户名 + 密码换 AccessToken | basic / anonymous |
| 单曲 / 歌手 / 专辑 / 歌单 | ✅ | ✅ | ✅（目录即歌单） |
| 歌词 | OpenSubsonic 结构化歌词 → LRC | ✅ 服务端歌词接口 | ❌ 无歌词接口 |
| 封面 | ✅ coverArt | ✅ 图片接口 | ✅ 读取内嵌封面 |
| 首次连接速度 | 快 | 快 | 慢（需全库扫描建索引） |
| 标签信息 | 服务端提供 | 服务端提供 | 读取 ID3 / FLAC 标签 |
WebDAV 使用说明
WebDAV 适配器通过 PROPFIND 列举目录、用 HTTP Range 请求读取音频头尾标签，首次连接会递归扫描全库并缓存索引 5 分钟。库较大时首次连接较慢属正常现象；新增歌曲后等待索引失效或在服务器管理中重连即可刷新。
常见问题
连接失败？
- 检查服务器地址是否包含
http://或https://，端口是否正确； - 确认服务端已开启对应 API（Subsonic 系需开启 API 访问权限）；
- 自签名证书可能被系统拦截，请改用受信任证书或局域网 HTTP；
- WebDAV 请确认认证方式为
basic，digest暂不支持。
歌词不显示？
- WebDAV 没有歌词接口，请配合本地歌词使用；
- Subsonic 系请确认服务端已刮削歌词，OpenSubsonic 结构化歌词会被自动转换为 LRC；
- Jellyfin / Emby 请确认媒体库中存在
.lrc或内嵌歌词。
歌单能同步回服务端吗？
目前仅支持读取服务端歌单，在客户端创建的歌单不会写回服务端。