Unityコンソールに書き込む

コンソール出力をより細かく制御し、効果的に活用する方法について解説。

コンソールへの出力方法を復習したい場合は、以下のガイドを参照。

Debug.Log("Hello");
Debug.LogWarning("Warning");
Debug.LogError("Error");

Unityにおけるコンソールログ

• Debug.Log: 一般的な情報メッセージの記録に使用。プログラムの流れを追跡するためのデバッグ用途でよく利用される；

• Debug.LogWarning: 警告メッセージの記録に使用。警告は潜在的な問題や予期しない動作を示す；

• Debug.LogError: エラーメッセージの記録に使用。エラーは即時対応が必要な重大な問題やバグを示す。

コンソールパネル

コンソールのクリア

Clear ボタンは、コンソール内のすべての既存ログを削除するために使用。新しいログのみを確認したい場合に便利。

追加オプションにアクセスするには、"Clear" ボタンの横にある矢印をクリック。これらのオプションでは、ビルドの再生やコードの再コンパイル後に自動でログをクリアするようにコンソールを設定可能。

自動クリアオプション

コンソールを自動的にクリアするためのいくつかのオプションを選択可能：

• Clear on Play：ゲームの再生開始時に自動でコンソールをクリア；
• Clear on Build：プロジェクトのビルド時にコンソールをクリア；
• Clear on Recompile：スクリプトの再コンパイル時にコンソールをクリア。

これらのオプションにより、コンソールを最新のログだけに保ち、ゲームのデバッグが容易。

折りたたみ機能

Unityのコンソールにある折りたたみ（Collapse）機能は、メッセージを種類ごとにまとめて整理するためのものです。これにより、同じ種類のメッセージが折りたたみ可能なグループとして表示され、デバッグ時に特定のカテゴリのメッセージに集中しやすくなります。

例えば、同じ種類のログが複数ある場合、それらはまとめてグループ化され、必要に応じて展開または折りたたむことができます。この機能は、大量のログメッセージを効率的に管理する際に特に有用です。

void Start()
{
    for (int i = 0; i < 4; i++)
    {
        Debug.Log(0);
    }
    Debug.Log(0);
}

これは折りたたみ機能をオンにした場合の結果です：

これが、折りたたみ機能をオフにした場合の結果です。

エラーポーズ機能

Error Pause 機能は、Unityでエラーが発生した際に自動的にゲームを一時停止する便利なツールです。これにより、手動でゲームを停止することなく、直ちに問題を確認し、コードのデバッグが可能となります。

この機能を有効にするには、コンソール内の Error Pause ボタンをクリックします。有効化すると、エラーが記録された瞬間にゲームが一時停止し、効率的に問題の調査と解決が行えます。

ログの表示制御とドキュメント

Unityのコンソールでは、ログカウントインジケーターをクリックすることで、ログメッセージの表示を制御できます。これにより、エラー、警告、一般的なログなど、特定の種類のメッセージを表示または非表示にでき、必要な情報に集中しやすくなります。

より詳細な情報やガイダンスについては、Unity公式のコンソールドキュメントを参照してください。コンソールの効果的な活用方法については、Unity Console Documentation をご覧ください。