发布游戏到 Facebook Instant Games
从 v1.9 版本开始,Cocos Creator 正式支持将游戏发布到 Facebook Instant Games 平台。开发者可快速发布输出符合 Facebook Instant Games 技术标准的游戏。Facebook Instant Games 跟微信小游戏和 QQ「玩一玩」相比,本质上的区别在于 Facebook Instant Games 运行于纯 HTML5 环境。因此它不仅可以在手机上,还可以在桌面浏览器上运行,开发和调试更加便捷。
目前 Cocos Creator 为用户完成的工作包括:
- 集成了 Facebook Instant Games SDK,并且自动进行了初始化,用户能直接调用相关的 API
- 在 Cocos Creator 构建面板中提供一键式打包流程,可直接打包为符合 Facebook Instant Games 技术规范的游戏
用户需要完成的工作:
- 调用 Facebook Instant Games SDK,访问平台相关功能
- 将 Cocos Creator 打包好的版本上传到 Facebook
发布流程
- 使用 Cocos Creator 构建游戏
- 测试游戏
- 上传到 Facebook 后台
- 在 Facebook 中分享你的游戏
一、使用 Cocos Creator 构建游戏
使用 Creator 打开需要发布的项目工程,从 菜单栏 —> 项目
中打开构建发布面板,在构建发布面板中选择 Facebook Instant Games 平台进行构建:
构建完成后在指定目录下会生成一个 fb-instant-games
文件夹:
二、测试游戏
在 Facebook 后台创建一款新应用,在 添加商品 中添加 小游戏,设置游戏类别,保存更改。(详情可参考 设置应用)
在本地启用支持 https 的 Web 服务器
通过 npm 安装 http-server 包
$ npm install -g http-server
通过 openssl 创建私钥和证书,路径需要指定到构建好的
fb-instant-games
目录$ cd fb-instant-games/ $ openssl genrsa 2048 > key.pem $ openssl req -x509 -days 1000 -new -key key.pem -out cert.pem
私钥和证书准备就绪后,可通过 SSL 在本地启动 Web 服务
$ http-server --ssl -c-1 -p 8080 -a 127.0.0.1
用浏览器打开 https://localhost:8080,跳过浏览器显示的安全警告,这一步仅仅是为了让浏览器把上面的私钥和证书加入白名单。如果后续重新生成了私钥和证书,则需要再次打开确认一次。目前还不能在这一步直接预览游戏,因为预览游戏需要初始化 Facebook Instant Games 的 SDK,需要通过下面的方式。
在 Facebook 域名下预览游戏
如果要使用 Facebook Instant Games SDK 的所有功能,需要用浏览器打开 https://www.facebook.com/embed/instantgames/YOUR_GAME_ID/player?game_url=https://localhost:8080,注意要将链接中的 YOUR_GAME_ID
换成你在 Facebook 后台创建的应用编号。
然后可以看到游戏成功运行:
三、上传到 Facebook
点击应用面板左侧的 小游戏 -> Web Hosting 选项卡,单击 上传版本,将 fb-instant-games
目录下的 .zip
文件上传到 Facebook 托管服务中。
当版本状态更改为 “待命” 时,单击 “★” 按钮将构建版本推送到 “生产环境”。
四、在 Facebook 中分享你的游戏
点击应用面板中的 小游戏 选项卡,选择 详情,在 详情 页面中拉到最下方可看到如下图所示部分,选择 分享游戏,即可将小游戏直接分享到 Facebook 动态消息中。
详细的内容,可参考 测试、发布和分享小游戏。
注意:Facebook 托管存在多项限制,其中最重要的是:
- 不支持服务器端逻辑(例如:php)
- 每次应用程序上传的文件数量不超过 500 个
自定义 Instant Games
开发者可以根据自身需求在 Creator 安装目录的 resources/static/fb-instant-games/
下配置这些文件:
fbapp-config.json
:这是整个包的配置,可前往 官方介绍index.html
:这里可以修改引入的 Facebook Instant Games SDK 版本main.js
:这里可以修改 SDK 初始化与进度条
SDK 说明
Creator 已集成 Facebook 提供的 Instant Games SDK,并且在游戏加载时自动进行了初始化(initializeAsync
及 startGameAsync
)。用户可直接通过 FBInstant
模块访问,使用说明详见 Instant Games SDK。
此外,Facebook 还提供了 Facebook SDK for JavaScript,用于访问 Facebook 的社交功能,可通过 FB
模块访问。不过该 SDK Creator 并没有集成,需要用户手动引入,详见 官方文档。
参考链接
- Cocos Creator 提供的 Instant Games 工程模板(GitHub | Gitee),包含了 Instant Games SDK 使用示例。
- Facebook 后台
- Facebook Instant Games 文档