企业官网建设流程全解析

3步打造智能音乐中心：小爱音箱变身全能音乐管家

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

你知道吗？家里的小爱音箱除了简单的语音助手功能外，还能成为一个真正的智能音乐中心！Xiaomusic正是这样一个开源神器，它巧妙地将小爱音箱与强大的音乐管理功能结合，让你通过简单的配置就能享受无限的音乐体验。想象一下，只需动动嘴就能播放任意歌曲，还能管理自己的音乐库、创建个性化歌单——这一切，Xiaomusic都能帮你实现。

从智能音箱到音乐管家：Xiaomusic的魔法变身

为什么你需要Xiaomusic？

每天对着小爱音箱说"播放周杰伦的歌"，却只能听到有限的几首？想播放自己收藏的高品质音乐文件，却发现小爱音箱不支持？这些问题，Xiaomusic都能解决！

传统小爱音箱的三大痛点：

1. 音乐资源受限：只能播放内置音乐平台的版权歌曲
2. 格式支持有限：无法播放本地FLAC、APE等无损格式
3. 管理功能缺失：缺乏个性化的播放列表和收藏功能

Xiaomusic带来的三大革新：

1. 无限音乐资源：支持yt-dlp下载网络音乐
2. 全格式支持：MP3、FLAC、WAV、APE、OGG、M4A统统支持
3. 智能管理：Web界面+语音控制双重管理

核心亮点：不只是播放器，更是音乐生态

Xiaomusic不是一个简单的播放器，而是一个完整的音乐生态系统：

• 🎵 智能语音控制：支持20+种语音指令，从"播放歌曲"到"单曲循环"，应有尽有
• 🌐 网络歌单支持：可以导入外部歌单，甚至直接播放网络电台
• 🔌 插件系统扩展：Python插件系统让你自定义更多功能
• 📱 多端控制：Web界面、手机端、甚至微信小程序都能控制
• ⚡ 极速体验：本地缓存+智能代理，播放无延迟

快速上手：3分钟搭建你的私人音乐中心

第一步：一键部署，简单到超乎想象

最简单的方式是使用Docker，只需一条命令：

docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

小贴士：如果你是国内用户，可以使用镜像加速地址docker.hanxi.cc/hanxi/xiaomusic，速度更快！

第二步：基础配置，连接你的小爱音箱

服务启动后，打开浏览器访问http://你的IP地址:58090，你会看到简洁的配置界面：

按照指引完成以下配置：

1. 输入小米账号密码：这是控制小爱音箱的关键
2. 选择设备：从列表中选择你要控制的小爱音箱
3. 设置音乐路径：指定本地音乐存放目录

实用技巧：建议将音乐目录和配置目录分开存储，这样即使重装系统也不会丢失配置。

第三步：语音口令设置，解放双手

在配置文件中，你可以自定义语音口令。打开config-example.json文件，找到key_word_dict部分：

{ "key_word_dict": { "下一首": "play_next", "上一首": "play_prev", "单曲循环": "set_play_type_one", "全部循环": "set_play_type_all", "随机播放": "set_play_type_rnd", "播放歌曲": "play", "关机": "stop", "加入收藏": "add_to_favorites", "取消收藏": "del_from_favorites" } }

隐藏玩法：对小爱同学说"播放歌曲小猪佩奇的故事"，它会先下载相关内容再播放！

深度体验：Xiaomusic的智能音乐管理

直观的Web控制界面

Xiaomusic提供了一个功能完整的Web控制界面，让你可以轻松管理所有音乐：

主要功能区域：

• 左侧菜单：设备控制、播放列表、账号设置、系统配置
• 顶部标签：按"全部"、"所有歌曲"、"收藏"、"下载"分类浏览
• 歌曲列表：显示所有可播放的歌曲，支持搜索和筛选
• 播放控制：进度条、音量控制、播放模式切换

智能播放列表管理

播放列表的管理非常人性化，支持多层级的歌单结构：

特色功能：

• 折叠展开：点击分类项可以展开子菜单
• 快速切换：在不同歌单间一键切换
• 智能排序：按添加时间、播放次数等多种方式排序

黑胶唱片风格界面

如果你喜欢复古风格，Xiaomusic还提供了黑胶唱片风格的界面：

这个界面不仅美观，还提供了完整的播放控制功能，包括：

• 唱片旋转动画：播放时唱片会旋转
• 播放进度显示：实时显示播放进度
• 音质信息：显示当前播放的音质信息

进阶玩法：解锁Xiaomusic的隐藏功能

网络歌单配置：打造你的专属电台

Xiaomusic支持JSON格式的网络歌单，这意味着你可以：

1. 导入外部歌单：将网易云、QQ音乐的歌单导入
2. 创建电台列表：添加网络电台链接
3. 分享歌单：通过Gist或GitHub分享你的歌单

示例歌单配置：

[ { "name": "经典老歌", "musics": [ { "name": "黄昏-周传雄", "url": "self:///api/proxy/plugin-url?data=eyJpZCI6ICI3REU5QTlDRDA0MTE1N0Y2QkYzRkU5RkZCQ0YxMjBFMyIsICJ0aXRsZSI6ICJcdTllYzRcdTY2MGYiLCAiYXJ0aXN0IjogIlx1NTQ2OFx1NGYyMFx1OTZjNCIsICJhbGJ1bSI6ICJ0cmFuc2ZlciIsICJhbGJ1bV9pZCI6ICI5NjQ2MTIiLCAiYWxidW1fYXVkaW9faWQiOiAwLCAiZHVyYXRpb24iOiAzNDQsICJhcnR3b3JrIjogImh0dHA6Ly9pbWdlLmt1Z291LmNvbS9zdGRtdXNpYy8xMDgwLzIwMjAwMjEwLzIwMjAwMjEwMTEyODE1Mzk1MzEwLmpwZyIsICIzMjBoYXNoIjogIjNFOUM5NUZDRDFGNTgyRkMwMDYxQjgyOUQ0MThEN0U3IiwgInNxaGFzaCI6ICI4QzY0Nzc1QTU1QTJCRkREMDRFMjk3NTM0MDU0OUI3RiIsICJSZXNGaWxlSGFzaCI6ICJEM0UzRUJCM0IwN0U5RTM2QzQwMjZCRDFBNkU5ODc3QiIsICJwbGF0Zm9ybSI6ICJrZyIsICJzb3VyY2UiOiAicGx1Z2luIn0=", "type": "music" } ] } ]

小贴士：歌单中的type: "radio"表示电台模式，会一直播放当前电台而不切换到下一首。

插件系统：无限扩展可能

Xiaomusic内置了插件系统，位于plugins/目录下。目前支持三种插件类型：

1. 代码执行插件(code1.py)：执行自定义Python代码
2. HTTP GET插件(httpget.py)：发送HTTP GET请求
3. HTTP POST插件(httppost.py)：发送HTTP POST请求

示例插件代码：

async def code1(arg1): global log, xiaomusic log.info(f"code1:{arg1}") did = xiaomusic.get_cur_did() await xiaomusic.do_tts(did, "你好，我是自定义的测试口令")

你可以通过语音指令调用插件，比如设置"测试自定义口令"对应exec#code1("hello")。

M3U文件转换工具

如果你有M3U格式的电台文件，Xiaomusic提供了转换工具，可以将M3U文件转换为JSON歌单格式。详细用法可以参考官方文档：docs/issues/78.md

设备兼容性：支持几乎所有小爱音箱

Xiaomusic已经测试支持多种小爱音箱型号：

注意事项：部分设备如L05B、L05C、LX06、L16A不支持FLAC格式，建议开启"转换为MP3"选项。

音频格式全面支持

• 有损格式：MP3、OGG、M4A
• 无损格式：FLAC、WAV、APE
• 自动转换：不支持格式自动转换为MP3播放

创意应用场景：让音乐更智能

场景一：早晨唤醒闹钟

通过Crontab配置定时任务，让Xiaomusic在特定时间自动播放音乐：

{ "crontab_json": "0 7 * * * play 早安音乐" }

每天早上7点，小爱音箱会自动播放"早安音乐"歌单，让你在美妙的音乐中醒来。

场景二：家庭背景音乐系统

将多台小爱音箱分组，实现全屋音乐同步播放。在配置文件中设置group_list，就可以让音乐在不同房间同步播放。

场景三：儿童故事机

对小爱同学说"播放小猪佩奇的故事"，Xiaomusic会自动下载相关音频并播放，成为孩子的专属故事机。

场景四：智能家居联动

通过插件系统，你可以实现音乐与智能家居的联动。比如：

• 晚上10点自动播放助眠音乐
• 检测到有人回家时播放欢迎音乐
• 根据天气自动播放相应氛围音乐

安全配置与最佳实践

重要安全提醒

1. 密码保护：如果配置公网访问，务必开启密码登录
2. 复杂密码：设置高强度密码防止未授权访问
3. 网络隔离：避免在公共WiFi环境下使用

性能优化建议

1. 存储规划：音乐目录和配置目录分开存储
2. 缓存管理：定期清理临时文件
3. 网络优化：配置合适的代理服务器提升下载速度

故障排除指南

遇到问题时，可以按照以下步骤排查：

1. 查看日志：在Web界面点击【下载日志文件】按钮
2. 检查配置：确认账号密码和设备配置正确
3. 社区求助：访问项目Issues页面获取帮助

立即开始你的智能音乐之旅

获取项目源码

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

安装依赖并启动

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

访问API文档

启动后访问http://localhost:8090/docs查看完整的API文档，了解所有可用接口。

加入社区交流

• GitHub Issues：报告Bug和功能建议
• QQ频道：实时交流和技术讨论
• 微信群：用户互助和经验分享

结语：重新定义智能音箱的音乐体验

Xiaomusic不仅仅是一个工具，它重新定义了智能音箱的音乐体验。通过简单的配置，你的小爱音箱就能变身成为：

• 🎵 私人音乐库：管理所有本地音乐文件
• 🌐 网络音乐中心：播放任意网络音乐资源
• 🗣️ 智能语音助手：用自然语言控制音乐播放
• 🔧 可扩展平台：通过插件实现更多功能

无论你是音乐爱好者、技术极客，还是普通用户，Xiaomusic都能为你带来全新的音乐体验。现在就开始，让你的小爱音箱发挥真正的音乐潜力吧！

最后的小贴士：Xiaomusic是完全开源的项目，如果你有好的想法或功能建议，欢迎提交Pull Request或参与社区讨论。让我们一起打造更好的智能音乐体验！

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