スタックトレース

Unity のログファイルとコンソールに表示されるスタックトレース情報のレベルを設定し、スクリプトの問題を追跡するのにヘルプます。

読み終わるまでの所要時間 8 分

最終更新 3日前

Unity コンソールのメッセージとログファイルには、詳細なスタックトレース情報を含めることができます。コンソールは、メッセージを生成したコード行にもリンクします。これは、ログエントリーが表示される原因となった行、メソッド、または一連の関数呼び出しを識別する場合に便利です。

ヒント

コードを検査するもう 1 つの方法は、エディターまたはビルドされたプレイヤーにデバッガーをアタッチ、設定、添付することです。

マネージコードとアンマネージコードのスタックトレース

Unity はマネージコードとアンマネージコードの両方のスタックトレース情報を提供できます。

**マネージコード:**Unity で実行されるマネージ DLL または C# スクリプト。Unity に同梱されているスクリプト、独自に作成したカスタムスクリプト、アセットストアプラグインに含まれているサードパーティのスクリプト、エンジン内で実行されるその他の C# スクリプトなどです。
**アンマネージコード:**ネイティブ Unity エンジンコード、またはマシン上やターゲットビルドプラットフォーム上で直接実行されるネイティブプラグインのコード。アンマネージコードは通常、C または C++ コードからコンパイルされます。ネイティブバイナリの元のソースコードがある場合にのみアクセスできます。通常、アンマネージコードにスタックトレースを使用するのは、エラーの原因がコードにあるのかエンジンコードにあるのか、またエンジンコードのどの部分にあるのかを判断する必要がある場合だけです。

Unity には 3 つのスタックトレースオプションがあります。

これらのスタックトレースオプションは、ログメッセージタイプごとに個別に設定できます。エラー、アサート、注意、ログ、例外。

スタックトレース、特に完全なスタックトレースの解決は、リソースに負荷がかかる操作です。スタックトレースのベストプラクティスは次のとおりです。

スタックトレースオプションは、以下の方法で設定できます。

コンソールウィンドウのメニューから：
- すべてのログメッセージタイプにスタックトレースオプションを選択するには、［Stack Trace Logging］＞ ［All］ に移動し、すべてのログメッセージタイプにスタックトレースオプションを選択します。
- 1 種類のログメッセージにスタックトレースオプションを選択するには、スタックトレースロギング> MESSAGE TYPE に移動し、そのログメッセージタイプのスタックトレースオプションを選択します。
プレイヤー設定ウィンドウから:
- 編集>
  プロジェクト設定
  ?
  > プレイヤー> その他の設定に移動します。
- 「スタックトレース」の下のチェックボックスを使用して、さまざまなログメッセージタイプのスタックトレースオプションを設定します。
コードから、
```
Application.SetStackTraceLogType
```
メソッドを使用。

注

スタックトレースオプションへの変更は、エディターですぐにエフェクトが反映されますが、ビルドされたプレイヤーでエフェクトを有効にするには、アプリケーションをリビルドする必要があります。

メッセージの全文には、リンク付きのコードファイル内の特定の行への参照が含まれます。リンクをクリックすると、参照されている行のファイルが IDE で開きます。

ビルドされたアプリケーションはコンソールに出力されません。スタックトレースを確認するには、アプリケーションのログファイルを使用します。