更新记录
1.0.1(2026-11-16) 下载此版本
支持AI全网搜索,采集后可以下载原生 分离伴奏 人声等 支持离线播放和下载mp3格式
平台兼容性
uni-app(5.31)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ |
uni-app x(5.05)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| × | × | √ | × | × | × |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | √ | √ |
M4S 音乐生成 SDK(m4s-musicgen)
一句话搜歌、AI 音轨分离下载、离线播放。 插件同时提供可调用的 UTS SDK 和现成 UI 组件 / 示例页
插件本体是「前端能力 + UI」。
平台支持
| 平台 | 支持 |
|---|---|
| uni-app x(App-Android) | √ |
| 其它平台 | x |
安装
- 在插件市场点「使用 HBuilderX 导入插件」,或手动把
uni_modules/m4s-musicgen拷进项目根目录的uni_modules/。 - 确认项目
manifest.json为 uni-app x("uni-app-x": { "vapor": true })。
uni_modules 插件目录不支持
pages.json/manifest.json/App.uvue/main.ts等文件。 若要使用示例页,请把pages_init.json里的页面合并进你项目的pages.json(HBuilderX 导入时会自动提示注册)。
快速开始(SDK)
import * as mg from '@/uni_modules/m4s-musicgen'
// 1) 初始化(可只填一次,配置会持久化到本机)
mg.init({ apiBase: 'http://1.13.177.109/api', appId: 'com.your.app' })
// 2) 填授权码(体验码:testcode,输出带提示音)
mg.setLicenseCode('testscode')
const info = await mg.verifyLicense() // { valid, reason, remaining, test }
// 3) 搜歌
const list = await mg.searchSongs('告白气球', 10)
// 4) 生成(stems:original 原曲 / accomp 伴奏 / vocals 人声)
const jobId = await mg.generate({ keyword: '告白气球', bvid: '', stems: 'original' })
// 5) 等任务完成(onProgress 回调每次拿到最新状态)
await mg.waitJob(jobId, (st) => console.log(st.stage, st.progress))
// 6) 下载到本机沙盒,返回本地音轨列表
const files = await mg.downloadJob(jobId, (done, total) => console.log(done + '/' + total))
// files: [{ key, name, path, bytes }],path 可直接交给音频播放器播放
API 一览
| 方法 | 说明 |
|---|---|
init(options) |
初始化/覆盖配置,字段:apiBase / licenseCode / appId |
setApiBase(v) getApiBase() |
读写接口地址 |
setLicenseCode(v) getLicenseCode() |
读写授权码 |
setAppId(v) getAppId() |
读写应用标识(服务端可据此把授权码绑定到具体 App) |
verifyLicense(code?) |
校验授权码,返回 LicenseInfo;code 省略则校验已保存的授权码 |
searchSongs(keyword, limit?) |
搜索候选歌曲,返回 SearchItem[] |
generate(options) |
提交生成任务,返回 jobId;授权码无效/额度用尽会抛异常 |
jobStatus(jobId) |
查询任务状态 JobState |
jobTracks(jobId) |
查询任务可下载音轨 TrackRef[] |
waitJob(jobId, onProgress?, intervalMs?) |
轮询到任务完成,失败 reject |
sandboxDir() |
本机沙盒下载目录(不存在自动创建) |
downloadTrack(url, fileName?) |
下载单个音频到沙盒,返回本地路径 |
downloadJob(jobId, onProgress?) |
下载任务全部音轨,返回 LocalTrack[] |
removeLocalFile(path) |
删除沙盒里的一个文件 |
错误码见 utssdk/unierror.uts。
组件
m4s-license:授权码输入 + 一键校验面板(easycom,直接<m4s-license />使用)。
示例页
pages/musicgen/musicgen.uvue:演示「授权 → 搜索 → 生成 → 下载 → 播放(长按删除本机文件)」。
注意事项
- 插件只做技术交流,请勿用于商用,如需要商用,请获取相应曲所有者授权。
- 若需要后台/锁屏续播,宿主 App 请在
manifest.json配置后台音频权限(本插件不代为配置)。 - 插件内不包含播放器 UI,示例页用
uni.createInnerAudioContext()演示;接入时可替换为你自己的播放器。

收藏人数:
下载插件并导入HBuilder
下载示例项目ZIP
赞赏(0)
下载 4181
赞赏 0
下载 12768266
赞赏 1959
赞赏
京公网安备:11010802035340号