发布到字节跳动小游戏

字节小游戏是基于字节跳动全产品矩阵开发,不需用户进行下载,点开即玩的全新游戏类型。

小游戏的游戏提交,审核和发布流程等,需要遵守字节官方团队的要求和标准流程,具体信息可以参考文末的链接。

使用 Cocos Creator 3D 发布字节小游戏

  1. 字节官方文档 下载字节开发者工具

  2. 登陆 开发者平台,找到 appid,详情可参考官方详细接入指南

    发布到字节小游戏 - 图1

  3. 构建发布 面板的 发布平台 中选择 字节小游戏,填入小游戏 appid,然后点击 构建

    发布到字节小游戏 - 图2

  4. 打开字节跳动小游戏

    按照这样的流程,项目的 build 目录下就会生成一个字节小游戏的发布包 bytedance-mini-game 文件夹(具体构建任务名为准),打开开发者工具,导入对应文件夹即可。

    发布到字节小游戏 - 图3

构建选项介绍

选项名可选默认值说明
appid必填‘testId’字节小游戏 appid,填写后将会写入在 project.config.json 内。
远程服务器地址选填远程服务器地址,之后将会从该地址获取资源
开放数据域代码目录选填如果存在开放数据域的话,通过这个字段来指定开放数据域文件夹在构建目录中的相对路径,这样在构建过程中就不会覆盖或修改该目录
设备方向必填landscape设备方向,填写后将会写入在 game.json 内。

小游戏环境的资源管理

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

  1. 小游戏的包内体积不能够超过 4MB,包含所有代码和资源,额外的资源必须通过网络请求下载。
  2. 对于从远程服务器下载的文件,小游戏环境没有浏览器的缓存以及过期更新机制。
  3. 对于小游戏包内资源,小游戏环境内并不是按需加载的,而是一次性加载所有包内资源,然后再启动页面。
  4. 不可以从远程服务器下载脚本文件。

这里引出了两个关键的问题,首页面加载速度和远程资源缓存及版本管理。对于首页面加载速度,我们建议用户只保存脚本文件在小游戏包内,其他资源都从远程服务器下载。而远程资源的下载、缓存和版本管理,其实在 Cocos Creator 3D 中,已经帮用户做好了。

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

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

参考链接