Repository navigation
v2.3.0
HMusic v2.3.0 更新说明
⚠️ 重要建议(必读)为保证 HMusic v2.3.0 的功能完整与稳定性,强烈建议将 xiaomusic 服务端升级到
v0.4.23或更高版本。原因:本版本联动了我针对 HMusic 场景提交到 xiaomusic 的一批 PR(接口/行为对齐与兼容性修复),旧版本服务端可能出现功能不一致或异常。
本版本聚焦三件事:
- 播放链路稳定性增强(直连/xiaomusic 双模式)
- 多平台歌单导入与解析能力提升
- 小米音箱不同音源策略落地(网易/QQ/酷我)
主要新增
- 新增外部歌单导入流程与平台归一化能力。
- 新增歌单解析策略与统一歌曲解析器(含熔断机制)。
- 新增并增强 xiaomusic API:
pushUrl、getPlayerStatus、downloadonemusic.playlist_name。 - 新增直连模式 warmup 轮询与切歌会话保护。
体验优化
- 直连模式播放链路进一步与 xiaomusic 对齐。
- 登录流、导航与底部弹层交互统一。
- 主页面性能优化,减少不必要重建。
问题修复
- 修复 iOS 导入 LX 脚本后闪退问题。
- 修复动态 token 脚本重启后首次播放失败。
- 修复自动下一首、切歌竞态、进度同步、通知栏控制等播放问题。
- 修复 OH2P 设备恢复播放、seek、进度异常。
- 移除不必要的 URL 强制 HTTPS 改写,修复部分代理 TLS 主机名校验失败。
音源策略(MiIoT)
- 网易:默认直连。
- QQ:默认走代理(直连仅实验开关)。
- 酷我:默认走代理。
感谢大家持续反馈与测试。