当前位置：首页 > news >正文

10分钟搞定：小爱音箱语音音乐播放终极指南

news 2026/5/5 10:53:00

10分钟搞定：小爱音箱语音音乐播放终极指南

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

想让你的小爱音箱播放任何你想听的歌曲吗？无论是本地收藏还是网络音乐，Xiaomusic都能帮你实现。这个开源项目让你通过简单的语音指令控制小爱音箱播放音乐，彻底解放双手，打造专属的智能音乐体验。在接下来的10分钟里，你将学会如何轻松配置这个强大的工具，让小爱音箱变身你的私人音乐管家。

🎵 为什么你需要Xiaomusic？

小爱音箱内置的音乐服务总有各种限制，但有了Xiaomusic，一切都变得不同。这个项目解决了三个核心痛点：

音乐来源限制：不再受限于内置音乐平台，可以播放本地存储的任何音频文件
语音控制局限：扩展了小爱音箱的语音指令，支持更多个性化命令
网络歌曲下载：只需说出歌名，系统自动从网络搜索并下载播放

小爱音箱音乐播放器界面

🚀 快速安装：三种方式任你选

方式一：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，服务就启动了！访问http://你的IP:58090即可进入控制界面。

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

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

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

方式三：源码运行（完全掌控）

从仓库克隆代码后直接运行：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py

🎤 语音指令大全：让小爱音箱听懂你

Xiaomusic最强大的功能就是语音控制。以下是你需要掌握的核心指令：

基础播放控制

播放歌曲：直接说出"播放歌曲周杰伦晴天"
播放控制：说"上一首"、"下一首"、"暂停播放"
停止播放：说"关机"或"停止播放"

播放模式切换

单曲循环：重复播放当前歌曲
全部循环：循环播放所有歌曲
随机播放：随机顺序播放

歌单管理

播放歌单：说"播放歌单我的收藏"
播放指定歌单：说"播放歌单第几个列表名"

隐藏功能

对小爱同学说"播放歌曲小猪佩奇的故事"，系统会自动下载并播放，这个功能对于儿童内容特别有用！

音乐播放器操作指南

⚙️ 核心配置详解

配置文件位于config-example.json，以下是最关键的几个配置项：

账号配置

{ "account": "你的小米账号", "password": "你的密码", "mi_did": "设备ID（首次运行后自动获取）" }

路径配置

music_path：本地音乐存放目录
download_path：网络下载音乐存放目录
temp_path：临时文件目录

网络配置

hostname：服务器IP地址
port：服务端口（默认8090）
public_port：对外访问端口（默认58090）

📱 设备兼容性：你的音箱支持吗？

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

型号	设备名称
L06A	小爱音箱
L07A	Redmi小爱音箱 Play
S12/S12A	小米AI音箱
LX05	小爱音箱Play（2019款）
L16A	Xiaomi Sound
L17A	Xiaomi Sound Pro
LX06	小爱音箱Pro
LX01	小爱音箱mini