更新记录

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 语音填空 语音 看歌词提示,唱出空缺的那一句

快速使用

  1. 复制 uni_modules/dlcx-guess-song 到你的工程(插件市场安装后自动就位)。
  2. 在页面 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>
  1. manifest.json 中为 Android 申请录音权限(语音玩法需要):
"app-android": {
  "permissions": [
    "<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
    "<uses-permission android:name=\"android.permission.INTERNET\"/>"
  ]
}
  1. 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 后重新打开即可,文件内容无需修改。

隐私、权限声明

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

无

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

无

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

无

暂无用户评论。