[UNITY]2DRPG開発日誌 #83 『Extended Debug Logs』ドキュメント日本語訳

このページは、UNITYのアセット『Extended Debug Logs』に同梱されているPDFファイルをDeepL翻訳したものです。

1. Get started quickly

新しいロギングを使用したいコード内の任意の場所で、まず "DTT.ExtendedDebugLogs" 名前空間をインポートしてください。

これにより、より良いロギングを可能にする様々なメソッドを含むDebugEx静的クラスを利用することができます。

これは、標準のUnity「Debug」が含むすべてのものを含んでいます。

推奨されるメソッドは、「LogArray」、「LogDictionary」または「LogObject」です。

すべての可能性については、APIセクションを参照してください。

すべてのログは、ログを「タグ付け」することができるように追加の引数を取ることができるようになりました、セットアップセクションでこれについての詳細を参照してください。

Extended Debug Logsは、開発者がデバッグログを次のレベルに引き上げるためのアセットです。

ログを分類し、タグ付けすることができます。

これらの分類により、対象となるログのロギングを有効または無効にすることができます。

この主な利点は、ログを所定の場所に保管できるようになり、ログを無効にすることができるため、ログを掃除する必要がないことです。

そして、将来、何かが期待通りに動作しなくなったときに、ログを有効にして、問題の原因がどこにあるのかを効果的に特定することができます。

メソッド名	引数	説明
LogArray	T[] array object message Tag tag (optional) Object context (optional)	指定された配列を1つのデバッグメッセージとしてログに記録します。
LogDictionary	Dictionary dictionary object message Tag tag (optional) Object context (optional)	提供された辞書を、すべてのキーと値のペアを持つ単一のデバッグメッセージに記録します。
LogEnumerable	IEnumerable enumerable object message Tag tag (optional) Object context (optional)	IEnumerable インターフェースを実装したオブジェクトをログに記録します。ほとんどのコレクションはこのインターフェイスを実装しているので、おそらくあなたが出会ったどんなコレクションでもログを記録することができるだろうことに注意してください。
LogList	List list object message Tag tag (optional) Object context (optional)	提供されたリストを1つのデバッグメッセージとしてログに記録します。
LogObject	T object object message Tag tag (optional) Object context (optional)	与えられたオブジェクトのすべてのフィールド（パブリックおよびプライベート）をログに記録します。注意：これはリフレクションを利用しているため、パフォーマンスに影響を与える可能性があります。

メソッド名	引数	説明
LogEx	this T obj object message Tag tag (optional) Object context (optional)	提供されたオブジェクトを1つのデバッグメッセージに記録する。これは拡張メソッドであるため、このメソッドはオブジェクトそのものになります。

メッセージが記録された後にタグを無効化しても、メッセージは非表示になりません。

（省略）