HMusic - 智能音乐播放器 🎵

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

💬 交流群

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

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

🚀 v3.0.0 大版本更新

• 全新极简青绿色视觉风格，统一首页、播放页、登录页、设置页等核心界面。
• 新增外观模式设置，支持跟随系统、浅色模式和深色模式。
• 重做启动页与多平台应用图标，统一 Android、iOS、macOS、Web、Windows 图标安全边距。
• 修复 Android 边缘沉浸式体验，改善小米 10 Pro 等设备底部黑边、手势条和 dock 区域重叠问题。
• 优化播放页、曲库页、搜索页、底部导航栏和赞赏弹窗的交互与视觉细节。
• 修复直连模式曲库播放、歌单作用域、播放设备选项、熔断器和自动下一曲平台选择等问题。
• 发布 Android 通用包、Android 分架构包和 iOS unsigned IPA，并提供 SHA-256 校验文件。

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

📱 下载安装

从 Releases 下载最新版本：

平台	文件	说明
🤖 Android 通用版	HMusic-v3.0.0-android-universal.apk	推荐，兼容大多数设备
🤖 Android arm64	HMusic-v3.0.0-android-arm64-v8a.apk	现代手机，体积更小
🤖 Android arm32	HMusic-v3.0.0-android-armeabi-v7a.apk	老旧设备
🤖 Android x86_64	HMusic-v3.0.0-android-x86_64.apk	模拟器或 x86_64 设备
🍎 iOS	HMusic-v3.0.0-ios-unsigned.ipa	未签名 IPA，需自签名安装
🔐 校验和	checksums.txt	SHA-256 校验文件

老版本用户通常可以直接覆盖安装升级；如遇签名冲突，请先卸载旧版本后重新安装。

🎯 两种模式

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

⚡ 快速开始

直连模式（推荐新手）

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

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

xiaomusic 模式

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

📚 文档

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

---

🙏 致谢

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

---

---

☕ 请作者喝杯咖啡

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

    

微信赞赏                                支付宝

---

📜 许可证

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