SDK对接文档

主题

本文涉及CocosCreator H5可玩和微信小游戏试玩的制作技术指导

1. 引擎版本选择 ​

可玩新项目使用 cocoscreator 3.7.3 引擎版本，不要用 2.x.x 版本。

注意：对于微信小游戏可玩（只支持JS引擎的可玩），可玩子包跟游戏包是完全不同的东西，这两者可以使用不同的引擎或者不同版本引擎开发，两者也不会互相加载。

2. 游戏规范（重要） ​

可玩/试玩游戏比较简单，但是包体要求很严苛，请研发按下述要求做可玩/试玩包：

  1. 单场景制作，只需要一个cocos场景 scene 即可。

  2. 可玩的UI操作比较简单，不需要使用自制或第三方ui框架。

  3. 尽量不使用其它插件，或者类库，UI尽可能使用引擎内置UI组件，因为有的类库很复杂，导致转单文件后，资源非常大。

  4. 设计分辨率按1280x720即可。

  5. 资源包括音效和图片，尽可能使用九宫格图片，纯色图片使用 sprite 直接设置颜色，音效使用 mp3 格式。

  6. 不需要使用分包加载也不用放在 resources 动态加载，因为试玩最后都会合并资源，动态加载可能会出问题，也没有意义。

  7. 代码用 ts 编写，虽然游戏比较简单，但是需考虑后面的扩展性，可能需要做不同的版本，有些东西不能太的太死，导致后续更改起来比较困难。

  8. 代码里面逻辑尽可能简单，不要的代码尽量剔除，或者注释掉（良好的做法是用 if (false){ ... }）。

  9. 尽量不要使用序列帧动画，用 spine 做比较合适

  10. 必须处理好横竖屏适配，最好用 widget 组件。

  11. 不要在可玩/试玩工程配置压缩纹理配置，考虑到设备兼容性，以及可玩图片资源量和包体都较少，转换没有太大意义。

  12. 一定记得剔除默认天空盒模块以及天空盒纹理。

3. 接口调用 ​

商店跳转 ​

可玩/试玩广告点击都会调到应用商店或其他应用。

微信试玩跳转，会调用微信的接口，用不上 googleURL 和 iosURL，只出微信试玩的话可留空

如右侧PLAYNOW的点击事件中需要调用平台的接口进行调整，请自行在游戏中添加以下代码，注意请替换其中的商店链接URL地址！

typescript
jumpAppStore() {
    // 商店跳转链接请记得修改！
    const ptData = {
        googleURL: "https://play.google.com/store/apps/details?id=xxx.yyy",
        iosURL: "https://apps.apple.com/app/idxxxxx"
    }
    window['playable'] && window['playable'].openUrl(ptData);
}

结束调用 ​

WARNING

微信可玩在30秒时会自动结束，并跳转到结束页，此接口已废弃

javascript
gameOver() {
        // 游戏结束的时候调用 失败或者成功
        window['playable'] && window['playable'].gameEnd();
}

playable模块由可玩打包转换工具会自动注入

4. 游戏导出 ​

1. 功能裁剪 ​

裁剪不需要的模块，避免包体过大， html大小限制5M以内

网络模块（WebSocket/WebSocketServer）必须全部裁剪，不能保留！

2. 构建微信小游戏 ​

1、在项目设置中配置试玩小程序的 AppID

2、选择"构建微信小游戏"

3、使用默认构建配置

3. 发布上传 ​

1、在微信开发者工具中导入构建结果

2、工具会自动识别为试玩版本

3、执行编译

4、上传到微信平台

点我快速对接