跳转到主要内容
2026-10-30Pure Music Player开发周报Subsonic折叠屏

Pure Music Player 10 月开发周报:Subsonic 增量同步、折叠屏播放界面与更安全的 PureStream 连接

本月 Pure Music Player 完成 Subsonic 增量同步、折叠屏 iPhone 五姿态播放界面、PureStream 配置页重构与两个底层可靠性修复。新增歌曲会立即出现在专辑与艺人页,旧版本曲库也能在启动时自动完成安全迁移。

Pure Music Player 10 月开发周报:Subsonic 增量同步、折叠屏播放界面与更安全的 PureStream 连接

在 10 月里,Pure Music Player 团队在曲库同步、新设备形态适配、服务连接体验与底层存储可靠性上取得了多项进展。以下是本期周报的重点内容。

🔄 Subsonic 增量同步:更省流量,秒级刷新

为了让远程曲库的同步体验更加高效与丝滑,我们全面升级了 Subsonic 音乐源的同步机制:

  • 增量拉取机制:由以往的全量重扫升级为增量同步,仅拉取远端发生变动的歌曲,大幅节省流量并缩减耗时。
  • 随时取消与统一进度:同步支持随时手动取消;源中心与音源列表行实时显示同一份进度。
  • 自动补全封面与歌词:同步完成后,系统在后台自动补全缺失的专辑封面与歌词;歌词保存到本地,离线状态下同样支持查阅。
  • 同名实体分开保存:不同音乐源中的同名专辑或艺人独立建档,避免相互覆盖。
  • 清晰的状态与多语言:歌曲信息页明确标示元数据来自 Subsonic;同步完成后曲库自动刷新;未同步、同步中、补齐中、失败均提供清晰文案,并支持 9 种语言。

📱 折叠屏 iPhone 播放界面:自适应五姿态画布

为了迎接新形态设备,我们为折叠屏 iPhone 与双屏折叠设备打造了全新播放界面:

  • 五姿态智能排版:全新的自适应播放布局能根据屏幕形态自动选择帐篷、竖屏、横屏、展开与书本五种布局。
  • 避开折痕与遮挡:排版算法能够精准识别物理折痕与系统遮挡区域。展开状态下左侧展示封面与播放控制、右侧呈现歌词或队列;书本姿态下歌词舒适置于下半区。
  • 贴心的回滚保护:提供两级开关:可一键切回传统播放页,也可仅关闭展开双栏排版让 iPad 横放回归经典堆叠。
  • 跟随系统可用区域:清理了旧有的屏幕尺寸和设备类型判断,布局改为跟随系统给出的可用区域。目前折叠屏真机适配仍在进行,部分动效和无障碍细节还在收尾。

🔗 PureStream 配置页更简单:免密直连,清晰明了

我们重塑了与 PureStream 服务端的连接配置流程:

  • 直观的双模式选择:未配置时先呈现一句话说明,随后提供两张模式卡——「绑定卡」明确需 PureStream 订阅,「直连卡」说明支持自建 PureStream 或第三方 Subsonic 服务器。
  • 免密直连授权:完成绑定后,播放器通过设备授权直接向家庭服务器获取临时账号,不再要求输入用户名与密码。
  • 界面层级清晰:移除了只读的服务器地址展示与诊断里的主机名和物理路径。已配置时按「摘要 → 连接/同步 → 进度 → 主按钮 → 音质 → 诊断」排列,音质设置默认折叠。

⏱ 网络繁忙更从容:智能重试与温和退避

面对网络波动与服务繁忙,客户端表现更加稳健:

  • 按建议时间重试:服务端返回「请稍后重试」时,客户端按服务端建议的等待时间重试,不再固定等 5 秒、6 次后直接失败。
  • 限流即时提示:遇到访问频次超限时立即提示用户稍后重试,不进行静默等待。
  • 区分错误类型:普通网络错误采用带上限的平滑退避重试;权益未激活、家庭不匹配或旧授权等明确错误立即停止重试。每次请求使用独立请求标识,便于服务端识别。

📚 大曲库模式设置页重做:直观清晰,一目了然

针对数万首以上的大型曲库管理,我们重做了大曲库模式设置界面:

  • 统一命名体系:统一定名为「大曲库模式 / Large Library Mode」,不再混用「快速列表索引」「高性能模式」。
  • 消除事实复读:同一技术事实只出现一次;曲库体积、构建进度与会员权益各自只占一个位置,去除多层卡片嵌套。
  • 自适应响应排版:进度条撑满行宽,小屏设备不再截断,宽屏不再大量留白。
  • 状态文案精准对应:暂停、失败、修复、就绪等状态均有独立文案;清除索引的确认提示会按开关状态区分,避免说明与实际行为不符。

🛠 底层存储可靠性修复

本月我们修复了两个底层可靠性问题:

  • 旧版本曲库安全识别:旧版本曲库无法被新版本识别时,应用在启动时会自动尝试一次安全的轻量迁移;成功后可正常添加本地文件夹,失败则保留原曲库并继续保护数据。
  • 大曲库增量索引不丢歌:此前大曲库索引会漏掉构建后新增的歌曲;现在索引会在保存时同步更新,并在启动时检查完整性,发现不一致会自动回退到普通列表并重建索引,确保新导入的歌曲正常出现在专辑与艺人页。

📌 已知问题与下一步

当前版本仍有以下已知问题在持续完善中:

  1. 折叠屏 iPhone 的部分动效、弹窗避让和无障碍阅读顺序还在完善;减弱动态效果的适配会在后续版本补上。
  2. 网络重试的界面提示还会继续完善:目前连续点击「检查连接」可能重复发起检查,重试倒计时也还没显示。
  3. 极少数更早版本的曲库仍可能需要手动恢复;大部分旧库已经可以在启动时自动完成安全迁移。

下一步,我们将继续完成折叠屏适配与无障碍收尾,补上重试提示和倒计时,并扩大旧版本曲库的自动迁移覆盖。