WebGL アプリケーションのビルド

WebGL 用のビルドを作成するには、Unity のメインメニューから File > Build Settings と移動し、Platform リストで WebGL を選択し Switch Platform をクリックします。

ビルド設定が完了したら、以下のオプションから 1 つを選択します。

• Build はアプリケーションをプレイヤーにビルドします。 Build and Run はアプリケーションをプレイヤーに ビルドし、ターゲットプラットフォームで開きます。

WebGL の Unity ビルドシステムは、以下の設定に対応しています。

Asset Import Overrides の設定変更については、Build Settings を参照してください。

Build フォルダー

Build フォルダーには、以下のファイルが含まれています ([ExampleBuild] は、ターゲットのビルドフォルダーの名を表します)。

ビルドに対して Compression Method を有効にする場合、Unity は圧縮方法に対応する拡張子を識別し、Build サブフォルダー内のファイル名にこの拡張子を追加します。Decompression Fallback を有効にする場合、Unity はビルドのファイル名に .unityweb という拡張子を追加します。それ以外の場合、Unity は、Gzip 圧縮方式の場合は .gz、Brotli圧縮方式の場合は .br という拡張子を加えます。 詳細については、圧縮ビルドとサーバー設定 を参照してください。

Player 設定 内の Name Files As Hashes を有効にすると、Unity はデフォルトのファイル名の代わりに、ファイルコンテンツのハッシュを使用します。これは、ビルドフォルダー内の各ファイルに適用されます。このオプションにより、ゲームビルドの更新版をサーバー上の同じフォルダーにアップロードし、ビルドの反復の間に変更されたファイルのみをアップロードすることができます。

ノート: ファイルシステムから直接プレイヤーを開くと、ブラウザーによっては動作しないことがあります。これは、ローカルファイルの URL に適用されるセキュリティ制限によるものです。

例外を有効にする

Enable Exceptions を使用して、予期しないコードの動作 (エラーとも呼ばれます) をランタイムに処理する方法を指定できます。Enable Exceptions にアクセスするには、WebGL Player Settings の Publishing Settings セクションに移動します。

以下の基本 API を備えています。

• None: 例外に関するサポートを必要としない場合はこれを選択します。これにより、最高のパフォーマンスと最小のビルドが得られます。このオプションでは、例外がスローされるとコンテンツはその設定のままエラーで停止します。
• Explicitly Thrown Exceptions Only (default): これを選択すると、スクリプトの throw ステートメントから明示的に指定された例外をキャッチし、finally ブロックを確実に呼び出します。このオプションを選択すると、スクリプトから生成された JavaScript コードが長く遅くなります。これは、スクリプトがプロジェクトの主なボトルネックになっている場合にのみ問題になります。
• Full Without Stacktrace: これを選択すると以下をキャプチャします。
  • スクリプトの throw ステートメントから明示的に指定された例外 (Explicitly Thrown Exceptions Only オプションと同じ)
  • Null 参照
  • 範囲外の配列アクセス
• Full With Stacktrace: このオプションは上記のオプションと似ていますが、スタックトレースもキャプチャします。 Unity はそれらの確認をコードに埋め込むことでこれらの例外を生成します。そのため、このオプションはパフォーマンスを低下させ、ブラウザーのメモリ使用量を増やします。このオプションはデバッグにのみ使用し、常に 64 ビットブラウザーでテストしてください。