Cocos Creator 微信小游戏试玩导出指南

概述

微信小游戏试玩是一种特殊的游戏体验方式,允许用户在正式下载游戏之前先体验游戏内容。本文将介绍两种在 Cocos Creator 中导出微信小游戏试玩的方法,以及可能遇到的问题和解决方案。

导出方式

1. 传统方式(使用 adapter)

前置准备

构建步骤

  1. 准备构建模板

    • build-templates 文件夹复制到试玩工程目录下
  2. 配置小程序信息

    • 在项目设置中配置试玩小程序的 AppID
  3. 构建小程序

    • 在 Cocos Creator 中选择"构建微信小游戏"
    • 确保选择正确的构建模板
  4. 整合到主游戏

    • 将构建的小程序工程复制到主游戏的 playableDemo 文件夹下
  5. 配置分包信息

    • 修改主工程的 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"
          }
        }
    ]
    
  6. 构建分包

    • 新建分包构建配置
    • 选择"分包构建"模式
    • 执行构建

常见问题

  1. 资源文件缺失

    • 问题:编译时提示 logo.pngslogan.png 缺失
    • 解决:复制或创建所需的图片资源文件
  2. 引擎裁剪问题

    • 问题:TypeError: Cannot read property 'passes' of undefined
    • 解决:在 Cocos Creator 中修改引擎裁剪设置
      • 打开 Project Settings
      • 选择 Feature Cropping
      • 在 2D 选项中勾选:
        • User Interface
        • Tiled Map
  3. 音频加载失败

    • 问题:cc.js:88919 failed to load innerAudioContext
    • 解决:由于 adapter 方式的限制,建议使用新的构建方式

2. 新构建方式(推荐)

构建步骤

  1. 配置小程序信息

    • 在项目设置中配置试玩小程序的 AppID
  2. 构建微信小游戏

    • 选择"构建微信小游戏"
    • 使用默认构建配置
  3. 导入开发工具

    • 在微信开发者工具中导入构建结果
    • 工具会自动识别为试玩版本
  4. 编译上传

    • 执行编译
    • 上传到微信平台

优势

  • 构建流程更简单
  • 更好的兼容性
  • 更少的配置步骤
  • 更稳定的运行效果

注意事项

  1. 资源限制

    • 注意试玩包大小限制
    • 合理规划资源加载
    • 避免资源浪费
  2. 功能限制

    • 了解试玩版本的功能限制
    • 避免使用不支持的特性
    • 做好功能降级处理
  3. 兼容性

    • 测试不同设备
    • 验证各种场景
    • 处理异常情况

参考资源

57.12k 字
43篇文章