# HMusic 常见问题 FAQ

## 直连模式相关

### Q: 直连模式需要部署服务器吗？

**完全不需要！** 只需要：
- ✅ 小米账号
- ✅ 小米 AI 音箱（已绑定到账号）

### Q: 直连模式安全吗？

**完全安全！**
- ✅ 账号密码仅存储在手机本地
- ✅ 使用 HTTPS 加密通信
- ✅ 仅与小米官方服务器通信
- ✅ 不会上传到任何第三方服务器

### Q: 直连模式找不到设备怎么办？

检查以下几点：
1. 确认小米账号正确
2. 确认音箱已绑定到该账号
3. 在米家 APP 中检查音箱是否在线
4. 尝试退出登录后重新登录

### Q: 移动数据下无法播放音乐？

移动数据网络需要配置音频代理，详见 [代理部署指南](../cloudflare-worker/README.md)

---

## xiaomusic 模式相关

### Q: 登录账号密码是什么？

登录账号密码需要在 xiaomusic 服务端中设置：
1. 访问 xiaomusic 服务端管理页面
2. 进入"设置"页面
3. 找到"HTTP 认证"相关配置
4. 设置用户名和密码

### Q: 播放后音箱无声音，但暂停时有"收到"提示音？

**原因**：服务端的 IP 和端口配置不正确

**解决**：
1. 进入 xiaomusic 服务端设置页面
2. 检查"公网 IP"和"端口"配置
3. 确保填写的是客户端可访问的地址
4. 保存后重启服务端

### Q: 无法连接服务器？

检查以下几点：
- 确认服务器地址和端口正确
- 确保客户端和服务端网络连通
- 验证服务端正在运行
- 检查防火墙设置

---

## 通用问题

### Q: 可以同时使用两种模式吗？

**可以随时切换！**
- 在设置中切换模式
- 每种模式的配置独立保存
- 建议：
  - 在家/有服务器 → xiaomusic 模式
  - 外出/无服务器 → 直连模式

### Q: 本地播放无声音？

检查以下几点：
- 检查手机音量设置
- 确认已授予存储权限
- 尝试重启应用