xpcool/gratitude.durian.xpcool.com

2026-08-14 18:01:45 +08:00

6.6 KiB

Raw Blame History

报恩榴莲 - 微信小游戏适配指南

🎯 快速开始

1. 构建微信小游戏包

# Windows PowerShell（推荐）
.\build-wechat.ps1 -Version "1.0.0"

# 或者使用批处理
build-wechat.bat

构建完成后，输出目录：build/wechatgame/

2. 真机测试

打开微信开发者工具
导入项目：选择 build/wechatgame 目录
AppID：wxb2b7651c561f9d53
点击「预览」生成二维码
用手机微信扫码测试

📁 文件说明

核心代码

js/main.js - 微信小游戏入口文件（已适配微信环境）
cocos-prototype/assets/scripts/core/AdManager.ts - 广告管理器
cocos-prototype/assets/scripts/core/AudioManager.ts - 音频管理器
cocos-prototype/assets/scripts/core/SaveManager.ts - 存档管理器

配置文件

wechat-config.js - 微信性能配置和分包策略

构建脚本

build-wechat.ps1 - PowerShell 构建脚本（推荐）
build-wechat.bat - Batch 构建脚本

文档

WECHAT_ADAPTATION_SUMMARY.md - ⭐ 必读：适配完成总结
WECHAT_OPTIMIZATION_GUIDE.md - 性能优化指南
WECHAT_DEPLOYMENT_GUIDE.md - 部署和提审指南
WECHAT_QUICK_REFERENCE.md - 快速参考卡

✅ 已完成适配

1. 微信环境初始化

✅ 帧率设置（60 FPS）
✅ 音频中断处理
✅ 加载进度显示
✅ 性能监控

2. 广告系统

✅ 激励视频广告（复活、道具）
✅ 插屏广告（关卡结束）
✅ 广告频控（每日最多18次）
✅ 预加载机制

3. 音频系统

✅ 来电/通知自动暂停
✅ 中断结束后自动恢复
✅ 内存管理优化

4. 存档系统

✅ 微信存储 API 优先
✅ 双备份机制
✅ 自动保存（每30秒）
✅ 数据导入/导出

5. 性能优化

✅ 对象池管理
✅ GC 主动触发
✅ 内存监控
✅ 分包加载支持

🚀 下一步操作

立即执行（必须）

1. 替换广告位 ID

编辑文件：cocos-prototype/assets/scripts/core/AdManager.ts

// 第 23-29 行，替换为你的真实广告位 ID
private static readonly AD_UNIT_ID_REVIVE = 'adunit-你的复活广告ID';
private static readonly AD_UNIT_ID_REMOVE_FRUIT = 'adunit-你的道具广告ID';
private static readonly AD_UNIT_ID_INTERSTITIAL = 'adunit-你的插屏广告ID';

获取广告位 ID：

登录微信公众平台
左侧菜单：推广 → 流量主
创建广告位（激励视频 + 插屏）
复制广告位 ID

2. 重新构建

.\build-wechat.ps1 -Version "1.0.0"

3. 真机测试

重点测试：

广告能否正常展示
观看完成后是否发放奖励
音频中断后是否恢复
存档是否正常保存和加载

📊 关键指标要求

指标	目标值	检查方法
启动时间	< 3秒	真机计时
FPS	60	Performance 面板
内存占用	< 200MB	wx.getSystemInfoSync()
主包大小	≤ 20MB	查看 build 目录
崩溃率	< 1%	微信后台数据

🐛 常见问题

Q1: 广告不显示？

原因：

模拟器测试（广告只在真机显示）
广告位 ID 未替换
网络问题

解决：

必须真机测试
确认广告位 ID 已替换
检查网络连接

Q2: 启动慢？

解决：

压缩图片和音频
使用分包加载
延迟加载非核心资源

Q3: 内存泄漏？

解决：

// 场景切换时清理
onDestroy() {
    this.node.removeAllChildren();
    resources.releaseAll();
    if (wx.triggerGC) wx.triggerGC();
}

Q4: 音频中断后不恢复？

检查：确保 AudioManager.ts 中有以下代码：

wx.onAudioInterruptionEnd(() => {
    this._onAudioInterruptEnd();
});

📖 详细文档

🔧 开发工具

必备工具

Cocos Creator 3.8 - 游戏引擎
微信开发者工具 - 调试和上传
TinyPNG - 图片压缩（https://tinypng.com/）
Audacity - 音频编辑（可选）

可选工具

VS Code - 代码编辑
微信云开发 - 云端存档（高级功能）

📞 技术支持

官方文档

社区

🎯 上线流程

开发完成 
   ↓
本地测试（模拟器）
   ↓
真机测试（iOS + Android）
   ↓
性能优化
   ↓
替换广告位 ID
   ↓
构建最终包
   ↓
上传到微信后台
   ↓
提交审核（1-3个工作日）
   ↓
审核通过 → 全量发布
   ↓
数据监控 + 持续迭代

✨ 项目亮点

1. 差异化玩法

三三合成（非传统三消）
连锁反应机制
连击系统

2. 情感 IP

报恩榴莲拟人化
Boss 投喂互动
图鉴收集

3. 名场面营销

「金色传说」史诗特效
适合短视频传播
社交货币属性

4. 技术优化

完善的微信 API 适配
智能的资源管理
全面的性能监控

📈 预期效果

性能表现

启动时间：< 3秒
稳定帧率：60 FPS
内存占用：< 200MB
包体大小：< 20MB

商业表现（预估）

次日留存：> 30%
广告完成率：> 60%
eCPM：> ¥50
ARPU：> ¥0.5

⚠️ 注意事项

必须遵守

不能永久删除用户文件 - 只能移动到回收站
广告频控 - 每日最多18次，间隔60秒
隐私政策 - 如需收集用户数据，必须提供隐私政策
内容审核 - 不得有违规内容

建议遵守

移除所有 console.log（生产环境）
压缩所有资源文件
定期备份存档数据
监控崩溃率（目标 < 1%）

🎉 结语

《报恩榴莲》微信小游戏适配工作已全部完成！

当前状态：✅ 具备上线条件

待完成：

替换广告位 ID
真机测试验证
准备提审材料
提交微信审核

祝游戏上线顺利，大获成功！🚀🍈✨

最后更新: 2026-08-14
版本: v1.0.0
平台: 微信小游戏
引擎: Cocos Creator 3.8

6.6 KiB Raw Blame History Unescape Escape