如何让小爱音箱变身智能音乐中心：3步配置指南

如何让小爱音箱变身智能音乐中心：3步配置指南

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

想让你的小爱音箱不再只是简单的语音助手，而是变成功能强大的智能音乐中心吗？今天我要为你介绍一款神奇的开源工具——小爱音箱音乐服务（xiaomusic），它能让你的小爱音箱播放本地音乐、在线歌曲，还能通过语音命令控制播放！这个工具使用yt-dlp下载音乐，支持多种音频格式，让你的小爱音箱瞬间升级为专业的音乐播放器。无论你是技术新手还是资深玩家，跟着我的指南，3步就能完成配置！

🎵 为什么需要小爱音箱音乐服务？

想象一下这样的场景：你刚下班回到家，想听点轻松的音乐放松一下。你对着小爱音箱说"播放周杰伦的晴天"，但音箱却回答"抱歉，这首歌需要开通会员"。或者你想播放自己收藏的本地音乐，却发现小爱音箱根本不支持。这种体验是不是很让人沮丧？

这正是小爱音箱音乐服务要解决的问题！它让你的小爱音箱能够：

• 🎧 播放本地音乐文件（mp3、flac、wav等多种格式）
• 🌐 在线搜索并播放歌曲
• 🗣️ 通过语音命令控制播放（上一首、下一首、单曲循环等）
• 📱 通过网页界面远程控制
• 🎼 创建和管理个性化歌单

🚀 3步快速配置指南

第一步：准备工作与环境检查

在开始配置之前，确保你满足以下条件：

如果你不确定自己的小爱音箱型号是否支持，可以查看官方文档：docs/issues/中的设备支持列表。

第二步：选择最适合你的安装方式

小爱音箱音乐服务提供了多种安装方式，你可以根据自己的技术水平和需求选择：

方式一：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命令，服务就会自动启动！

方式二：Pip安装（适合Python开发者）

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

# 安装xiaomusic pip install -U xiaomusic # 启动服务 xiaomusic --config config.json

方式三：源码运行（适合开发者）

如果你想要定制功能或参与开发：

# 下载依赖 ./install_dependencies.sh # 安装环境 pdm install # 启动服务 pdm run xiaomusic.py

第三步：关键配置与设备绑定

这是最重要的一步！配置成功后，你的小爱音箱才能真正播放音乐。

1. 获取设备DID

• 打开小米音箱App
• 进入设备详情页面
• 找到"设备ID"或"DID"字段并记录下来

2. 配置DID（三种方法任选其一）

方法A：网页控制台配置（最简单）

1. 启动服务后访问http://你的IP:58090
2. 在左侧导航栏找到"小爱设备控制"
3. 点击"设备管理"，选择你的小爱音箱
4. 点击"绑定设备"完成配置

方法B：配置文件配置（最稳定）

1. 复制config-example.json为config.json
2. 编辑配置文件，在"mi_did"字段填入你的设备DID
3. 保存文件后重启服务

方法C：环境变量配置（最灵活）

# Linux/Mac系统 export MI_DID=你的设备ID # Windows系统 set MI_DID=你的设备ID

🔧 常见问题与解决方案

Q1: 服务启动后无法访问网页控制台怎么办？

可能原因：端口被占用或防火墙阻止解决方案：

1. 检查端口58090是否被其他程序占用
2. 确认防火墙允许该端口访问
3. 尝试修改docker-compose.yml中的端口映射

Q2: 小爱音箱无法识别语音命令怎么办？

可能原因：DID配置错误或网络问题解决方案：

1. 重新检查DID配置是否正确
2. 确保小爱音箱和运行服务的设备在同一局域网
3. 重启小爱音箱和服务

Q3: 无法播放某些音乐格式怎么办？

可能原因：设备型号不支持某些格式解决方案：

1. 在设置中开启"转换为MP3"选项
2. 开启"型号兼容模式"
3. 或者将音乐文件转换为支持的格式（mp3、flac、wav、ape、ogg、m4a）

Q4: 如何添加自定义语音命令？

解决方案： 编辑配置文件中的"key_word_dict"部分，添加你的自定义命令：

"key_word_dict": { "播放我的最爱": "play_favorites", "来点轻音乐": "play_genre_light" }

💡 进阶技巧与优化建议

技巧一：创建个性化歌单

小爱音箱音乐服务支持网络歌单功能，你可以：

1. 创建JSON格式的歌单文件
2. 配置"music_list_json"指向你的歌单文件
3. 通过语音命令"播放歌单[名称]"来播放

技巧二：定时播放功能

利用crontab功能，你可以设置定时任务：

• 每天早上7点自动播放起床音乐
• 晚上10点自动播放助眠音乐
• 周末自动播放休闲歌单

技巧三：多设备管理

如果你有多个小爱音箱，可以：

1. 在配置文件中配置多个设备
2. 通过网页控制台切换当前播放设备
3. 为不同房间的音箱设置不同的播放列表

技巧四：音乐下载管理

服务会自动下载你点播的歌曲，你可以：

• 设置下载路径和缓存目录
• 控制下载质量
• 管理已下载的音乐文件

🎯 最佳实践与使用场景

家庭音乐中心

将小爱音箱音乐服务部署在家里的NAS或树莓派上，全家人都可以通过语音控制音乐播放。早上播放新闻，晚上播放轻音乐，周末播放家庭聚会歌单。

个人音乐库管理

如果你有大量的本地音乐文件，可以通过这个服务统一管理。支持多种格式，还能自动整理歌单，让你的音乐收藏更有条理。

智能场景联动

结合其他智能家居设备，创建丰富的场景：

• 回家自动播放欢迎音乐
• 用餐时间播放背景音乐
• 睡觉前播放助眠音乐
• 运动时播放动感音乐

儿童教育工具

为孩子创建专属的音乐学习环境：

• 播放儿歌和故事
• 设置定时播放学习内容
• 控制播放时间和内容

📚 资源与支持

官方文档与社区

• 项目源码：xiaomusic/
• 插件功能：plugins/
• 问题反馈：docs/issues/

第三方主题与扩展

项目社区提供了多种主题和扩展：

• Pure主题：简洁现代的设计
• 移动端播放器：手机端控制界面
• Tailwind主题：响应式设计
• SoundScape主题：沉浸式体验

配套应用

• 微信小程序：卯卯音乐
• 手机APP：风花雪乐、HMusic
• 安卓TV应用：肉肉音乐TV

🌟 开始你的音乐之旅吧！

现在你已经掌握了小爱音箱音乐服务的完整配置和使用方法。无论你是想为家庭打造智能音乐中心，还是想更好地管理个人音乐收藏，这个工具都能满足你的需求。

记住，技术是为了让生活更美好。不要被复杂的配置吓倒，跟着我的步骤一步一步来，你很快就能享受到智能音乐带来的便利和乐趣。

如果你在配置过程中遇到任何问题，记得查看官方文档和社区讨论。开源项目的魅力就在于大家互相帮助，共同成长。祝你配置顺利，享受音乐！

小贴士：配置完成后，先从小爱音箱音乐服务播放几首简单的歌曲测试一下。成功播放后，再尝试更复杂的功能。循序渐进，你会越来越熟练！

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