一句话让小爱音箱放歌XiaoMusic 语音播放音乐部署全攻略【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic晚上十点半我拖着加完班的自己推开家门顺手把包扔在沙发上。此刻最想做的事只有一件听歌。可一想到还得掏手机、解锁、打开 App、搜歌名、连蓝牙、点播放……那点听歌的兴致瞬间就没了一半。要是能只说一句话歌就自己响起来就好了。这个念头很快变成了现实靠的是开源项目XiaoMusic。它把小爱音箱改造成一个声控点歌台你说播放周杰伦的晴天它就去找歌、放歌你说下一首单曲循环停止播放它也照做。本地攒的无损音乐能播在线资源也能播MP3、FLAC、WAV、APE、M4A 这些常见格式基本都接得住而且全程用 Docker 部署新手也花不了几分钟。装好之后的管理页面长这样左侧管设备中间看歌曲列表底部是播放控制功能一眼就能认全先说明一下这篇不是功能说明书而是按我自己的上手顺序写的——先把服务跑起来再一步步验证、玩透。跟着这个顺序走每一步都落实了基本就成了。别急着研究原理一条命令先让服务跑起来我最初也以为这种项目得先搞明白协议、鉴权、API 之类的东西结果发现完全不必。只要机器上有 Docker或者 NAS 开了容器功能一条命令就能启动docker run -d --name xiaomusic \ -p 8090:8090 \ -v /你的音乐目录:/app/music \ -v /你的配置目录:/app/conf \ docker.hanxi.cc/hanxi/xiaomusic这条命令的作用一句话就能说清把容器跑起来把网页端口映射出来再把你的音乐文件夹和配置文件夹挂载进去。习惯用 docker-compose 的话效果一样无非是把这些参数写进 yml 文件。启动之后先做一件事浏览器里打开http://你的设备IP:8090。看到管理页面就说明服务活了。小提示国内网络环境建议选国内镜像拉取速度稳很多万一拉不下来也别慌文末速查表里有解法。第一次用语音点歌的完整三步服务跑起来只是开始真正让它认主要三步缺一不可。绑定小米账号在设置页填上小米账号和密码这是音箱背后的身份凭证XiaoMusic 要靠它去对接设备。让它发现你的音箱保存配置后系统会拉取账号下的小米设备列表勾选自己那台小爱音箱再保存一次。开口点歌直接对音箱说小爱同学播放……XiaoMusic 就会在音乐库里找歌并推送播放。我第一次成功时其实将信将疑——说完播放晴天音箱安静了两秒然后前奏响起来的那一刻还真有点成就感。而且不只是点歌下一首暂停停止播放这些日常指令也都通用了。歌曲列表页把本地歌和在线歌放在一起顶部标签能按收藏下载快速筛选换个角度理解它到底在中间干了什么看到东西跑起来之后我们再来补补课。这次不用术语用两个角色就能讲明白。你可以把 XiaoMusic 想象成一位翻译官加跑腿小哥。小爱同学是小米家的只听得懂小米生态里的话术而你的音乐库是私人的散落在电脑或 NAS 的文件夹里。两边语言不通、互不认识XiaoMusic 就站在中间当翻译你对着音箱说播放周杰伦的晴天这句语音先被小爱音箱转成文字XiaoMusic 拿到文字拆出歌手名和歌名去本地目录或在线资源里找匹配的歌曲找到之后它再以小米能接受的方式把播放地址推给小爱音箱。一来一回就成了你听到的那句好的为你播放……。至于音乐是硬盘里的 FLAC还是从网上现找的对音箱来说没区别——它只负责出声。想深挖实现细节的话音乐库的扫描逻辑在 xiaomusic/music_library.py设备对接在 xiaomusic/device_manager.py感兴趣可以翻着看。玩出花样几个值得立刻试的进阶玩法基础玩法通了就能按自己的习惯调教它了。下面几个是我试下来觉得最实用的。① 自定义语音关键词。默认指令词像播放本地歌曲播放列表觉得不顺手就去设置里改成自己喜欢的说法比如把停止播放换成别唱了。指令习惯因人而异能改才叫好用。② 歌单管理。本地按文件夹整理音乐一个文件夹就是一个歌单也支持 JSON 格式的网络歌单别人分享的歌单复制过来就能用。播放歌单流行音乐播放歌单第3个这类带定位的指令它也听得懂。歌单支持折叠展开歌曲分类多的时候界面也不会看得眼花③ 定时任务。项目自带定时模块 xiaomusic/crontab.py可以设定时播放。比如工作日早上七点让音箱用音乐叫你起床或者睡前放半小时助眠曲都安排得上。④ 多设备切换。家里如果不止一台小爱音箱管理页面随时切换目标设备让音乐跟着你从一个房间走到另一个房间。⑤ 收藏功能。听到一半觉得这首不错说一句加入收藏它就进了收藏列表下次直接点。常见问题速查表哪一步卡住了先对照下面这张表现象常见原因解决办法网页打不开端口映射不对或防火墙拦截确认 8090 端口没被占用检查防火墙放行音箱不响应指令账号密码有误或没勾选设备核对小米账号确认设备列表里已勾选能搜到歌但放不了音箱型号较旧音频格式不兼容在设置里打开转换为 MP3选项本地歌曲找不到音乐目录没挂对或权限不足检查 Docker 挂载路径确认容器可读拉镜像特别慢网络原因换国内镜像源再拉一次实在解决不了还有一个笨但有效的办法docker logs xiaomusic看容器日志报错信息一般就写在里面照着提示搜一搜基本有答案。别忘了这两件事安全与生态关于安全只有一句建议尽量只在家庭局域网里用。它需要你的小米账号才能工作如果非要暴露到公网务必开启 HTTP 认证、设置足够复杂的密码并定期备份配置目录。再说点好玩的这个项目的生态比想象中丰富。它带插件机制扩展玩法都集中在 plugins/ 目录想给音箱加点新技能可以来这里找灵感除了官方 Web 界面社区还做了微信小程序、手机 App、电视端等不同入口老人孩子扫码就能点歌门槛很低。尾声让音箱真正活起来说到底XiaoMusic 解决的不只是怎么放歌而是想听歌这件事能有多省事。从掏手机点五下到开口说一句话差的不是技术而是一种更顺手的日常。如果你想试试接下来的动作很简单拿到代码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic按上面的步骤把服务跑起来放进你的音乐库绑定音箱说出第一句点歌指令享受前奏响起的那一刻。用着顺手也好踩了坑也好都欢迎反馈给社区——开源项目就是靠大家的真实体验一点点变好的。希望这台小音箱能成为你家里那个随时待命的点歌台。传统与科技并不冲突黑胶的仪式感也能装进一句语音指令里【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考