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
- GNU アーカイブファイル形式 (
-
Emscripten 2.0 より前のバージョンの Emscripten では、Unity はプラグイン (
Bitcodeタイプのファイル) をビルドすることを推奨しています。Emscripten 2.0 以降、Unity では.bcプラグインのビルドを推奨しています。これは、Wasm Object Fileタイプの Wasm オブジェクト ファイルで、.oタイプの GNU アーカイブ ファイルにバンドルされています。.a
Emscripten ツールチェーンの正確なバージョンへのパスは、次の場所にあるから確認できます。
emscripten-version.txtC:\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ビットコード ファイル形式()が推奨されるプラグイン形式です。
.bcUnity 2021.2から、推奨されるプラグイン形式は、(WebAssemblyオブジェクト ファイル)を含む(GNUアーカイブ ファイル形式)です。以前の LLVM Bitcode .bc プラグインファイルは引き続きサポートされていますが、使用するとコンパイル時間に悪影響を及ぼす可能性があります。
.o.aEmscripten ビルドフラグ
WebAssembly 2023 または C/C++ マルチスレッドで使用する WebAssembly オブジェクトファイルをコンパイルする場合は、以下の Emscripten ビルドフラグを含めます。これらのフラグがないと、コードは Unity でビルドされたコードと正しくリンクしない可能性があります。
ターゲット | 必須のEmscriptenビルドフラグ |
|---|---|
| WebAssembly 2023 | |
| C/C++ ネイティブマルチスレッド | |