3分钟搞定小爱音箱音乐服务：终极配置指南让你告别DID烦恼
3分钟搞定小爱音箱音乐服务：终极配置指南让你告别DID烦恼
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
还在为小爱音箱无法播放音乐而烦恼吗？🤔 小爱音箱音乐服务（xiaomusic）是一款让你通过小爱音箱播放音乐并保留完整语音交互能力的开源神器！但很多新手在启动服务时都会遇到设备DID配置难题，导致服务无法正常运行。别担心，这篇终极指南将用最简单的方法帮你快速解决所有问题！
🚀 快速开始：3种配置方案任你选
方案一：网页可视化配置（最适合新手）
适用场景：服务能启动但找不到设备，或者你更喜欢图形界面操作。
操作步骤：
- 启动xiaomusic服务（即使有DID警告也没关系）
- 打开浏览器访问
http://localhost:8090 - 在左侧菜单找到"小爱设备控制"
- 点击进入"设备管理"
- 选择你的小爱音箱并点击"绑定设备"
小爱音箱音乐服务控制面板 - 轻松管理设备连接
优点：无需记忆命令，界面直观，点点鼠标就能完成配置！
方案二：环境变量快速配置（适合技术爱好者）
适用场景：需要快速测试或临时使用。
操作步骤：
- 从小米音箱App获取设备DID（设备详情页查看）
- 打开终端，执行以下命令：
# Linux/Mac export MI_DID=你的设备ID # Windows命令行 set MI_DID=你的设备ID # Windows PowerShell $env:MI_DID="你的设备ID" - 启动服务：
python xiaomusic.py
优点：即时生效，无需修改任何文件，适合快速测试！
方案三：配置文件永久配置（适合长期使用）
适用场景：希望一次配置，长期使用，避免重复设置。
操作步骤：
- 复制配置文件模板：
cp config-example.json config.json - 编辑配置文件：
nano config.json - 找到
"mi_did": ""这一行，填入你的设备DID - 保存并启动服务：
python xiaomusic.py
优点：配置永久保存，重启服务无需重新设置！
🔍 DID到底是什么？为什么这么重要？
DID（Device ID）就像小爱音箱的"身份证号码"🎫，没有它，xiaomusic服务就无法识别你的音箱。获取DID的3种方法：
- 小米音箱App查看：打开App → 选择设备 → 设备信息 → 查找"设备ID"
- 网页控制台获取：启动服务后，访问网页控制台会自动显示可用设备
- 局域网扫描工具：使用Advanced IP Scanner等工具查找设备信息
设备管理界面动态演示 - 轻松管理播放列表
📝 常见问题快速排查指南
❌ 问题1：服务启动失败，提示"找不到设备DID"
解决方法：
- 检查配置文件路径：确保
config.json文件在正确位置 - 验证DID格式：DID应该是类似 "1234567890abcdef" 的字符串
- 重启小爱音箱：有时候设备需要重新连接网络
❌ 问题2：网页控制台能打开，但无法播放音乐
解决方法：
- 确认网络连接：确保电脑和小爱音箱在同一局域网
- 检查防火墙设置：临时关闭防火墙测试
- 验证端口设置：默认端口是8090，确认没有被占用
❌ 问题3：语音控制无效，只能手动播放
解决方法：
- 开启语音口令功能：在网页设置中打开"获取对话记录"开关
- 检查唤醒词：默认是"播放歌曲"，不能说错哦！
- 重启服务：配置完成后记得重启一次
🔧 高级配置技巧
多设备支持
如果你有多个小爱音箱，可以在DID配置中使用逗号分隔：
"mi_did": "did1,did2,did3"自定义唤醒词
修改配置文件中的key_word_dict部分，添加你喜欢的口令：
"播放音乐": "play", "来首歌": "play", "暂停播放": "stop"音乐格式兼容性
部分设备不支持FLAC格式，可以在设置中开启"转换为MP3"选项，系统会自动转换格式。
🎯 验证配置是否成功
配置完成后，通过这3个方法验证：
- 查看服务日志：启动时应该看到"设备DID已加载"的提示
- 测试网页播放：在控制台选择歌曲点击播放，听听音箱有没有声音
- 语音控制测试：对小爱说"播放歌曲周杰伦"，看看能否正常响应
📚 学习资源与进阶配置
- 官方文档：docs/issues/index.md
- 常见问题：docs/issues/99.md - 这里有详细的FAQ解答
- 插件开发：plugins/ - 了解如何扩展功能
🎉 开始享受音乐吧！
现在你已经掌握了小爱音箱音乐服务的所有配置技巧！🎵 无论你是选择网页可视化配置、环境变量快速配置，还是配置文件永久配置，都能轻松搞定设备DID问题。
记住：正确的DID配置是服务正常运行的关键！选择最适合你的方法，按照步骤操作，很快就能让小爱音箱为你播放喜欢的音乐了。
下一步行动：
- 选择一种配置方案立即尝试
- 遇到问题先查看FAQ文档
- 加入社区讨论获取更多帮助
还在等什么？赶紧动手配置，让你的小爱音箱变身私人音乐管家吧！🎶 如果有任何问题，欢迎在项目Issues中提问，社区的小伙伴们都很热心哦！
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考