CocosCreator 小游戏快速开始

SDK 组成部分

SDK 以 ZIP 包的格式进行分发，其包含所需的全部文件。解压后有如下文件:

• SDKlibs: SDK 文件库

• SDKResources: SDK 预制件库, 必须放入 resources

• gameConfig.json：游戏配置文件

• minigameSDK.d.ts: 代码提示文件

• tag.txt：SDK 特征码。某些工单处理时可能会要求提供

• ticket.txt：SDK 解密秘钥，仅可解密当前包的 SDK

各部分导入

放入 SDKlibs

• 请将 SDKlibs 文件夹，整个拖入到 Cocos 工程的assets 根目录中。如之前存在旧 SDK，必须进行覆盖。

• 导入时，如 Cocos 有提示"是否导入为插件"，勾选

• 如果您项目的主包包体紧张，或需要加速游戏的进入速度，请参考下图将 SDKlibs 分包:

  • 选择好目标平台和压缩类型

  • 请勿配置为远程包

建议出特殊情况外，一律将 SDK 分包

请注意，SDK 为专项-专渠道-专用：

• 如您的游戏发多个渠道且都获取了对应的 SDK，请勿混用

• 如您有多个游戏都获取了对应的 SDK，请勿混用

• 如您的游戏同时接入了 APP 和小游戏 SDK，打对应包时需删除另一方的文件

放入 SDKResources

• 请将 SDKResources 文件夹，整个拖入到 Cocos 工程的resources目录下。如之前存在旧 SDK，必须进行覆盖。

• 请注意，SDKResources 文件夹必须放入 resources 目录中，SDK 内部会需要利用 cocos 机制进行动态加载。

• 必须将整个 SDKResources 文件夹放入(有 SDKResources 这一层)，勿提取子文件夹。

提前设计游戏启动场景

建议提前为游戏设计专门的，用于游戏自身的初始化加载逻辑、SDK 加载逻辑、启动时的隐私处理。

待前置逻辑处理完后，玩家点击"进入游戏"再跳转真正的游戏首场景。

一般来说，启动场景建议分为两个部分：

• 动态启动项目：所有基于 SDK 和隐私初始化完成后才允许展示的项目。

  • 隐私相关内容：

    • 隐私政策、用户协议按钮

    • 适龄按钮

  • 开始游戏按钮等最终跳转逻辑：需要隐私初始化完成后，才可以展示给玩家。如果是自动进入游戏，则必须检测为隐私同意状态才可自动执行

• 静态启动项目: 一般包含背景图片、版号软著、八句箴言等无需 SDK 初始化即可展示的内容。

拖入 MainLoad 预制件

请将resources\SDKResources\MainLoad\prefabs\MainLoad.prefab拖到场景的根节点下, 与 Canvas 同级，保持为 active 状态。且 MainLoad 位于节点树最下层。

放入 gameConfig.json

将gameConfig.json其放入工程的任意位置，保证在启动场景可以获取到其内容即可。例如下图的例子

复制秘钥

请打开 ticket.txt，复制其内容备用。(文件无需放入工程,只需要里面的值)

放入代码提示文件

为方便接入 SDK 功能，请将 minigameSDK.d.ts 放入工程的根路径，与 assets 同级。 打开 VSCode 等 IDE 即可使用智能代码提示。