更新记录
1.0.0(2026-11-18)
- 首个版本:
dlcx-guess-song 猜歌组件。
- 支持 5 种玩法:人声猜歌 / 原曲猜歌 / 伴奏猜歌 / 歌词填空 / 语音填空。
- 支持计时判题、连击计分、生命值与复活(广告/分享/积分三渠道)。
- 曲库与音频走云端接口按授权拉取,不含音频进包。
- 授权校验:
appKey + appId + 设备指纹 经 POST /plugin/license 换取会话 token。
- 对局页顶部自动避让系统状态栏。
平台兼容性
uni-app(5.21)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
uni-app x(5.21)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| - |
- |
- |
- |
- |
- |
其他
| 多语言 |
暗黑模式 |
宽屏模式 |
蒸汽模式 |
| × |
× |
× |
√ |
都来挑战·猜歌组件(dlcx-guess-song)
开箱即用的「听歌猜歌」玩法组件。核心是曲库:组件本身不含任何音频文件,题目与音频全部通过云端曲库接口按授权动态拉取,宿主只需要配置 baseUrl 与 appkey 即可上线。
- 支持平台:
uni-app x 原生 App(Android / iOS / HarmonyOS)
- 适配版本:HBuilderX 4.71+
支持的玩法
| mode |
名称 |
作答形式 |
说明 |
vocal |
人声猜歌 |
填空 |
听清唱片段,写出歌名 |
original |
原曲猜歌 |
填空 |
听原曲片段,写出歌名 |
intro |
伴奏猜歌 |
选择 |
只听伴奏,选出正确歌名 |
lyric |
歌词填空 |
选字 |
补全歌词里被挖掉的那个字 |
voice |
语音填空 |
语音 |
看歌词提示,唱出空缺的那一句 |
快速使用
- 复制
uni_modules/dlcx-guess-song 到你的工程(插件市场安装后自动就位)。
- 在页面
template 中直接使用组件(uni_modules 组件自带 easycom,无需手动注册):
<template>
<dlcx-guess-song
base-url="https://bgyx06.haoleen.com/api"
app-key="你的授权appkey"
scene="practice"
mode="vocal"
:level="1"
:size="8"
@ready="onReady"
@finish="onFinish"
@exit="onExit"
@error="onError"
/>
</template>
manifest.json 中为 Android 申请录音权限(语音玩法需要):
"app-android": {
"permissions": [
"<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
"<uses-permission android:name=\"android.permission.INTERNET\"/>"
]
}
- iOS 需在
manifest.json → app-ios 配置麦克风用途说明(语音玩法需要),否则系统会拒绝录音:
"app-ios": {
"privacyDescription": {
"NSMicrophoneUsageDescription": "用于语音猜歌玩法录制你的歌声进行识别"
}
}
组件属性(Props)
| 名称 |
类型 |
默认值 |
说明 |
| baseUrl |
String |
https://bgyx06.haoleen.com/api |
曲库接口根地址 |
| appKey |
String |
'' |
插件授权 appkey(付费授权,见下) |
| appId |
String |
'' |
宿主 App 的 DCloud appid(用于授权绑定,可选) |
| scene |
String |
practice |
practice 练歌房 / challenge 混合挑战 |
| mode |
String |
vocal |
单玩法 id;scene=challenge 时忽略并使用混合 |
| level |
Number |
1 |
难度 1/2/3 |
| size |
Number |
8 |
单局题量 |
| autoStart |
Boolean |
true |
挂载后自动开局 |
组件事件(Events)
| 事件 |
参数 |
说明 |
| ready |
{ total } |
题库加载成功 |
| finish |
{ scene, correct, total, score, bestCombo, revives, dead } |
本局结束,宿主据此结算积分 |
| exit |
- |
用户点击返回,宿主应做返回处理 |
| error |
{ ok:false, msg } |
授权/网络失败 |
| revive |
channel |
复活渠道(ad/share/points),宿主可在此接入自己的广告/分享 SDK |
授权与付费
- 组件启动时携带
appKey + appId + 设备指纹 调用曲库服务的 POST {baseUrl}/plugin/license 换取会话 token(默认有效期 24 小时),校验通过后才拉取本局题目。
appKey 留空时进入「演示模式」,直接放行,便于本地联调。
- 购买后,服务方会按你的
appid 下发专属 appkey;把它填入组件的 app-key 即可。appkey 与 appid、设备指纹绑定,请勿在多个无关 App 间混用。
- 授权状态、会话有效期均由服务端统一管理,续期与失效无需前端处理。
目录结构
uni_modules/dlcx-guess-song/
├── package.json # 插件清单(含市场售价)
├── readme.md
├── changelog.md
├── components/
│ └── dlcx-guess-song/
│ └── dlcx-guess-song.uvue # 主组件(对局 UI 与逻辑)
└── utssdk/
├── interface.uts # 类型定义
└── index.uts # 跨平台实现:常量/判题/网络/授权/音频/录音
对接的曲库接口
组件按授权向曲库服务请求以下接口(baseUrl 为根地址,默认 https://bgyx06.haoleen.com/api):
| 方法 |
路径 |
说明 |
| POST |
/plugin/license |
授权校验:appkey + appId + device → { ok, token, expire } |
| GET |
/round?mode=&level=&size= |
抽一局题:返回 { ok, questions[] } |
| GET |
/config |
玩法开关与参数 |
| GET |
/audio/<file> |
音频流式托管(支持 Range) |
| POST |
/voice/asr |
语音识别:录音 base64 → 文本 |
| POST |
/voice/check |
语音判题:与目标歌词比对 |
| POST |
/life/buy |
积分兑换生命 |
| POST |
/round/finish |
上报本局结果 |
题目项(questions[])字段:id / mode / audio / answer,选择题与选字题额外带 options[](answer 为正确项下标),语音题带 lyric。
常见问题
- 组件不显示:本组件仅支持
uni-app x 原生 App(Android/iOS/Harmony),不支持普通 vue2/vue3 项目与小程序;请确认工程已开启 uni-app x。
- 一直停在「正在准备曲库…」:多为网络或
baseUrl 不可达,请核对根地址、域名白名单与服务器状态。
- 提示授权失败:
appKey 与服务的 PLUGIN_APPKEYS 不匹配,或 appid / 设备指纹未绑定。
- 没有声音:检查
audio/<file> 是否可访问(浏览器直接打开该地址应能播放),以及设备是否静音。
- 源码里中文/emoji 显示乱码:文件本身为 UTF-8 编码,若编辑器按 GBK 打开会出现乱码。请在编辑器(如 HBuilderX 右下角)把文件编码切换为 UTF-8 后重新打开即可,文件内容无需修改。