HMusic - 智能音乐播放器 🎵

一款支持小米 AI 音箱的音乐播放器，双模式支持：xiaomusic 服务端模式 + 小米 IoT 直连模式

🚀 v2.3.1 重点更新

• 修复 L06A 直连暂停可能无效的问题，播放控制参数与官方 App 对齐。
• 修复直连模式暂停状态误判，避免“App 显示暂停但音箱仍播放”。
• 增加暂停确认与兜底策略，提升暂停操作可靠性。
• 优化 MiIoT 状态查询与 ubus 域名兼容性，弱网和机型差异场景更稳。

⚠️ 重要建议（xiaomusic 用户）
为保证 HMusic v2.3.1 功能完整与稳定，建议将 xiaomusic 服务端升级到 v0.4.23 或更高版本。

📱 下载安装

从 Releases 下载最新版本：

平台	文件	说明
🤖 Android 通用版	HMusic-v2.3.1-android-universal.apk	推荐，兼容所有设备
🤖 Android arm64	HMusic-v2.3.1-android-arm64-v8a.apk	现代手机，体积更小
🤖 Android arm32	HMusic-v2.3.1-android-armeabi-v7a.apk	老旧设备
🍎 iOS	HMusic-v2.3.1-ios-unsigned.ipa	需自签名安装

🎯 两种模式

	📱 直连模式	🖥️ xiaomusic 模式
适合人群	普通用户，开箱即用	有 NAS/服务器的用户
需要	小米账号	部署 xiaomusic
功能	音乐搜索、播放、音量控制	完整功能（本地音乐库、播放列表、进度控制）

⚡ 快速开始

直连模式（推荐新手）

1. 打开应用 → 选择 直连模式
2. 登录小米账号 → 选择音箱设备
3. 搜索音乐 → 播放！

⚠️ 移动数据用户：需配置音频代理，详见 代理部署指南

xiaomusic 模式

1. 先部署 xiaomusic 服务端
2. 建议升级到 v0.4.23+（与 HMusic v2.3.1 联动更完整）
3. 可参考官方文档站：https://xdocs.hanxi.cc/
4. 打开应用 → 选择 xiaomusic 模式
5. 输入服务器地址和认证信息

📚 文档

• 常见问题 FAQ
• 代理部署指南
• 更新日志
• 开发者文档

---

🙏 致谢

感谢 xiaomusic 项目及其开发者 @hanxi，HMusic 的 xiaomusic 模式基于该项目实现，直连模式的小米 IoT API 也参考了相关实现。

---

💬 交流群

欢迎加入 HMusic 用户交流群，一起讨论使用问题和功能建议～

_{⚠️ 群二维码为动态有效期，失效请提 Issue}

---

☕ 请作者喝杯咖啡

如果 HMusic 对你有帮助，欢迎请作者喝杯咖啡～ 你的支持是我持续开发的动力！

    

微信赞赏                                支付宝

---

📜 许可证

AGPL-3.0 - 开源免费，商业使用需授权