抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发指南
  • 游戏引擎
  • 小游戏平台引擎适配说明
  • Unity 引擎适配
  • 基本
  • 方案概述与能力适配
  • WebGL适配方案
  • 方案概述与兼容性
  • 能力适配
  • 多包融合工具
  • 多包融合工具
  • 最佳实践:SIMD 融合产物打包
  • 问题反馈
  • BGDT 手册
  • Cocos/Laya/Egret引擎适配
  • Godot引擎适配
  • 基础能力
  • 开放能力
  • 性能优化
  • 安全指引
  • SIMD 即单指令多数据,能用一条 CPU 指令同时批量计算多组数据,适合图像、物理这类大量重复运算。团结的测试报告显示,开启 SIMD 对帧率优化明显。
    但 SIMD 在 iOS 16.4 版本才开始支持,所以为了兼容 iOS 16.4 以下的用户,需要在 iOS 16.4 以下的设备上运行非SIMD产物。因此需要生成融合包。
    本文说明如何用团结引擎从同一 Unity 项目构建非 SIMD 包和 SIMD 包,并使用 TTSDK 多包融合工具生成最终融合产物。

      1.操作概览

      1.关闭 SIMD 构建默认包。
      2.基于同一份 Unity 工程和同一提交,仅打开 SIMD 开关,构建 SIMD 条件包。
      3.打开“多包融合工具”,配置两个输入包和输出目录。
      4.执行严格校验,通过后开始融合。
      5.检查融合产物目录结构。

      2.构建前准备

    两次构建应满足:
      •使用团结引擎。只有团结引擎有SIMD配置项。
      •TTSDK 版本最低为 6.9.5。
      •来自同一 Unity 工程。
      •project.config.json 中的 AppID 一致。
      •除 WebAssembly SIMD 开关外,TTSDK、UnityPlugin、资源和业务配置保持一致。
      •分别使用两个全新的输出目录,避免残留旧 Wasm 或 Data 文件。
    示例目录:
    BuildOutput/ ├── non-simd/ ├── simd/ └── merged-simd/(融合后产物)

      3.构建 SIMD 包和非 SIMD 包

      1.在 Player Settings -> Publish Settings 关闭 SIMD,按照正常打包流程出包,比如BuildOutput/non-simd/。
      2.开启 SIMD,按照正常打包流程出包,比如BuildOutput/simd/。确保这两个目录不要互相覆盖。
    现在我们的目录结构为
    BuildOutput/ ├── non-simd/ ├── tt-minigame/ └── simd/ ├── tt-minigame/

      4.配置多包融合工具

    在 Unity 菜单中进入:
    ByteGame → TTSDK Tools → 多包融合工具
    字段介绍:
    配置项
    填写内容
    说明
    默认包路径
    BuildOutput/non-simd/tt-minigame
    非SIMD产物。当然开发者也可把SIMD产物作为默认包,只要后面条件判断正确即可。这里把非SIMD产物作为默认包。
    条件表达式
    capabilities.wasmSimd
    默认的判断条件,生成融合产物后可以在package-selector.js中修改。
    条件包后缀
    simd
    用于说明条件包的特征,在融合后会当做文件夹名称后缀。融合后不要再改文件名。
    条件包路径
    BuildOutput/simd/tt-minigame
    选择 SIMD 构建产物。
    输出目录
    BuildOutput/merged-simd/
    不能与输入目录相同或互相包含。只要是独立的目录即可。
    融合版插件版本
    ​
    ​
    默认值为该TTSDK内置的插件版本(对应game.json的plugin.version)。开发者也可以手动指定版本。
    额外公共路径
    ​
    不同场景包的公共部分。

      5.执行校验与融合

      1.(可选)点击严格校验。
      2.(可选)查看 Console ,修复全部红色错误;黄色警告需确认差异符合预期。
      3.点击开始融合。
      4.等待工具提示融合成功,并打开输出目录。
    常见校验失败原因:
      •两个输入包的 AppID 不一致。
      •wasmcode/ 或 data-package/ 中残留多份历史文件。
      •输入目录和输出目录相同,或目录之间存在包含关系。
      •输入产物缺少 TTSDK 必需文件。

      6.检查融合产物

    标准的 SIMD 两包融合产物结构如下:
    merged-simd/ ├── game.js # 根入口:根据条件选择包 ├── game.json # 根配置:聚合所有分包声明 ├── package-selector.js # 条件判断模块,融合产物独有 ├── project.config.json # 项目配置(使用默认包) ├── images/ # 公共资源(从默认包复制) ├── StreamingAssets/ # 公共 StreamingAssets ├── minigame/ # 默认包(标准包) │ ├── wasmcode/ # 原始包 wasm │ │ └── xxx.webgl.wasm.code.unityweb.wasm │ ├── data-package/ # 数据包 │ │ └── xxx.webgl.data.unityweb.bin │ └── runtime/ # 其他运行时必要文件 │ ├── game.js │ ├── webgl.framework.js │ ├── plugin.config.js │ ├── unity-namespace.js │ └── webgl-wasm-split.js └── minigame-simd/ # 条件包(SIMD 包) ├── wasmcode/ # 条件包分包名加后缀 → wasmcode-simd │ └── xxx.webgl.wasm.code.unityweb.wasm ├── data-package/ # → data-package-simd │ └── xxx.webgl.data.unityweb.bin └── runtime/ # 其他运行时必要文件 ├── game.js ├── webgl.framework.js ├── plugin.config.js ├── unity-namespace.js └── webgl-wasm-split.js
    重点确认:
      •根目录存在 package-selector.js,这是融合产物的识别标志。
      •minigame/ 为非 SIMD 默认包。
      •minigame-simd/ 为 SIMD 条件包。
      •两个场景目录都包含完整的 runtime/、wasmcode/、data-package/ 和 Symbols 文件。

      7.wasm分包

    IDE 从 4.5.7 开始支持融合产物的wasm分包,分包的操作、步骤均和原来一致。
    CLI 从 1.0.10 开始支持,分包命令与原来大体一致,具体可参考 ReadMe 中的样例。
    ​