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

5分钟掌握Xiaomusic：让小爱音箱变身智能音乐播放器的终极指南

news 2026/5/4 23:23:20

5分钟掌握Xiaomusic：让小爱音箱变身智能音乐播放器的终极指南

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

你是否厌倦了小爱音箱只能播放内置音乐平台的限制？想要让家中的小爱音箱播放任意你喜欢的歌曲吗？Xiaomusic是一个开源智能音乐播放器项目，通过自定义语音命令和插件系统，让你的小爱音箱瞬间变身全能音乐播放器。这个项目支持多种小爱音箱型号，可以播放本地音乐、下载在线歌曲，甚至通过语音口令控制播放列表，完全解放你的音乐播放体验。

🎯 Xiaomusic的核心优势：为什么选择它？

Xiaomusic最大的亮点在于它打破了小爱音箱原有的音乐播放限制。传统的小爱音箱只能播放内置平台的音乐，而Xiaomusic通过智能插件系统和自定义语音命令，让你可以：

播放任意歌曲：不再受限于特定音乐平台
本地音乐库管理：支持MP3、FLAC、WAV等多种音频格式
智能语音控制：通过简单口令控制播放、暂停、切歌等操作
插件扩展功能：自定义语音命令实现个性化功能

从上图可以看到，Xiaomusic提供了完整的音乐播放界面，支持播放控制、进度条显示、音量调节等功能，操作直观简单。

🚀 快速安装配置：5分钟上手体验

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://你的NAS_IP:58090就能看到Web控制界面。

手动安装步骤

如果你更喜欢手动安装，也可以通过Git克隆项目：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic pip install -U xiaomusic

安装完成后，运行xiaomusic命令即可启动服务，默认监听端口8090。

🎵 基础功能详解：语音控制全解析

基础播放控制

Xiaomusic支持丰富的语音口令，让你的音乐播放体验更加自然：

播放歌曲：播放本地音乐库中的歌曲
播放歌曲+歌名：例如"播放歌曲周杰伦晴天"
上一首/下一首：切换当前播放的歌曲
关机/停止播放：停止音乐播放

播放模式选择

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

歌单管理功能

播放歌单+目录名：例如"播放歌单经典老歌"
播放歌单收藏：播放你的收藏歌单
加入收藏：将当前歌曲加入收藏
取消收藏：从收藏中移除当前歌曲

这个极简风格的播放列表界面展示了Xiaomusic的歌曲管理功能，支持按分类浏览所有歌曲，操作简单直观。

🔧 高级功能：插件系统与自定义命令

自定义语音命令配置

Xiaomusic最强大的功能之一就是支持自定义语音命令。在配置文件中，你可以这样设置：

{ "user_key_word_dict": { "播放我的最爱": "exec#play_favorites()", "查询天气": "exec#check_weather()", "开启晚安模式": "exec#goodnight_mode()" } }

插件开发入门

在plugins目录下创建Python插件文件，比如创建一个简单的问候插件：

async def custom_greeting(arg1): global log, xiaomusic log.info(f"收到问候命令: {arg1}") device_id = xiaomusic.get_cur_did() await xiaomusic.do_tts(device_id, "你好，主人！今天想听什么音乐呢？")

插件开发遵循简单的规则：函数名与文件名相同，支持异步操作，可以调用Xiaomusic的所有API功能。

🎨 实战案例：创建个性化音乐场景

场景一：晨间唤醒音乐

你可以创建一个"早上好"的语音命令，让小爱音箱在早晨自动播放轻快的音乐：

async def morning_music(arg1): global log, xiaomusic device_id = xiaomusic.get_cur_did() await xiaomusic.do_tts(device_id, "早上好！为您播放晨间音乐") # 播放特定的晨间歌单 await xiaomusic.play_playlist("morning", device_id)

场景二：学习专注模式

创建一个"开始学习"的命令，播放白噪音或专注音乐：

async def study_mode(arg1): global log, xiaomusic device_id = xiaomusic.get_cur_did() await xiaomusic.do_tts(device_id, "学习时间到，为您播放专注音乐") # 切换到学习专用歌单 await xiaomusic.set_volume(30, device_id) # 设置合适音量 await xiaomusic.play_playlist("study_focus", device_id)

这个复古的黑胶唱片图标代表了Xiaomusic对音乐品质的追求，也象征着项目对传统音乐播放体验的现代化改造。