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

Unity では Emscripten コンパイラー ツールチェーンを使用して Unity ランタイムコード (C および C++ で記述されています) を WebAssembly (Wasm とも呼ばれます) にクロスコンパイルしています。Emscripten は小さなコードを生成し、ロード時間とメモリ効率に優れ、ネイティブスピードに近い実行速度を目指しています。

Unity は IL2CPP を使用して、C# スクリプトの .NET ゲームコードを Wasm に変換します。IL2CPP は .NET バイトコードを取得し、それを対応する C++ ソースファイルに変換し、Emscripten を使用してスクリプトを Wasm に変換します。

ターゲットとなるバージョン

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

注:

• 以下のリストは、上の表にリストされているファイル形式の略語の意味を示しています。

  • GNU アーカイブファイル形式 (.a)
  • WebAssembly Object File (.o)
  • LLVM Bitcode ファイル形式 (.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 Bitcode ファイル形式 (.bc) が推奨されるプラグイン形式です。

Unity 2021.2 以降では、推奨されるプラグイン形式は、WebAssembly Object File (.o) を含む GNU アーカイブファイル形式 (.a) です。以前の LLVM Bitcode .bc プラグインファイルは引き続きサポートされていますが、使用するとコンパイル時間に悪影響を及ぼす可能性があります。

注意ネイティブプラグインをある Unity バージョンから異なるバージョンの Emscripten を使用する Unity バージョンに移行する場合、LLVM コンパイラープロジェクトはコンパイラーバージョン間のビルドアーティファクトファイルのバイナリ互換性を保証しないため、Unity では Unity プラグインをソースから再コンパイルすることを推奨しています。

Emscripten ビルドフラグ

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

その他の参考資料

• ネイティブプラグイン