手机接力与 Hub

局域网配对、同步曲库、手机播放与桌面接回。

Windows · WinUI 预览版

局域网配对、同步曲库、手机播放与桌面接回。

页面说明

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

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

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

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

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

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

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

手机接力与 Hub

WinUI 当前已接入桌面与手机之间的局域网连接、曲库同步和接回播放。独立 OFPlayer Hub 的产品能力需单独看待，不能用桌面接力完成来推断所有 Hub 功能都已发布。

在同一局域网内配对

  1. 让电脑和兼容的手机 OFPlayer 处于可互相访问的局域网内，并保持桌面应用运行。
  2. 在电脑打开 设置 → 设备与 Hub，选择 开启配对。
  3. 在手机选择发现的电脑，或扫描桌面显示的二维码；手动连接时使用界面上的配对码。
  4. 按手机端流程完成曲库同步，再选择歌曲。

配对码有有效期，以桌面显示为准。二维码和手动连接地址用于建立连接，不应作为公开分享的展示素材。

配对和同步是两个步骤

配对让设备建立身份关系；同步让手机拿到可播放曲目、封面和相应资源版本。只有“已连接”而没有完成同步，仍可能无法点歌。

当前版本会保存配对设备和已完成的同步状态，并在已启用服务的情况下尝试在重启后恢复连接。主动 关闭服务后不会在下次启动时擅自重新开启。重启恢复连接也不意味着自动恢复声音播放。

在电脑继续播放

手机正在播放时，桌面播放区域和设备页面可以显示当前曲目及进度。点击 在这台电脑继续播放发起接回；等手机确认后再由桌面继续，避免两端自行同时播放。

当前实现已有手机播放后桌面接回的设备验证记录；换网、睡眠、确认超时和连续切换设备仍需要独立验证。

连接异常

  • 找不到电脑：确认桌面应用仍运行、服务处于开启状态，且两端网络可互通。
  • 配对码失效：查看桌面当前码，不重复使用截图中的旧码。
  • 已连接但点歌失败：先确认同步成功，再重新选择曲目；旧失败项目不一定会自行恢复。
  • 桌面重启后未恢复：检查服务状态和当前数据目录，切换了预览数据目录会使用另一套设备记录。

独立 Hub 的范围

OFPlayer Hub 面向私人曲库托管、串流、设备协作等场景，提供独立运行与桌面协作的方向。独立 Hub 的曲库、串流与一起听进度应以其实际版本说明为准。WinUI 的 Hub 设置与连接详情展示运行模式和能力信息，并不代表所有规划能力都已开放。