更新记录

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

安装

  1. 在插件市场点「使用 HBuilderX 导入插件」,或手动把 uni_modules/m4s-musicgen 拷进项目根目录的 uni_modules/。
  2. 确认项目 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() 演示;接入时可替换为你自己的播放器。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议