Cocos 正式支持小米快游戏、即刻玩小游戏
2019.05.28 by Cocos
品牌新闻

作为一款免费的开源移动跨平台游戏引擎,除原生平台之外,Cocos 截止目前已经率先完成了对以下小游戏平台的支持,包括微信小游戏、OPPO、vivo 小游戏、Huawei 快游戏、百度小游戏,海外的 Facebook Instant Games、Google PlayInstant 等。每支持一个新平台,Cocos 都能提供相应的编辑器工具链、文稿和范例,一次开发,全平台部署,帮助开发者实现利益最大化。

而今天正式发布的 Cocos Creator v2.0.10 也在第一时间提供了对小米快游戏、即刻玩小游戏两大平台的支持,现有内容已经可以无缝发布至小米快游戏和即刻玩小游戏平台,具体的环境配置和发布流程可参考下述文档。

  1 了解小米快游戏平台

2018 年 3 月 20 日,快应用联盟成立,并在发布会上推出“快应用”平台标准,将在研发接口、能力接入、开发者服务等层面建设标准平台,以平台化的生态模式对个人和企业开发者进行全品类开放。快应用是基于手机硬件平台的新型应用形态,具备传统 APP 完整的应用体验,无需安装、即点即用。

小米快应用与操作系统深度集成,可以在操作系统层面实现用户需求与应用服务间的无缝连接,提升用户的使用体验和应用服务的转化效率,同时支持生成桌面图标等留存能力。截止 2019 年 1 月,快应用开发者注册数量已超过 10000 家。

小米快游戏文档:https://dev.mi.com/console/doc/

  2 发布游戏至小米快游戏平台

Cocos Creator 从 v2.0.10 版本开始正式支持将游戏发布到小米快游戏。我们来看一下如何使用 Cocos Creator 发布到小米快游戏。

环境配置

  • 下载 小米快游戏调试器,并安装到小米手机上(MIUI 8.5.0 或以上版本)。
  • 下载 小米快应用服务框架,并安装到小米手机上。
  • 桌面端全局安装 Node.js 8.1.4 或以上版本。
  • 确保 Node.js 所带的 npm 版本最低是 5.2.0。升级 npm 命令如下:


发布流程

一、使用 Cocos Creator 打开需要发布的项目工程,在构建发布面板的发布平台中选择小米快游戏。

相关参数配置具体的填写规则如下:

应用包名

应用包名的格式是:com.yourcompany.projectname。该项为必填项,根据用户的需求进行填写。

应用名称

该项为必填项。是小米快游戏的名称。构建发布面板最上方的游戏名称则不参与小米快游戏打包流程。

桌面图标

该项为必填项。构建时 桌面图标 将会构建到小米快游戏的工程中。点击输入框右边的 ... 按钮即可选择图片。桌面图标建议使用 png 图片。

应用版本名称

该项为必填项。应用版本名称是真实的版本,如:1.0.0

应用版本号

该项为必填项。应用版本号与应用版本名称不同,应用版本号主要用于区别版本更新。每次提交审核时应用版本号都要比上次提交审核的值至少 +1,一定不能等于或者小于上次提交审核的值,建议每次提交审核时应用版本号递归 +1。注意:应用版本号必须为正整数。

支持的最小平台版本号

该项为必填项。根据小米快游戏的要求目前这个值必须大于或等于 1041。

小包模式服务器路径

该项为选填项。快游戏的包内体积包含代码和资源不能超过 10M,资源可以通过网络请求加载。小包模式就是帮助用户将脚本文件保留在快游戏包内,其他资源则上传到远程服务器,根据需要从远程服务器下载。而远程资源的下载、缓存和版本管理,Creator 已经帮用户做好了。用户需要做的是以下两个步骤:

1、构建之前,填写小包模式服务器路径。然后点击构建

2、构建完成后,点击发布路径后面的打开按钮,将发布路径下的 xiaomi/res 目录上传到小包模式服务器。例如:默认发布路径是 build,则需要上传 build/xiaomi/res 目录。

此时,构建出来的 rpk 将不再包含 res 目录,res 目录里的资源将通过网络请求从填写的小包模式服务器地址上下载。

密钥库

勾选密钥库时,表示默认使用的是 Creator 自带的证书构建 rpk 包,仅用于调试时使用。注意:若 rpk 包要用于提交审核,则构建时不要勾选该项。

如果不勾选密钥库,则需要配置签名文件 certificate.pem 路径 和 private.pem 路径,此时构建出的是可以 直接发布 的 rpk 包。用户可通过输入框右边的 ... 按钮来配置两个签名文件。注意:这两个签名文件建议不要放在发布包 build/xiaomi 目录下,否则每次构建时都会清空该目录,导致文件丢失。

有以下两种方式可以生成签名文件:

通过构建发布面板 certificate.pem 路径后的新建按钮生成。点击新建按钮后,在弹出的 certificate 面板中填写相关信息,信息填写完成后点击保存,在控制台会输出日志 Generate certificate is complete!,表示生成签名文件完成。

通过命令行生成 release 签名

用户需要通过 openssl 命令等工具生成签名文件 private.pem、certificate.pem。

# 通过 openssl 命令工具生成签名文件

注意:openssl 工具在 linux 或 Mac 环境下可在终端直接打开。而在 Windows 环境下则需要安装 openssl 工具并且配置系统环境变量,配置完成后需重启 Creator。

二、构建发布

构建发布面板的相关参数设置完成后,点击构建。构建完成后点击发布路径后面的 打开 按钮来打开构建发布包,可以看到在默认发布路径 build 目录下生成了 xiaomi 目录,该目录就是导出的小米快游戏工程目录和 rpk,rpk 包在 /build/xiaomi/dist 目录下。

三、将打包出来的 rpk 运行到手机上。

启动游戏,有以下两种方式:

方法一:

构建发布面板点击右下角的运行按钮,等待二维码界面生成。

然后在小米手机上打开之前已经安装完成的 快应用调试器,点击 扫码安装 按钮,直接扫描二维码即可打开 rpk。

方法二:

首先在小米手机上打开 设置-> 更多设置-> 开发者选项,开启开发者选项以及 USB 调试。

使用 USB 数据线将桌面端电脑与手机相连。

将构建生成的快游戏 rpk 文件(位于发布包 build/xiaomi/dist 目录下)拷贝到小米手机 sdcard 目录中。

在小米手机上打开之前已经安装完成的 快应用调试器,点击 本地安装,然后从手机 sdcard 目录中找到 rpk 文件,选择打开即可。

调试

调试必须基于真机进行调试,并且必须严格按照先运⾏游戏再启动调试功能的先后顺序。启动游戏后,让小米手机处于打开游戏运行的界面。然后使用 USB 数据线将桌面端电脑与小米手机相连,并且小米手机需要开启开发者选项以及 USB 调试。

开启调试有以下两种方式:

1、直接点击二维码界面上的游戏调试按钮:

即可在 Chrome 浏览器中⾃动启动调试界⾯:

2、通过命令行来启动调试:

指定到发布包目录 build/xiaomi 目录下,执⾏命令:npm run debug,就会在 Chrome 浏览器中 ⾃动启动调试界⾯。

如果想要手动打开调试界面,那么执行命令:npm run debug -- --print-only,然后将运行后生成的 URL 地址拷贝到 Chrome 浏览器中打开即可启动调试界⾯。

分包 rpk

分包 rpk 是根据用户的需求选择是否使用。分包加载,即把游戏内容按一定规则拆分在几个包里,在首次启动的时候只下载必要的包,这个必要的包称为 主包,开发者可以在主包内触发下载其他子包,这样可以有效降低首次启动的消耗时间。若要使用该功能需要在 Creator 中设置 分包加载,设置完成后在构建时就会自动分包。注意:单个分包/主包大小不能超过 5M,所有包体总和不能超过 10M。

构建完成后,会生成 .rpk 和 .rpks 文件,生成目录在 build/xiaomi/dist 目录下。

  3 了解即刻玩小游戏平台

当前微信平台上已经出现了月流水过亿的小游戏产品。安卓内购流水过千万的产品有 10 款,广告月流水过千万的产品有 11 款,整体的用户活跃规模也超过了 1 个亿。巨大的商业机会吸引着大量游戏开发者投身到这个领域。今天,我们携手全球知名智能设备厂商三星集团为广大开发者带来了一个用户基数大、变现效果更好、效率更高的新游戏平台,即刻玩小游戏平台。

即刻玩小游戏平台是依托于 Cocos Runtime 技术搭建的小游戏平台,整合了市面优质流量,为开发者提供快速高效的变现方案。众所周知,小游戏兼备了原生游戏和 H5 游戏的诸多优点,即点即玩的特性帮助开发者在保证用户快速进入的同时,在 Runtime 的帮助下,产品的质量和表现力也相比 H5 模式有了飞跃的提升。

丰富的玩法和中心化、去中心化流量的结合带来更好的用户新增、留存,拥有多种转化更强的入口,提供多样的接入组件支持开发者快速集成,还有三星海量用户池的大背景加持,不夸张的说,即刻玩小游戏平台将来也许会成为流量最大的小游戏平台之一。

即刻玩小游戏文档:https://gamebox.gitbook.io/project/you-xi-jie-ru-wen-dang/ji-shu-dui-jie

  4 发布游戏至即刻玩小游戏平台

Cocos Creator 从 v2.0.10 版本开始正式支持将游戏发布到即刻玩小游戏,以下是具体的步骤。

环境配置

  • 下载游戏自测工具并安装到 Android 设备(建议 Android Phone 6.0 或以上版本)。


发布流程

一、使用 Cocos Creator 打开需要发布的项目工程,在构建发布面板的发布平台中选择即刻玩小游戏。

相关参数配置具体的填写规则如下:

小包模式服务器路径

该项为选填项。小游戏的包内体积包含代码和资源不能超过 10M,资源可以通过网络请求加载。小包模式 就是帮助用户将脚本文件保留在小游戏包内,其他资源则上传到远程服务器,根据需要从远程服务器下载。而远程资源的下载、缓存和版本管理,Creator 已经帮用户做好了。用户需要做的是以下两个步骤:

1、构建之前,勾选小包模式,填写小包模式服务器路径。然后点击构建

2、构建完成后,点击发布路径后面的 打开 按钮,将发布路径下的 jkw-game/res 目录上传到小包模式服务器。例如:默认发布路径是 build,则需要上传 build/jkw-game/res 目录。

此时,构建出来的 cpk 将不再包含 res 目录,res 目录里的资源将通过网络请求从填写的 小包模式服务器地址 上下载。

二、构建

构建发布面板的相关参数设置完成后,点击构建。构建完成后点击 发布路径 后面的 打开 按钮来打开构建发布包,可以看到在默认发布路径 build 目录下生成了 jkw-game 目录,该目录就是导出的即刻玩小游戏工程目录和 cpk,cpk 包在 /build/jkw-game 目录下。

三、将打包出来的 cpk 运行到手机上。

打开之前已经安装完成的游戏自测工具,自测工具可以启动游戏并提供游戏登录、支付等功能。通过读取游戏配置参数,确定启动的游戏类型,以及游戏启动方式。开发者必须使用自测工具测试接入没有问题之后,才可以打包提交到平台审核。自测时没有要求包的大小,但如果是要提交审核的话,包的大小不能超过 10M。具体可参考 自测工具。

然后点击自测工具左上方的 配置游戏 按钮进入游戏配置页面。根据需求配置参数并保存。

参数配置:

属性功能说明
gameId游戏 ID,可由后台获取
gameKey游戏 Key,可由后台获取
gameSecret游戏密钥,可由后台获取
gameType游戏类型,可根据用户需求选择 对战 或者 非对战
gameMode游戏模式,选择 Runtime
lodeType游戏加载类型,即游戏启动方式。包括 File 和 Url 两种。具体使用方式可查看下方 启动游戏 部分的介绍
path游戏加载地址,配合 lodeType 使用。具体使用方式可查看下方 启动游戏 部分的介绍

启动游戏:

游戏自测工具可以通过以下两种方法启动游戏。

方法一:以文件方式从指定位置加载游戏包(游戏加载类型为 File)

  • 将构建生成的小游戏 cpk 文件(位于小游戏工程 jkw-game 目录下)拷贝到手机目录下。如果是拷贝到 sdcard 目录下,则需要在 sdcard 目录中新建一个文件夹,然后将 cpk 文件拷贝到新建文件夹中。
  • 游戏自测工具参数配置页面中的 lodeType 选择 File。
  • path 填写刚才拷贝 cpk 文件放置的新建文件夹,如:/test/game.cpk。
  • 配置完成后点击 保存,然后点击 启动游戏,即可打开游戏。

方法二:以网页方式从指定网址打开游戏(游戏加载类型为 Url)

  • 将 cpk 文件上传到服务器。
  • 游戏自测工具参数配置页面中的 lodeType 选择 Url。
  • 填写 path,如:http://192.168.0.1:8080/game.cpk。
  • 配置完成后点击保存,然后点击启动游戏,即可打开游戏。

  5 结语

硬核联盟发布的《2018 年中国移动游戏市场发展白皮书》指出,渗透率占比最高的仍然以硬件厂商为主,总占比高达 76.9%。其中硬核联盟旗下的应用商店在安卓渠道的分发量高达 64.38%,在游戏用户的渗透率上处于行业第一。从发展趋势上看,硬件厂商已经成为了国内移动游戏分发渠道中举足轻重的组成部分。

兵欲善其事,必先利其器。当前开放的小游戏平台数量众多,无论游戏准备上线哪个平台,选择一款能让开发过程更简单的引擎工具十分有必要。Cocos 做为国内无缝接入小游戏平台数量最多的引擎厂家,和当前新兴流量入口都开展了技术和服务上的深入合作。2019 年,Cocos 将继续充分利用自己的技术力量,深度融合社交和内容,积极连接各个硬件厂商,与市场生态深度结合,创造出更好的化学反应,共创用户价值。

创意小游戏从开发上线到玩转出海,Cocos 一站式搞掂

全球第二本 Cocos Creator 中文教材出版了

互动类游戏潜力大,这款插件让你1小时创造作品

Cocos Creator 开发小游戏的实用技巧

Cocos 技术派 |《野蛮人大作战》从开发到上线

Cocos 技术派 | Cocos Creator 2.0 摄像机的灵活运用