# 团结小游戏多线程使用说明
# 简介
团结引擎已支持小游戏新版 worker 进行并行渲染,将渲染工作分离到 worker 里进行处理,降低主线程压力。
目前支持两种渲染线程:
- 并行渲染
- RHI 渲染
两种都依赖小游戏新版worker的offscreencanvas 能力。
# 接入指南
# 打开渲染多线程
勾选 Parallel Rendering 或者 Multithreaded rendering(二选一),然后正常导出即可
需要更新转换插件到最新版本。
# 多包构建与合并
在开启并行渲染后,导出的包依赖运行环境支持多线程,不能单独发布,需要同时构建单线程包,两个包合并后一起发布,因此我们另外提供了多包融合工具,方便进行合包发布。
推荐流程:
- 导出单线程包
- 导出多线程包
- 使用多包融合工具合包
- 上传融合后的包
- 运行时根据环境能力自动选择单线程或多线程包
最终效果:
- 支持多线程能力的环境加载多线程包。
- 不支持多线程能力的环境加载单线程包。
- 开发者只需要上传一个融合后的小游戏包。
具体融合见多包融合说明文档
# 常见问题
# 只上传多线程包可以吗?
不建议。多线程能力对基础环境有版本要求。
# 合包失败提示 project.config.json 冲突怎么办?
说明单线程包和多线程包的 project.config.json 中存在不一致的关键字段。请先统一两个包的小游戏项目配置,然后重新导出并合包。
# 融合后的包能否支持wasm分包?
目前不支持。需要先做wasm分包,再做多包融合。