更新记录
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/ # 猜歌组件(核心插件)
运行与调试
- 用 HBuilderX 打开本目录(
musicuts)。 - 连接真机或启动模拟器。
- 依次点击「运行 → 运行到手机或模拟器 → 运行到 Android App 基座 / iOS App 基座」。
- 首次运行需允许麦克风权限(语音玩法使用)。
授权配置(关键)
答题页 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": "用于语音猜歌玩法录制你的歌声进行识别"
}
打包发布
manifest.json中完善应用图标、启动图、版本号。- HBuilderX 菜单「发行 → 原生 App-云打包」,选择 Android / iOS 证书后打包。
- 打包前确认
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 项目与小程序。

收藏人数:
下载插件并导入HBuilder
下载插件ZIP
赞赏(0)
下载 4181
赞赏 0
下载 12777094
赞赏 1960
赞赏
京公网安备:11010802035340号