概述
微信小游戏试玩是一种特殊的游戏体验方式,允许用户在正式下载游戏之前先体验游戏内容。本文将介绍两种在 Cocos Creator 中导出微信小游戏试玩的方法,以及可能遇到的问题和解决方案。
导出方式
1. 传统方式(使用 adapter)
前置准备
- 下载官方 demo 工程:wechat-miniprogram/minigame-playable
- 准备试玩小程序的 AppID
构建步骤
准备构建模板
- 将
build-templates
文件夹复制到试玩工程目录下
- 将
配置小程序信息
- 在项目设置中配置试玩小程序的 AppID
构建小程序
- 在 Cocos Creator 中选择"构建微信小游戏"
- 确保选择正确的构建模板
整合到主游戏
- 将构建的小程序工程复制到主游戏的
playableDemo
文件夹下
- 将构建的小程序工程复制到主游戏的
配置分包信息
- 修改主工程的
game.json
,添加试玩分包配置:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
"subPackages": [ { "name": "moduleA", "root": "/moduleA/" // 普通分包 }, { "independent": true, "name": "playableDemo", "root": "/playableDemo/", "meta": { "type": "playable", "playableOrientation": "portrait" } } ]
- 修改主工程的
构建分包
- 新建分包构建配置
- 选择"分包构建"模式
- 执行构建
常见问题
资源文件缺失
- 问题:编译时提示
logo.png
和slogan.png
缺失 - 解决:复制或创建所需的图片资源文件
- 问题:编译时提示
引擎裁剪问题
- 问题:
TypeError: Cannot read property 'passes' of undefined
- 解决:在 Cocos Creator 中修改引擎裁剪设置
- 打开 Project Settings
- 选择 Feature Cropping
- 在 2D 选项中勾选:
- User Interface
- Tiled Map
- 问题:
音频加载失败
- 问题:
cc.js:88919 failed to load innerAudioContext
- 解决:由于 adapter 方式的限制,建议使用新的构建方式
- 问题:
2. 新构建方式(推荐)
构建步骤
配置小程序信息
- 在项目设置中配置试玩小程序的 AppID
构建微信小游戏
- 选择"构建微信小游戏"
- 使用默认构建配置
导入开发工具
- 在微信开发者工具中导入构建结果
- 工具会自动识别为试玩版本
编译上传
- 执行编译
- 上传到微信平台
优势
- 构建流程更简单
- 更好的兼容性
- 更少的配置步骤
- 更稳定的运行效果
注意事项
资源限制
- 注意试玩包大小限制
- 合理规划资源加载
- 避免资源浪费
功能限制
- 了解试玩版本的功能限制
- 避免使用不支持的特性
- 做好功能降级处理
兼容性
- 测试不同设备
- 验证各种场景
- 处理异常情况