mirror of
https://github.com/hanxi/xiaomusic.git
synced 2026-03-26 09:59:45 +08:00
120 lines
4.2 KiB
Markdown
120 lines
4.2 KiB
Markdown
---
|
||
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)
|