更新记录

1.1.2（2026-08-07）

发版

1.1.1（2026-08-07）

发版

1.1.0（2026-08-07）

发版

平台兼容性

云端兼容性

uni-app(5.14)

uni-app x(5.14)

云函数类插件通用教程

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

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

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

📱︎ 试玩地址 📱︎

优质案例：

动物城找一找（Animal Finder）

一款限时寻找目标动物的休闲益智游戏。游戏主体使用 Godot 4.6 开发并导出为 Web，在 uni-app 中通过 web-view 运行；uniCloud（阿里云）负责下发已发布的激励视频广告配置。

当前版本：0.1.0

核心玩法

• 包含 80 个逐步提升难度的关卡。
• 在倒计时内找到指定种类和数量的动物。
• 连续找对可获得连击加分；点错会清空连击并扣除 2 秒。
• 随关卡推进，目标种类和数量增加，可用时间缩短。
• 根据通关表现获得星级，并在本地保存关卡进度。
• 提供提示、冰冻、炸弹三种工具，其中炸弹在第 5 关解锁。
• 每种工具每日默认可用 3 次，也可通过观看激励视频补充。
• 支持背景音乐、动物音效和振动开关。

游戏进度保存在 Godot 用户目录的 user://animal_finder_save.cfg。

技术架构

Godot 4.6 游戏
    │ Web 导出
    ▼
uni-app web-view ── 消息桥接 ──> 激励视频服务（uni-ad）
                                      │
                                      ▼
                              uniCloud 广告配置

• 游戏层：Godot 4.6，负责规则、关卡、界面、音效和本地存档。
• 宿主层：uni-app / Vue 3，通过 pages/game/index.vue 加载 Godot Web 游戏。
• 通信层：bridge/messages.js 校验游戏发出的激励广告请求。
• 广告层：services/rewarded-ad-service.js 处理广告加载、完成、取消、失败、冷却和每日次数限制。
• 配置层：services/config-service.js 识别运行平台，并调用 af-public-config 云函数读取已发布配置。
• 管理端：广告配置由同级项目 animal-finder-vk-admin 管理。

目录结构

animal-finder-uniapp/
├── bridge/                         # Godot 与 uni-app 的消息协议及校验
├── pages/game/                     # 游戏容器页面
├── services/                       # 平台识别、配置加载和激励广告服务
├── static/game/                    # 同步后的 Godot Web 游戏文件
├── scripts/sync-game-export.mjs    # Godot Web 导出资源同步脚本
├── tests/                          # Node.js 单元测试
├── uniCloud-aliyun/
│   ├── cloudfunctions/
│   │   └── af-public-config/       # 返回已发布的广告配置
│   └── database/                   # af-ad-config 数据库定义
├── manifest.json                   # uni-app 应用与平台配置
├── pages.json                      # 页面配置
└── package.json                    # 项目元数据

Godot 主工程位于本仓库上一级目录，游戏脚本位于 ../scripts/，Web 导出文件生成在上一级目录根部。

开发环境

• Godot 4.6
• HBuilderX（用于运行和发行 uni-app 工程）
• Node.js 18+（用于资源同步脚本和测试）
• DCloud 账号及 uniCloud 阿里云服务空间

本项目是 HBuilderX 工程，不是常规的 Vite/npm CLI 项目。

导出并同步 Godot 游戏

1. 使用 Godot 打开上一级目录中的 project.godot。
2. 将游戏导出为 Web，输出到上一级目录。导出结果应包含 Animal Finder.html、Animal Finder.js、Animal Finder.wasm、Animal Finder.pck 等文件。
3. 在仓库上一级目录执行：

node animal-finder-uniapp/scripts/sync-game-export.mjs

同步脚本会把 Godot Web 文件复制到 animal-finder-uniapp/static/game/，修正触摸图标路径，并注入 uni-app WebView 适配代码和 game-host.js。uni-app 游戏页随后加载 /static/game/Animal Finder.html。

每次重新导出 Godot 游戏后，都需要再次执行同步命令。

HBuilderX 与 uniCloud

1. 在 HBuilderX 中导入 animal-finder-uniapp 目录。
2. 登录 DCloud 账号，为项目关联 uniCloud 阿里云服务空间。
3. 初始化或更新 af-ad-config 云数据库集合。
4. 上传并部署 uniCloud-aliyun/cloudfunctions/af-public-config 云函数。
5. 使用 animal-finder-vk-admin 新建、编辑并发布目标平台的广告配置。
6. 在 HBuilderX 中选择 H5 或对应 App 平台运行和调试。

af-public-config 只返回已发布的配置。支持的配置维度包括：

• 平台：app-android、app-ios、mp-weixin
• 环境：development、production

激励视频流程

Godot 请求使用提示、冰冻或炸弹工具时，会向宿主发送 request_rewarded_ad 消息。uni-app 校验工具类型（hint、freeze、bomb），读取当前平台的广告配置并拉起 uni-ad 激励视频，最后把完成、取消或失败结果返回游戏。

Android 和 iOS App 使用子 WebView 的 evalJS 将结果实时传回 Godot。开发时可以参考 uni-app 广告接入说明 了解消息格式、配置字段和平台差异。

测试

在当前目录执行：

node --test tests/*.test.mjs

测试覆盖消息校验，以及激励广告的完成、取消、失败、冷却和次数限制等主要流程。

平台与发行说明

• H5：用于本地开发和集成调试。
• Android / iOS App：当前激励广告桥接方案的主要目标平台，正式发行前需在 HBuilderX 中配置 uni-ad、应用标识、证书和隐私权限。
• 微信小程序：小程序 WebView 不具备与 App 子 WebView 相同的实时反向通信能力，当前激励奖励闭环尚未完成。
• 微信小游戏：属于独立运行目标，并非直接发布当前 uni-app WebView 工程即可完成。由于 .wasm、.pck 等资源通常超过普通包体限制，还需要 CDN 或分包方案、消息桥接以及 Godot 运行时适配。

因此，Android 和 iOS App 是当前可继续联调的发行方向；微信小游戏是项目目标平台，但在正式发布前仍需完成专项适配和真机验证。

项目信息

• 应用名称：动物城找一找
• 英文名称：Animal Finder
• 当前版本：0.1.0
• 游戏引擎：Godot 4.6
• 宿主框架：uni-app / Vue 3
• 云服务：uniCloud（阿里云）

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

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

扫码体验