更新记录

1.0.3（2026-08-17）

发版

1.0.2（2026-08-17）

发版

1.0.1（2026-08-17）

发版

平台兼容性

云端兼容性

uni-app(5.15)

其他

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

遥祝各位老板：生意兴隆通四海，财源茂盛达三江

👉︎👉︎👉︎ 咨询客服 👈︎👈︎👈︎

扫码试玩：

拨浪鼓

一款基于 uni-app 和 Vue 3 开发的中国传统拨浪鼓互动应用。用户可以摇动手机、点击鼓面或左右滑动来拨动鼓槌，应用会根据操作方向和力度播放动画、音效与振动反馈。

当前版本：1.0.0

功能特色

• 支持摇动手机、点击鼓面和左右滑动三种操作方式。
• 识别左右方向以及轻、普通、重三档力度。
• 提供拨浪鼓动画、敲击音效和振动反馈。
• 支持自动演奏、连续敲击统计和最高连击记录。
• 内置经典、传统、节日、可爱四个分类，共 9 款拨浪鼓皮肤。
• 部分皮肤可通过微信小程序激励视频广告解锁。
• 内置 9 项成就，并在本地记录解锁状态和使用统计。
• 支持声音、振动、传感器开关及三档传感器灵敏度。
• 支持微信好友分享和朋友圈分享。
• 适配安全区域、小屏设备和横屏布局。

操作方式

• 摇动手机：使用加速度计识别摇动方向和力度，是微信小程序真机端的主要交互方式。
• 点击鼓面：点击拨浪鼓即可触发一次敲击。
• 左右滑动：在鼓面区域滑动，按照滑动方向触发对应鼓槌。
• 自动演奏：开启后按固定节奏自动敲击，可再次点击关闭。

页面与模块

• 首页：拨浪鼓交互、实时统计、自动演奏和快捷设置。
• 皮肤中心：浏览、解锁并切换 9 款拨浪鼓皮肤。
• 成就中心：查看成就条件和完成进度。
• 个人中心：查看累计敲击、最高连击及当前配置。
• 设置：管理声音、振动、传感器和灵敏度。
• 帮助、关于与隐私：提供操作说明、项目信息和隐私说明。

技术说明

• 框架：uni-app、Vue 3
• 主要平台：微信小程序
• 预览平台：H5
• 状态持久化：uni-app 本地存储 API
• 设备能力：加速度计、振动、音频播放
• 广告能力：微信小程序激励视频广告

主要代码结构如下：

├── pages/                         # 首页及各功能页面
├── components/                    # 拨浪鼓、统计及通用组件
├── composables/                   # 传感器、音效、成就和广告逻辑
├── stores/                        # 应用状态与本地持久化
├── static/                        # 图片、皮肤和音频资源
├── manifest.json                  # 应用与微信小程序配置
├── pages.json                     # 页面路由和窗口配置
└── package.json                   # 插件市场项目元数据

👉︎👉︎👉︎ 咨询客服 👈︎👈︎👈︎

Vibe coding 软件开发：出售多种网赚项目和软件开发(点击前往查看详情)

扫码体验

使用说明

1. 使用 HBuilderX 导入项目目录。
2. 在 manifest.json 中将微信小程序 AppID 替换为自己的 AppID。
3. 在 composables/useRewardedVideoAd.js 中将 REWARDED_VIDEO_AD_UNIT_ID 替换为自己的激励视频广告位 ID；不使用广告时可按业务需要移除相关入口。
4. 在 HBuilderX 中选择“运行到小程序模拟器 -> 微信开发者工具”。
5. 使用微信开发者工具完成授权、上传和发布，发布前请在真机上测试摇动、声音、振动、广告与分享功能。

H5 可用于预览页面布局和基本交互流程。由于浏览器与微信小程序的设备 API 存在差异，加速度计、音频、振动、广告和分享等能力应以微信小程序真机测试结果为准。

数据与隐私

• 应用不要求登录，不收集用户头像、昵称、手机号或通讯录。
• 敲击统计、最高连击、皮肤、成就和设置保存在用户设备本地。
• 加速度计数据只在运行期间用于判断摇动方向和力度，不上传、不留存。
• 激励视频由微信小程序广告能力提供，其数据处理遵循微信平台相关规则。
• 用户可通过清除小程序数据或卸载应用移除本地记录。

构建与测试

完整的 Node.js 源码工程可使用以下命令：

pnpm test
pnpm build:h5
pnpm build:mp-weixin

插件包也可以直接使用 HBuilderX 运行和发行。若当前下载内容不包含 Node.js 构建配置，请以 HBuilderX 工作流为准。