更新记录

1.0.1(2026-11-20) 下载此版本

实现歌曲采集后的伴奏 人声 剪切处理,并支持消词后的乐器处理(类似开门大吉)


平台兼容性

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

都来挑战 · 猜歌 App(前端工程)

「听一段,猜一首」的音乐猜歌 App 前端工程,基于 uni-app x,使用原生组件 dlcx-guess-song 猜歌组件 承载全部玩法。题目与音频均通过云端曲库服务按授权动态获取,前端不含任何音频文件。

  • 应用名称:都来挑战
  • 应用 appid:__UNI__DD5D677
  • 支持平台:App-Android / App-iOS / App-HarmonyOS
  • 开发工具:HBuilderX 4.71 及以上

功能概览

玩法 说明 作答形式
人声猜歌 听清唱片段,写出歌名 填空
原曲猜歌 听原曲片段,写出歌名 填空
伴奏猜歌 只听伴奏,选出正确歌名 选择
歌词填空 补全歌词里被挖掉的那个字 选字
语音填空 看歌词提示,唱出空缺的那一句 语音
随机 随机抽取以上任一玩法 —

单局含计时、连击计分、生命值与复活(广告 / 分享 / 积分三种渠道,渠道由宿主自行接入)。

环境要求

  • HBuilderX 4.71+(必须使用 uni-app x 版本)
  • 运行到真机或自定义基座(语音玩法需真机麦克风)
  • 可访问曲库服务根地址(默认 https://bgyx06.haoleen.com/api)

目录结构

musicuts/
├── App.uvue                     # 应用入口(启动/前后台/返回退出逻辑)
├── main.ts
├── pages.json                   # 页面路由与全局样式(3 个页面)
├── manifest.json                # 应用配置、appid、权限
├── uni.scss
├── static/                      # 静态资源(logo 等)
├── pages/
│   ├── index/index.uvue         # 首页:玩法与难度选择
│   ├── quiz/quiz.uvue           # 答题页:承载猜歌组件
│   └── result/result.uvue       # 结算页:本局得分/答对/连击
└── uni_modules/
    └── dlcx-guess-song/         # 猜歌组件(核心插件)

运行与调试

  1. 用 HBuilderX 打开本目录(musicuts)。
  2. 连接真机或启动模拟器。
  3. 依次点击「运行 → 运行到手机或模拟器 → 运行到 Android App 基座 / iOS App 基座」。
  4. 首次运行需允许麦克风权限(语音玩法使用)。

授权配置(关键)

答题页 pages/quiz/quiz.uvue 中向组件注入三项配置:

const baseUrl = ref('https://bgyx06.haoleen.com/api') // 曲库服务根地址
const appKey = ref('')                                // 服务方下发的 appkey;留空为演示模式
const appId = ref('__UNI__DD5D677')                   // 与 manifest.json 的 appid 一致
  • appKey 留空时组件进入「演示模式」,直接放行,可用于本地联调。
  • 正式上线前,把服务方按你的 appid 下发的 appkey 填入 appKey。
  • 组件启动时会先用 appKey + appId + 设备指纹 换取会话 token,校验通过后才拉题。

权限配置

Android(manifest.json → app-android.permissions)已声明:

"<uses-permission android:name=\"android.permission.INTERNET\"/>",
"<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>"

iOS(manifest.json → app-ios)如需语音玩法,请补充麦克风用途说明:

"privacyDescription": {
  "NSMicrophoneUsageDescription": "用于语音猜歌玩法录制你的歌声进行识别"
}

打包发布

  1. manifest.json 中完善应用图标、启动图、版本号。
  2. HBuilderX 菜单「发行 → 原生 App-云打包」,选择 Android / iOS 证书后打包。
  3. 打包前确认 appKey 已按正式 appid 配置。

与曲库服务的关系

本工程为前端,不含后端与音频资源。题目、音频、语音识别、授权校验均由曲库服务提供;服务地址与服务能力由服务方统一维护。更换服务地址只需修改 baseUrl(组件已按相对路径拼接全部接口)。

组件对接的接口清单见 uni_modules/dlcx-guess-song/readme.md。

常见问题

  • 一直停在「正在准备曲库…」:多为网络不通或 baseUrl 不可达,请核对根地址与服务器状态。
  • 提示授权失败:appKey 与该服务配置的授权列表不匹配,或 appid / 设备指纹未绑定。
  • 语音玩法不可用:确认已授予麦克风权限,且服务端已配置语音识别能力。
  • 源码里中文 / emoji 显示乱码:工程文件均为 UTF-8 编码;若编辑器按 GBK 打开会显示乱码,请在编辑器(如 HBuilderX 右下角)把文件编码切换为 UTF-8 后重新打开即可,文件内容无需改动。
  • 组件不显示:本组件仅支持 uni-app x 原生 App,不支持普通 vue2/vue3 项目与小程序。

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议

暂无用户评论。