---
title: 在线播放功能扩展说明
---

# 在线播放功能扩展说明

在原版 xiaomusic 基础上，增加了以下扩展功能：

1. **MusicFree插件支持**:（需自行获取音源） 集成 MusicFree 的 JS 插件系统，支持多种音乐源
2. **开放接口支持**:(默认启用) 支持通过TuneFree API进行音乐搜索和播放
3. **插件管理**: 提供插件启用/禁用/卸载等功能
4. **自动追加歌曲功能**:(默认未启用) 播放到歌单末尾时自动搜索并播放相同歌手的歌曲
5. **用户口令智能提取**（默认未启用）: 支持对用户语音指令的智能分析，自动提取歌名、歌手名（需用户配置AI API密钥，默认不启用）

### 调用策略
- 调用策略：
  - 配置了开放接口且启用，只调用开放接口。
  - 未配置或启用接口时，会调用MusicFree插件搜索（需导入且启用）
- 搜索结果优先级规则：
  - 【歌曲名】>【歌手名】>【插件平台权重】
  - 插件平台权重（启用插件列表中前9个插件，排名越靠前权重越高，最高9分）

## 🔧 新增功能介绍

### 🤐 新增语音口令
- 【在线播放+关键词(歌手/歌曲名组合)】，会直接调用接口或插件，搜索关键词,返回匹配后的第一个资源进行播放。比如说：【在线播放】林俊杰||江南||林俊杰+江南。
- 【歌手播放+歌手名】，会在线搜索该歌手的歌曲并创建歌单进行播放。比如说：【播放歌手：陈奕迅】。

**Tips**
需要在配置界面【允许唤醒的命令】选项中增加：`,singer_play,online_play,`

<img width="509" height="102" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/aff9a971-0f88-4ff4-8042-63cef51478b1" />


### WEB端搜索、配置
- 支持网页端搜索/播放歌曲及推送小爱音响(部分MusicFree插件获取的资源小爱音响不适用，如Bilibili插件)
- 支持网页端管理插件、接口
- 支持歌曲列表的全部推送功能

### JS插件管理
- 支持加载和管理 MusicFree JS 插件
- 提供插件导入/启用/禁用/卸载功能
- 支持插件配置文件管理

### 开放接口支持
- 集成TuneFree API接口
- 支持在线搜索和播放
- 可配置开放接口地址


## ✨高级配置

### 用户口令智能提取
- 默认不启用，需用户主动配置API密钥后方可使用
- 使用AI大模型分析用户语音指令，自动提取歌曲名和歌手名信息
- 配置后会提高搜索精确度，非必须


### 自动追加歌曲功能
- 可配置是否在播放到最后一首歌时，追加当前歌手的其他歌曲(默认未启用，仅【全部播放】模式适用）
- 默认未启用，只会根据当前歌单播放，不会自动搜索、添加歌曲

### 配置示例：

**/conf/plugins-config.json 下

```json
{
  ......
  // 启用自动添加歌曲功能
  "auto_add_song": true,

  // OpenAI 兼容 API 配置（支持阿里百炼、质谱 AI 等符合 OpenAI API 规范的大模型）
  "aiapi_info": {
    // OpenAI API 的基础 URL（默认指向阿里百炼）
    "base_url": "",
    // API 密钥
    "api_key": "API密钥",
    // 使用的模型名称（默认 qwen-flash，当前配置为 qwen-plus）
    "model": "qwen-plus",
    // 是否启用 AI 功能
    "enabled": true
  },

  ......
}
```



## 评论


### 评论 1 - hanxi

入口：

<img width="325" height="326" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/7718a251-4419-4833-909e-3d2bf8fd7c8f" />

搜索和推送到当前播放音箱：

<img width="327" height="641" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/3722a302-42f4-4c16-9754-98697f1d0dfc" />

---

### 评论 2 - gdzjy

@boluofan  建议把https://github.com/lyswhut/lx-music-mobile 的音源也兼容了吧 ，毕竟lx-music-mobile项目比MusicFree更早，有很多免费的音源。

---

### 评论 3 - boluofan

> [@boluofan](https://github.com/boluofan) 建议把https://github.com/lyswhut/lx-music-mobile 的音源也兼容了吧 ，毕竟lx-music-mobile项目比MusicFree更早，有很多免费的音源。

lxmusic的插件沙箱环境不好做，暂不打算支持。

---
[链接到 GitHub Issue](https://github.com/hanxi/xiaomusic/issues/655)