2.7.9 发布到支付宝小游戏

优质
小牛编辑
162浏览
2023-12-01

Cocos Creator 3D 从 v1.0.3 版本开始正式支持将游戏发布到支付宝小游戏。

参数选项说明

参数名可选默认值说明
polyfills选填{ asyncFunctions: true }自 v1.0.3 版本起,构建支持一些新特性的 polyfills ,主要是在打包脚本时会做对应处理,开发者可以根据实际需求选择需要的 polyfills, 这组选项暂时只有异步函数,后续将会开放更多功能。
remoteUrl选填' '服务器地址,指定了服务器地址后,资源将会从服务器上下载,具体加载规则可以参考微信小程序端

deviceOrientation | 必填 | 'auto' | 设备方向,可选值为'landscape' | 'portrait'。|

环境配置

发布流程

一、使用 Cocos Creator 3D 打开需要发布的项目工程,在 构建发布 面板的 发布平台 中选择 Alipay Mini Game。然后点击 构建

二、构建完成后点击 发布路径 后的 打开 按钮,可以看到在发布包 build 目录下生成了支付宝小游戏工程文件夹 alipay,其中已经包含了支付宝小游戏环境的配置文件 game.json

三、使用 支付宝开发者工具 打开构建生成的 alipay 文件夹,即可打开支付宝小游戏项目以及预览调试游戏内容。

支付宝小游戏环境的资源管理

支付宝小游戏与微信小游戏类似,都存在着包体限制,超过 4MB 的额外资源,必须通过网络请求下载。

我们建议用户只保存脚本文件在小游戏包内,其他资源都从远程服务器下载。Cocos Creator 3D 已经帮用户做好了远程资源的下载、缓存和版本管理。具体的实现逻辑和微信小游戏类似,详情可参考 微信小游戏资源管理

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

  1. 构建时,设置 远程服务器地址,然后点击 构建
  2. 构建完成后将支付宝小游戏发布包目录下的 res 文件夹完整的上传到服务器。
  3. 删除本地发布包目录下的 res 文件夹。

支付宝小游戏已知问题:

我们对支付宝小游戏的适配工作还未完全结束,目前已知在低端机上文本渲染效果可能不太理想。并且仍不支持以下模块:

  • WebView
  • VideoPlayer
  • 分包加载
  • 自定义字体

以上功能预计在以后的更新中会逐步支持,我们也将持续与支付宝小游戏的工程师们紧密沟通,不断优化适配效果。

文档相关

由于支付宝小游戏相关的文档目前只对内开放,开发者如果有需要的话可直接联系:

联系人Email
李智lz98684@alibaba-inc.com
黄娇huangjiao.hj@alibaba-inc.com