ドキュメント

Unity Engine

Unity Engine

Emscripten 用の ウェブ ネイティブプラグイン

Emscripten 用の ウェブ ネイティブプラグイン
読み終わるまでの所要時間 7 分最終更新 5日前

Unity は Emscripten コンパイラーツールチェーンを使用して、C および C++ で書かれた Unity ランタイムコードを WebAssembly (Wasm とも呼ばれます) にクロスコンパイルします。Emscriptenは小さなコードを生成し、ロード時間とメモリ効率に優れ、ネイティブスピードに近い実行速度を目指しています。
Unity は IL2CPP を使用して、C# スクリプトの .NET ゲームコードを Wasm に変換します。IL2CPP は .NET バイトコードを取得し、対応する C++ ソースファイルに変換します。その後、Emscripten を使用してコンパイルされ、スクリプトが Wasm に変換されます。

ターゲットバージョン

Unity は Emscripten コンパイラーを ウェブ プラットプラットフォームパッケージにバンドルしているため、手動でダウンロードする必要はありません。エディターが使用する Emscripten のバージョンは、エディターのバージョンによって異なります。

Unity バージョン

Emscripten バージョン

サポートされるネイティブ プラグイン ファイル形式

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.1へ1.38.11-Unity.bc
Unity 2018.4からUnity 2019.2まで1.37.40-Unity.bc
Unity 2018.2からUnity 2018.4まで1.37.33-Unity.bc
ノート:
  • 以下のリストは、上の表にリストされているファイル形式の略語の拡大を示しています。
    • GNU アーカイブファイル形式 (
      .a
      )
    • WebAssembly オブジェクトファイル (
      .o
      )
    • LLVM ビットコードファイル形式 (
      .bc
      )
  • Emscripten 2.0 より前のバージョンの Emscripten では、Unity は
    Bitcode
    プラグイン (
    .bc
    タイプのファイル) をビルドすることを推奨しています。Emscripten 2.0 以降、Unity では
    Wasm Object File
    プラグインのビルドを推奨しています。これは、
    .o
    タイプの Wasm オブジェクト ファイルで、
    .a
    タイプの GNU アーカイブ ファイルにバンドルされています。
Emscripten ツールチェーンの正確なバージョンへのパスは、次の場所にある
emscripten-version.txt
から確認できます。
C:\Program Files\Unity\Hub\Editor\<Editor version>Editor\Data\PlaybackEngines\WebGLSupport\BuildTools\Emscripten\emscripten\emscripten-version.txt

Emscripten によるネイティブプラグインのコンパイル

Unity アプリケーション用のネイティブ C/C++ プラグインを作成する場合は、C/C++ コードをプロジェクトにバンドルするか (ネイティブプラグイン を参照)、Emscripten コンパイラーツールチェーンを使用してネイティブコードを事前にプラグインアーカイブにビルドできます。
事前にプラグインコードをビルドする場合は、Emscripten コンパイラーツールチェーンを使用する必要があります。LLVMバイナリ形式互換性を確保するため、プラグインのコンパイルに使用されるEmscriptenのバージョンは、Unityが使用するEmscriptenのバージョンと一致する必要があります。
通常、プラグインは静的ライブラリアーカイブ形式にコンパイルされます。Unity 2021.2(Emscripten 2.0)より前のバージョンでは、LLVMビットコード ファイル形式(
.bc
)が推奨されるプラグイン形式です。
Unity 2021.2から、推奨されるプラグイン形式は、
.o
(WebAssemblyオブジェクト ファイル)を含む
.a
(GNUアーカイブ ファイル形式)です。以前の LLVM Bitcode .bc プラグインファイルは引き続きサポートされていますが、使用するとコンパイル時間に悪影響を及ぼす可能性があります。
注
ネイティブプラグインをある Unity バージョンから異なるバージョンの Emscripten を使用するバージョンに移行する場合、LLVM コンパイラープロジェクトはコンパイラーバージョン間のビルドアーティファクトファイルのバイナリ互換性性を保証しないため、Unity では Unity プラグインをソースから再コンパイルすることを推奨しています。

Emscripten ビルドフラグ

WebAssembly 2023 または C/C++ マルチスレッドで使用する WebAssembly オブジェクトファイルをコンパイルする場合は、以下の Emscripten ビルドフラグを含めます。これらのフラグがないと、コードは Unity でビルドされたコードと正しくリンクしない可能性があります。

ターゲット

必須のEmscriptenビルドフラグ

WebAssembly 2023
-msimd128
-fwasm-exceptions
-mbulk-memory
-mnontrapping-fptoint
-msse4.2
-sWASM_BIGINT
-sSUPPORT_LONGJMP=wasm
C/C++ ネイティブマルチスレッド
-pthread

その他のリソース: