远端音乐来源

添加连接、选择远端曲库和处理加载失败。

Windows · WinUI 预览版

添加连接、选择远端曲库和处理加载失败。

页面说明

远端音乐来源 是 OFPlayer 本地优先音乐工作流的一部分。这个页面会先说明功能边界、适用场景和下一步入口，再交给网页播放器或工具页面完成具体操作。

OFPlayer 面向有个人音乐收藏的用户，重点放在本地文件播放、WebDAV 与 Subsonic/Navidrome 音乐库连接、歌词和音频工具、隐私优先的数据处理，以及足够克制的桌面式界面。

如果你只是想试用，可以从网页版开始导入本地音频；如果已经有 NAS、服务器或远程曲库，可以继续阅读教程，把 OpenList、WebDAV 或 Navidrome 接到同一套播放体验里。

页面内容会尽量说明真实可用的能力，不把尚未完成的方向包装成已经上线的功能。遇到部署、连接或格式问题时，可以顺着相关文档和工具逐步检查，而不是在播放器里反复猜配置。

对于搜索、分享或禁用脚本的访问场景，这份静态内容也会保留核心信息：页面主题、产品边界、相关入口和下一步操作都能被直接读取，不依赖前端应用完成后才出现。

每个入口都会尽量连接到相邻的说明页，避免只留下单点页面，内容也会随着产品发布持续更新。

从这里可以继续访问 OFPlayer 文档、下载与版本、GitHub。这些内部入口覆盖产品介绍、教程、文档、下载和实际工具，方便从了解能力一路走到部署、整理曲库和开始播放。

远端音乐来源

音乐可以继续放在自己的 NAS 或服务器上。WinUI 通过来源选择器连接远端，不要求把远端列表先整理成本地歌单。

添加连接

  1. 打开左上角来源选择器，选择 添加远端来源…。
  2. 填写名称，并选择类型。
  3. 填写服务地址、可选根路径及服务器要求的用户名和密码。
  4. 点击 测试连接，查看返回结果，再保存。
  5. 重新打开来源选择器，选择保存的连接。
类型 使用场景
webdav 服务器提供 WebDAV 文件访问入口
subsonic Navidrome 或兼容 Subsonic 的音乐服务
ftp 使用 FTP 提供文件的服务

连接地址应是服务提供的协议入口，而不是管理网页地址。Navidrome 在此选择 subsonic；WebDAV 根路径是否需要填写，取决于服务入口是否已包含音乐目录。

浏览与播放

连接成功后，若服务返回多个曲库，可选择目标曲库再浏览。点击曲目后，原生宿主解析远端资源并交给播放链路；出现连接或解析错误时，页面会显示状态。

加载更多会扩大获取数量。当前预览版最多获取 5000 条，并非完整的无限分页；服务端有更多曲目时，不能把当前列表当成整个曲库。

连接失败时

  • 测试失败：检查服务是否在线、协议类型、地址、认证和根路径。
  • 能连接但没有歌曲：确认所选曲库、目录权限及音乐目录是否正确。
  • 列表有歌但不能播放：检查音频原文件是否还在、资源地址是否过期，以及网络是否中断。
  • 更换服务器或切换曲库后：等待当前加载完成，再核对来源名称。

实际兼容性取决于服务端实现；界面提供协议选项不代表每一种服务器都已实测。更完整的 WebDAV 操作见连接教程。

与 Hub 的区别

这里连接的是已有的外部音乐服务；桌面手机接力和独立 Hub 属于另一条工作流程，参见手机接力与 Hub。