文档

Unity 引擎

Unity 引擎

Emscripten 的 Web 原生插件

Emscripten 的 Web 原生插件。
阅读时间4 分钟最后更新于 5 天前

Unity 使用 Emscripten 编译器工具链将用 C 和 C++ 编写的 Unity 运行时代码交叉编译为 WebAssembly(也称为 Wasm)。Emscripten 生成小代码,具有加载时间和内存效率,旨在提供关闭原生速度的执行。
Unity 使用 IL2CPP 将 C# 脚本中的 .NET 游戏代码转换为 Wasm。IL2CPP 接受 .NET 字节码并将其转换为相应的 C++ 音频源文件,然后使用 Emscripten 进行编译以将脚本转换为 Wasm。

目标版本

Unity 将 Emscripten 编译器器与 Web 包起,因此不必手动Download。Editor 使用的 Emscripten 版本 Editor 版本而异:

Unity 版本

脚本版本

支持的原生插件文件格式

Unity 2023.2 及更高版本Emscripten 3.1.38-Unity.a, .bc
Unity 2022.2 及更高版本Emscripten 3.1.8-Unity.a, .bc
Unity 2021.2 及更高版本Emscripten 2.0.19.6-Unity.a, .bc
Unity 2019.2 到 2021.11.38.11-unity.bc
Unity 2018.4 到 Unity 2019.21.37.40-Unity.bc
Unity 2018.2 到 Unity 2018.41.37.33Unity.bc
注意:
  • 以下列表提供了上表中列出的文件格式缩写的扩展:
    • GNU 存档 File Format (
      .a
      )
    • WebAssembly 对象文件(
      .o
      )
    • LLVM Bitcode File Format(
      .bc
      )
  • 对于 Emscripten 2.0 之前的 Emscripten 版本,Unity 建议构建
    Bitcode
    插件(类型为
    .bc
    的文件)。从 Emscripten 2.0 开始,Unity 建议使用版本
    Wasm Object File
    插件,这些插件是类型为
    .o
    的 Wasm Object 文件,捆绑到类型为
    .a
    的 GNU 存档文件中。
可从位于以下位置的
emscripten-version.txt
确定 Emscripten 工具链的确切版本的路径:
C:\Program Files\Unity\Hub\Editor\<Editor version>\Editor\数据\PlaybackEngines\WebGLSupport\BuildTools\Emscripten\emscripten\emscripten-版本。txt

使用 Emscripten 编译原生插件

如果要为 Unity 应用程序创建原生 C/C++ 插件,可将 C/C++ 代码与 Project 捆绑(请参阅原生插件),或使用 Emscripten 编译器工具链提前将原生代码版本构建到插件存档。
如果选择预先构建插件代码版本,则应使用 Emscripten 编译器工具链。为了确保 LLVM Binary Format 兼容性,用于编译插件的 Emscripten 版本必须与 Unity 使用的 Emscripten 版本 Match。
通常,插件会编译为Static库存档Format。对于 Unity 2021.2 (Emscripten 2.0) 之前的版本,LLVM Bitcode File Format (
.bc
) 是首选插件 Format。
从 Unity 2021.2 开始,首选插件格式是包含 WebAssembly 对象文件 (
.o
) 的 GNU 存档 File Format (
.a
)。虽然仍然支持早期的 LLVM Bitcode .bc 插件文件,但使用这些文件可能会对编译时间产生负面影响。
注意
将原生插件从一个 Unity Version迁移到使用不同 Emscripten 版本的版本When,Unity 建议音频源代码重新编译 Unity 插件,因为 LLVM 编译器Project不能保证版本瑕疵文件在不同编译器版本的Binary进制兼容性。

Emscripten 版本标志

如果编译 WebAssembly 对象文件以便与 WebAssembly 2023 或 C/C++ 多线程一起使用,请包含以下 Emscripten 版本标志。如果没有这些标志,代码可能无法与使用 Unity 构建的代码正确 Link。

目标

必需的 Emscripten 版本标志

WebAssembly 2023
-msimd128
-fwasm-exceptions
-mbulk-memory
-mnontrapping-fptoint
-msse4.2
-sWASM_BIGINT
-sSUPPORT_LONGJMP=wasm
C/C++ 原生线程
-pthread

其他资源