Version: 2022.1
言語: 日本語
Input in WebGL
WebGL performance considerations

Debug and troubleshoot WebGL builds

Visual Studio doesn’t support debugging Unity WebGL content. Use the following tips to get your build information.

ブラウザの JavaScript コンソール

Unity WebGL doesn’t have access to your file system, so it doesn’t write a log file like other platforms. However, it does write all logging information such as Debug.Log, Console.WriteLine or Unity’s internal logging to the browser’s JavaScript console.

JavaScript コンソールを開くには、以下の手順を行います。

  • Firefox では、Ctrl-Shift-K (Windows)、または Command-Option-K (Mac) を押します。
  • Chrome では、Ctrl-Shift-J (Windows)、または Command-Option-J (Mac) を押します。
  • Safari では、Preferences > Advanced > Develop の順に移動し、Command-Option-C を押します。
  • Microsoft Edge または Internet Explorer で、F12 を押します。

開発ビルド

For debugging purposes, you might want to make a development build in Unity (open the Build Settings window and enabled the Development Build checkbox). Development builds allow you to connect the profiler, and Unity doesn’t minify them, so the emitted JavaScript code still contains human-readable (though C++-mangled) function names. The browser uses these to display stack traces if you run into a browser error, when using Debug.LogError, or when an exception occurs and exception support is disabled. Unlike the managed stack traces that can occur when you have full exception support (see below), these stack traces have mangled names, and contain not only managed code, but also the internal UnityEngine code.

例外のサポート

WebGL にはさまざまなレベルの例外のサポートがあります (WebGL プロジェクトのビルドと実行 を参照)。デフォルトでは、Unity WebGL は明示的にスローされた例外のみをサポートします。Full の例外サポートを有効にすると、IL2CPP によって生成されたコードで追加のチェックを行い、マネージコードの null 参照と範囲外の配列要素へのアクセスをキャッチできます。これらの追加のチェックは、パフォーマンスに著しく影響し、コードサイズや読み込み時間を増加させるので、デバッグにのみ使用してください。

Full の例外サポートは、マネージコードのスタックトレースを生成するための関数名も出力します。このため、スタックトレースは、キャッチできない例外と Debug.Log ステートメントのためのコンソールに表示されます。スタックトレース文字列を取得するには System.Environment.Stacktrace を使用します。

トラブルシュート

問題: ビルドにメモリ不足が発生する

これは一般的な問題で、特に 32 ビットブラウザーで発生します。WebGL のメモリ問題とその修正方法の詳細は、WebGL のメモリ を参照してください。

Problem: Files saved to Application.persistentDataPath don’t persist

Unity WebGL は、セッション間で永続化させる必要のあるすべてのファイル (PlayerPrefs や persistentDataPath に保存されるファイルなど) をブラウザー IndexedDB に保存します。これは非同期 API なので、いつ終了するか分かりません。

以下のコードを呼び出して、メモリから IndexedDB ファイルシステムへの、持続中のファイルシステムの書き込み操作をすべてフラッシュするようにします。

FS.syncfs(false, function (err) {
  if (err) {
    console.log("Error: syncfs failed!"); 
  }
 });

エラーメッセージ: Incorrect header check (誤ったヘッダーチェック)

The browser console log usually prints this error due to incorrect server configuration. For more information on how to deploy a release build, see documentation on Deploying compressed builds.

Error message: Decompressing this format (1) isn’t supported on this platform

The browser console log prints this error when the content tries to load an AssetBundle compressed using LZMA, which Unity WebGL doesn’t support. Re-compress the AssetBundle using LZ4 compression to solve this problem. For more information on compression for WebGL, see documentation on WebGL building, particularly the AssetBundles section.


  • MonoDevelop は 2018.1 以降 Visual Studio に置き換えられました
Input in WebGL
WebGL performance considerations
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961