• 发布到微信小游戏
    • 微信小游戏
    • 使用 Cocos Creator 发布微信小游戏
    • 小游戏环境的资源管理
    • 微信小游戏引擎插件
    • 微信小游戏分包加载
    • 平台 SDK 接入
    • 接入微信小游戏的开放数据域
    • 微信小游戏已知问题:
    • 参考链接

    发布到微信小游戏

    早在微信官方正式发布小游戏之前,Cocos Creator 团队就和微信开发团队合作完成了 Cocos Creator 对微信小游戏的支持。在小游戏正式公布之后,我们也在第一时间发布了完美支持小游戏的 Cocos Creator v1.8。这篇文档的初衷也是希望帮助开发者们在第一时间以最顺畅的方式提交游戏到小游戏。

    发布到微信小游戏 - 图1

    这篇文档将会覆盖:

    • 小游戏的运行环境介绍
    • 如何使用 Cocos Creator 发布微信小游戏
    • 小游戏资源管理

    微信小游戏

    微信小游戏是微信小程序下的游戏产品平台,它不仅提供了强大的游戏能力,还和小程序一样,提供了大量的原生接口,比如支付,社交,文件系统,照片,NFC 等。相当于同时结合了 WEB 易于传播以及 Native 功能丰富的优势。

    小游戏的运行环境是小程序环境的扩展,基本思路也是封装必要的 WEB 接口提供给开发者,尽可能追求和 WEB 同样的开发体验。小游戏在小程序环境的基础上提供了 WebGL 接口的封装,使得渲染能力和性能有了大幅度提升。不过由于这些接口都是微信团队通过自研的原生实现封装的,所以并不可以等同为浏览器环境。

    作为引擎方,为了尽可能简化开发者的工作量,我们为开发者完成的主要工作包括:

    • 引擎框架适配微信小游戏 API,纯游戏逻辑层面,开发者不需要任何额外的修改
    • Cocos Creator 编辑器提供了快捷的打包流程,直接发布为微信小游戏,并自动唤起小游戏的开发者工具
    • 自动加载远程资源,缓存资源以及缓存资源版本控制

    除此之外,小游戏的游戏提交,审核和发布流程和小程序是没有区别的,都需要遵守微信团队的要求和标准流程,具体信息可以参考文末的链接。

    使用 Cocos Creator 发布微信小游戏

    • 在 微信官方文档 下载微信开发者工具
    • 在编辑器菜单栏的 设置 -> 原生开发环境 中设置微信开发者工具路径

    发布到微信小游戏 - 图2

    • 登陆微信公众平台,找到 appid

    发布到微信小游戏 - 图3

    • 构建发布 面板的 发布平台 中选择 微信小游戏,填入小游戏 appid,然后点击 构建

    发布到微信小游戏 - 图4

    • 点击 运行 打开微信开发者工具

    发布到微信小游戏 - 图5注意:微信开发者工具,如果之前在 Mac 上没运行过,会出现:Please ensure that the IDE has been properly installed 的报错。需要手动打开一次微信开发者工具,然后才能在 Creator 里直接点击 play 调用。

    • 预览部署按照这样的流程,项目的 build 目录下就会生成一个微信小游戏的发布包 wechatgame 文件夹,其中已经包含了微信小游戏环境的配置文件:game.jsonproject.config.json

    发布到微信小游戏 - 图6

    小游戏环境的资源管理

    在小游戏环境中,资源管理是最特殊的部分,它和浏览器的不同在于下面四点:

    • 小游戏的包内体积不能够超过 4MB,包含所有代码和资源,额外的资源必须通过网络请求下载。
    • 对于从远程服务器下载的文件,小游戏环境没有浏览器的缓存以及过期更新机制。
    • 对于小游戏包内资源,小游戏环境内并不是按需加载的,而是一次性加载所有包内资源,然后再启动页面。
    • 不可以从远程服务器下载脚本文件。这里引出了两个关键的问题,首页面加载速度和远程资源缓存及版本管理。对于首页面加载速度,我们建议开发者只保存脚本文件在小游戏包内,其他资源都从远程服务器下载。而远程资源的下载、缓存和版本管理,其实在 Cocos Creator 中,已经帮开发者做好了。下面我就来解释一下这部分的逻辑。

    在小游戏环境中,我们提供了一个 wxDownloader 对象,给它设置了 REMOTE_SERVER_ROOT 属性后,引擎下载资源的逻辑就变成:

    • 检查资源是否在本地缓存内
    • 不存在则查询是否在小游戏包
    • 如果找不到就从远程服务器下载
    • 下载到临时目录后直接使用
    • 后台缓慢地将资源从临时目录保存到小游戏应用缓存内供再次访问时使用
    • 缓存空间有大小限制,如果超出限制则会保存失败,此时打印提示信息并停止缓存,但不会影响游戏的运行注意:需要额外注意的是,一旦缓存空间占满之后,所有需要下载的资源都无法进行保存,只能使用下载保存的临时文件,而微信会在小游戏退出之后自动清理所有临时文件,所以下次再次运行小游戏时,这些资源又会再度下载,然后一直循环往复此过程。另外,缓存空间超出限制导致文件保存失败的问题不会在微信开发者工具上出现,因为微信开发者工具没有限制缓存大小,所以测试缓存时需要真实微信环境进行测试。

    同时,当开启引擎的 md5Cache 功能后,文件的 url 会随着文件内容的改变而改变,这样当游戏发布新版本后,旧版本的资源在缓存中就自然失效了,只能从服务器请求新的资源,也就达到了版本控制的效果。

    具体来说,开发者需要做的是:

    • 构建时,在 构建发布 面板中勾选 md5Cache 功能。
    • 设置 远程服务器地址,然后点击 构建
    • 构建完成后将微信小游戏发布包目录下的 res 文件夹完整的上传到服务器。
    • 删除本地发布包目录下的 res 文件夹。
    • 对于测试阶段来说,可能开发者无法部署到正式服务器上,需要用本地服务器来测试,那么请在微信开发者工具中打开 详情 页面,勾选项目设置中的 不检验安全域名、TLS 版本以及 HTTPS 证书 选项。发布到微信小游戏 - 图7

    注意:如果缓存资源超过微信环境限制,开发者需要手动清除资源,可以在微信小游戏下使用 remoteDownloader.cleanAllCaches()remoteDownloader.cleanOldCaches() 接口来清除缓存。前者会清除缓存目录下的所有缓存资源,请慎重使用;而后者会清除缓存目录下目前应用中未使用到的缓存资源。

    微信小游戏引擎插件

    请参考 微信小游戏引擎插件。

    微信小游戏分包加载

    请参考 分包加载。

    平台 SDK 接入

    除了纯游戏内容以外,其实微信小游戏环境还提供了非常强大的原生 SDK 接口,其中最重要的就是用户、社交、支付等,这些接口都是仅存在于微信小游戏环境中的,等同于其他平台的第三方 SDK 接口。这类 SDK 接口的移植工作在现阶段还是需要开发者自己处理。下面列举一些微信小游戏所提供的强大 SDK 能力:

    • 用户接口:登陆,授权,用户信息等
    • 微信支付
    • 转发以及获得转发信息
    • 文件上传下载
    • 媒体:图片、录音、相机等
    • 其他:位置、设备信息、扫码、NFC、等等

    接入微信小游戏的开放数据域

    微信小游戏为了保护其社交关系链数据,增加了 开放数据域 的概念,这是一个单独的游戏执行环境。开放数据域中的资源、引擎、程序,都和主游戏完全隔离,开发者只有在开放数据域中才能访问微信提供的 wx.getFriendCloudStorage()wx.getGroupCloudStorage() 两个 API,用于实现一些例如排行榜的功能。

    Cocos Creator 从 v1.9.1 版本开始支持打包到开放数据域,详情请参考 接入微信小游戏的开放数据域。

    微信小游戏已知问题:

    我们对微信小游戏的适配工作还未完全结束,目前仍不支持以下组件:

    • VideoPlayer(v2.1.3 已支持)
    • WebView

    开发者如果有需要,目前可以通过直接调用微信的 API 来使用。

    参考链接

    • 微信小游戏开发文档
    • 微信公众平台
    • 小游戏 API 文档
    • 微信开发者工具下载
    • 微信缓存空间溢出测试案例