发布到字节跳动小游戏

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

小游戏的游戏提交，审核和发布流程等，需要遵守字节官方团队的要求和标准流程，具体信息可以参考 字节跳动小游戏接入指南。

准备工作

  1. 下载 字节跳动开发者工具 并安装。

  2. 参考 字节跳动小游戏接入指南，在 字节跳动开发者平台 完成账号注册、登录以及申请小游戏。

  3. 小游戏申请通过后，在开发者平台的 开发管理 -> 开发设置 中找到 AppID。

    appid

发布流程

  1. 使用 Cocos Creator 打开需要发布的项目工程，从 菜单栏 -> 项目 中打开 构建发布 面板。在 构建发布 面板的 发布平台 中选择 字节跳动小游戏。

    build

    通用构建选项的设置请参考 通用构建选项，字节跳动小游戏特有的构建选项如下，具体说明请参考下文 构建选项 部分的内容。

    bytedance-options

  2. 构建发布 面板的构建选项设置完成后，点击 构建。
    构建完成后点击 构建任务 左下角的文件夹图标按钮打开项目发布包，可以看到在默认发布路径 build 目录下生成了 bytedance-mini-game（以具体的构建任务名为准）文件夹，其中已经包含了字节跳动小游戏环境的配置文件 game.json 和 project.config.json。

    package

  3. 使用 字节跳动开发者工具 打开构建生成的 bytedance-mini-game 文件夹，即可打开字节跳动小游戏项目及预览调试游戏内容。开发者工具的具体使用方式请参考 字节跳动开发者工具介绍。

    tool

构建选项介绍

构建选项说明字段名（用于命令行发布）
初始场景分包勾选后，首场景及其相关的依赖资源会被构建到发布包目录 assets 下的内置 Asset Bundle — start-scene 中，提高初始场景的资源加载速度。startSceneAssetBundle
设备方向可选值包括 Portrait 和 Landscape。构建时会写入到发布包目录下的 game.json 文件中orientation
AppID必填项，字节跳动小游戏的 AppID，构建时会写入到发布包目录下的 project.config.json 文件中。appid
资源服务器地址用于填写资源存放在远程服务器上的地址。开发者需要在构建后手动将发布包目录下的 remote 文件夹上传到所填写的资源服务器地址上。详情请参考 上传资源到远程服务器remoteServerAddress
生成开放数据域工程模板用于接入开放数据域，详情请参考 开放数据域buildOpenDataContextTemplate

分包加载

分包加载，即把游戏内容按一定规则拆分在几个包里，在首次启动的时候只下载必要的包，这个必要的包称为 主包，开发者可以在主包内触发下载其他子包，这样可以有效降低首次启动的消耗时间。若要使用该功能需要在 Creator 中设置 小游戏分包，设置完成后在构建时就会自动分包。

字节跳动小游戏需要特定的版本才能支持分包功能，字节产品的版本要求如下：

产品AndroidiOS
抖音v13.6.0v13.7.0
头条v7.9.9v7.9.8

字节开发者工具使用的版本请大于等于 2.0.6，小于 3.0.0。调试基础库则要求在 1.88.0 及以上。

注意：若产品的版本不支持分包加载，则引擎会将分包作为一个普通的 Asset Bundle 加载。

目前小游戏分包大小有以下限制：

  • 整个小游戏的所有分包大小不超过 16 M
  • 单个分包/主包的大小不能超过 4 M

具体可参考 字节跳动小游戏分包加载官方文档

小游戏环境的资源管理

字节跳动小游戏与微信小游戏类似，都存在着包体限制，超过 4MB 的额外资源，必须通过网络请求下载。

我们建议用户只保存脚本文件在小游戏包内，其他资源都从远程服务器下载。Cocos Creator 已经帮用户做好了远程资源的下载、缓存和版本管理，详情可参考 缓存管理器。

参考链接