XiaoMusic完整使用指南：如何让小爱音箱变身全能音乐播放器

XiaoMusic是一个创新的开源项目，它能够将你的小爱音箱变成功能强大的本地音乐播放器。通过集成yt-dlp下载工具，XiaoMusic不仅支持播放本地音乐文件，还能自动下载网络音乐资源，为你的智能家居生活增添更多音乐乐趣。

项目核心功能概述

XiaoMusic的核心价值在于它完美结合了小爱音箱的语音控制优势与本地音乐播放的灵活性。无论你是音乐爱好者还是智能家居用户，这个项目都能为你带来全新的音乐体验。

主要特色功能

• 语音口令控制：通过简单口令即可播放音乐、切换歌曲、调节音量
• 自动音乐下载：使用yt-dlp从网络获取音乐资源
• 多设备支持：兼容各种型号的小爱音箱设备
• 多种音乐格式：支持mp3、flac、wav、ape、ogg、m4a等主流格式
• 网络歌单功能：支持JSON格式歌单和M3U文件转换

快速部署指南

Docker部署方式

对于大多数用户来说，Docker是最简单快捷的部署方式。以下是推荐的配置：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - /xiaomusic_music:/app/music
      - /xiaomusic_conf:/app/conf

配置说明

• 音乐目录：/xiaomusic_music用于存放音乐文件
• 配置目录：/xiaomusic_conf用于存放配置文件
• 访问地址：http://你的NAS_IP:58090

语音口令功能详解

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

基础播放控制

• "播放歌曲" - 播放本地歌曲
• "播放歌曲+歌名" - 如"播放歌曲周杰伦晴天"
• "上一首"、"下一首" - 歌曲切换
• "单曲循环"、"全部循环"、"随机播放" - 播放模式切换

高级功能口令

• "刷新列表" - 更新音乐库
• "加入收藏" - 收藏当前歌曲
• "搜索播放+关键词" - 智能搜索并播放

设备兼容性说明

XiaoMusic已经测试支持多种小爱音箱型号，包括：

型号	设备名称
L06A	小爱音箱
L07A	Redmi小爱音箱 Play
S12/S12A	小米AI音箱
LX5A	小爱音箱万能遥控版

常见问题解决方案

配置问题处理

在升级版本后如果遇到UI无法访问的问题，可以尝试以下操作：

1. 删除旧的setting.json配置文件
2. 重新启动XiaoMusic服务
3. 系统会自动生成新的配置文件

音乐格式兼容性

• 大部分设备支持mp3、wav、ogg、m4a格式
• 部分设备如L05B、L05C、LX06、L16A不支持flac格式
• 遇到格式不兼容时可开启"转换为MP3"选项

安全使用建议

为了确保你的账号安全，请遵循以下建议：

1. 公网访问必设密码：如果配置公网访问，务必开启密码登录并设置复杂密码
2. 避免公共WiFi：不要在公共场所的WiFi环境下使用
3. 账号分离：不建议将绑定摄像头的小米账号用于XiaoMusic

进阶功能探索

自定义口令功能

通过项目的高级配置，你可以自定义专属的语音口令，让音乐控制更加个性化。

网络歌单配置

XiaoMusic支持网络歌单功能，你可以：

• 配置JSON格式的歌单
• 使用M3U文件转换工具
• 分享和使用他人制作的歌单

技术架构解析

XiaoMusic采用了现代化的技术栈：

• 后端：Python语言，FastAPI框架
• 前端：多种主题可选（jQuery、Pure、Tailwind等）
• 容器化：Docker部署，支持NAS环境

使用场景示例

家庭音乐中心

将XiaoMusic部署在家庭NAS上，配合多个小爱音箱设备，打造全屋音乐系统。

个人音乐库管理

利用自动下载功能，构建个性化的音乐收藏库。

维护与更新

项目持续更新，建议定期检查新版本以获取最新功能。更新前请备份重要配置，避免数据丢失。

通过本指南，相信你已经对XiaoMusic有了全面的了解。这个项目不仅功能强大，而且部署简单，是提升小爱音箱使用体验的理想选择。