终极指南：10分钟搭建小爱音箱语音音乐播放系统

终极指南：10分钟搭建小爱音箱语音音乐播放系统

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

Xiaomusic是一个开源智能音乐播放器，专为小爱音箱用户设计，让你通过简单的语音指令就能播放本地音乐和网络歌曲。这款工具完美结合了小米智能音箱的语音交互能力和yt-dlp强大的音乐下载功能，为你打造专属的私人音乐空间。无论你是音乐爱好者还是智能家居玩家，这个项目都能让你的小爱音箱焕发新生。

🎵 为什么你需要Xiaomusic？

传统的音乐播放方式往往需要手动操作手机或电脑，而Xiaomusic彻底改变了这一体验。通过简单的配置，你可以：

• 语音控制播放：只需对小爱音箱说话，就能播放任何歌曲
• 自动下载功能：说出歌曲名，系统自动从网络搜索并下载
• 本地音乐管理：播放存储在NAS或电脑中的音乐文件
• 多设备兼容：支持多种型号的小爱音箱设备
• 完全免费开源：无需订阅费用，一次配置永久使用

🚀 三分钟快速部署指南

Docker安装（最简单的方式）

对于大多数用户，Docker是最快捷的安装方式。只需创建一个docker-compose.yml文件：

services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

然后运行：

docker-compose up -d

手动安装（适合开发者）

如果你熟悉Python环境，可以通过pip安装：

pip install -U xiaomusic xiaomusic --config config.json

基础配置步骤

1. 获取项目代码：

   git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

2. 配置小米账号： 访问http://你的IP:58090，在Web设置页面输入小米账号密码

3. 设置音乐目录： 将音乐文件放入/xiaomusic_music目录

4. 选择设备： 在控制界面选择你要控制的小爱音箱

5. 开始语音控制： 对小爱音箱说"播放歌曲周杰伦晴天"

🎤 语音控制功能全解析

基础播放控制指令

高级功能指令

隐藏玩法

对小爱音箱说"播放歌曲小猪佩奇的故事"，系统会自动搜索并下载相关内容，然后开始播放。这个功能特别适合给孩子播放故事或学习资料。

📱 支持设备型号一览

Xiaomusic已经测试并支持众多小米音箱型号：

提示：如果你的设备不在列表中，很可能也支持。可以在GitHub Issues中反馈测试结果。

🎵 音乐格式兼容性

Xiaomusic支持多种音频格式，确保你的音乐收藏都能播放：

注意：对于不支持FLAC格式的设备（如L05B、L05C、LX06、L16A），可以在设置中开启"转换为MP3"选项。

🔧 高级配置技巧

自定义语音命令

在配置文件config.json中，你可以自定义语音命令：

{ "user_key_word_dict": { "播放我的最爱": "播放歌单我的收藏", "来点轻音乐": "播放歌单轻音乐", "开始工作": "播放歌单工作专注" } }

网络歌单功能

除了本地音乐，Xiaomusic还支持网络歌单：

1. 配置JSON格式歌单：参考官方文档创建自定义歌单
2. 使用分享链接：直接使用别人分享的歌单
3. M3U转换工具：将M3U格式电台文件转换为Xiaomusic可用格式

插件系统扩展

项目提供了灵活的插件系统，你可以在plugins/目录下创建自定义插件：

• 自定义功能：扩展小爱音箱的能力
• 智能家居集成：通过语音控制智能设备
• 信息查询：查询天气、新闻等信息

💡 实用技巧与最佳实践

音乐库管理建议

1. 分类存储：

   /音乐/中文流行/周杰伦/ /音乐/英文摇滚/Coldplay/ /音乐/古典音乐/贝多芬/

2. 命名规范：

   • 使用标准中文命名
   • 避免特殊字符和空格
   • 保持文件名简洁明了

3. 定期维护：

   • 使用yt-dlp定期下载新歌曲
   • 清理重复文件
   • 备份重要配置

性能优化配置

安全注意事项

重要提醒：

1. 如果配置了公网访问，请务必开启密码登录
2. 设置复杂的密码保护你的小米账号
3. 不要在公共场所的WiFi环境下使用
4. 避免将小爱音箱绑定摄像头等敏感设备

❓ 常见问题解决方案

Q: 小爱音箱找不到设备怎么办？

解决方案：

1. 确认小米账号密码正确
2. 确保服务器和小爱音箱在同一局域网
3. 检查小爱音箱是否已绑定到小米账号
4. 重启Xiaomusic服务

Q: 某些格式的音乐无法播放？

排查步骤：

1. 在设置中开启"转换为MP3"选项
2. 启用"型号兼容模式"
3. 检查设备是否支持该格式
4. 查看日志文件排查具体错误

Q: 如何添加网络歌曲？

操作流程：

1. 对小爱音箱说"播放歌曲[歌曲名]"
2. 系统自动搜索并下载
3. 首次下载可能需要一些时间
4. 下载完成后会自动开始播放

Q: 可以同时控制多个音箱吗？

支持方案：

1. 在Web控制界面选择不同的设备
2. 通过语音指定设备名称
3. 每台音箱独立控制互不干扰

Q: 如何备份配置和音乐库？

备份方法：

1. 定期备份Docker容器的volume目录
2. 导出配置文件config.json
3. 备份音乐目录/xiaomusic_music
4. 使用项目的自动备份功能

📚 学习资源与社区支持

官方文档资源

• 配置指南：查看config-example.json文件了解所有配置选项
• API文档：访问http://你的IP:58090/docs查看完整API接口
• 问题解答：查阅docs/issues/目录下的常见问题

社区交流平台

• GitHub Issues：提交问题或功能建议
• QQ交流群：加入用户交流群获取实时帮助
• 微信群：与开发者和其他用户直接交流

扩展学习路径

• 插件开发：参考plugins/目录下的示例代码
• 前端美化：项目欢迎前端开发者贡献更好的UI界面
• 设备适配：测试新设备型号并反馈结果

🎉 开始你的智能音乐之旅

Xiaomusic不仅仅是一个工具，它是你与小爱音箱之间更智能的桥梁。通过这个项目，你可以：

1. 彻底解放双手：完全通过语音控制所有音乐播放操作
2. 个性化音乐体验：播放任何你想听的音乐，不受平台限制
3. 持续更新优化：开源社区不断改进和完善功能
4. 零成本使用：完全免费，一次配置永久享受

无论你是技术爱好者、音乐发烧友，还是普通家庭用户，Xiaomusic都能为你带来前所未有的智能音乐体验。现在就开始配置，让你的小爱音箱变得更加智能和有用！

记住，好的音乐应该随时随地、随心所欲地播放。让Xiaomusic成为你智能家居生活的完美伴侣，开启属于你的智能音乐新时代！

【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic