プロファイラーモジュールエディター

The Profiler Module Editor is a tool that you can use to add your own custom modules to the Unity Profiler window. You can also add built-in counters to modules, or use the runtime API to add your own custom counters to modules.

特に、より深く分析したい統計情報を絞り込む必要がある場合や、アプリケーションに関するカスタム統計情報を Profiler ウィンドウに加える場合に便利です。

プロファイラーモジュールエディターを使用するには、Profiler ウィンドウを開き (Window > Analysis > Profiler)、Profiler Modules ドロップダウンを選択します。

歯車アイコンを選択すると、プロファイラーモジュールエディター ウィンドウが開きます。ウィンドウには 3 つの列があります。

• Profiler Modules リスト: このリストには、Profiler ウィンドウに追加できる利用可能なモジュールがすべて含まれています。ビルトインモジュールはリスト内でグレーアウトされており、内容を編集できないことを示しています。モジュールをドラッグアンドドロップすると、Profiler ウィンドウでの表示順序を変更できます。独自のカスタムプロファイラーモジュールを作成すると、そのモジュールもこのリストに表示されます。
• Profiler Module 情報ペイン (カスタムモジュールを作成または選択したときのみ表示されます): カスタムモジュールに含まれるカウンターを表示します。
• Available Counters (カスタムモジュールを作成または選択したときにのみ表示されます): カスタムモジュールに追加できる利用可能なカウンターを表示します。

カスタムモジュールの作成

カスタムモジュールを作成するには、プロファイラーモジュールエディターウィンドウの左下にある Add ボタンを選択します。Unity は、New Profiler Module という名前の新しい プロファイラーモジュールをリストに追加します。モジュールの名前を変更するには、テキストフィールドをクリックして、キーボードで名前を設定します。

カウンターをモジュールへ追加

カスタムプロファイラーモジュールでデータを収集するには、モジュールが追跡するためのカウンターを少なくとも 1 つ加える必要があります。Unity のビルトインカウンターを加えることも、ProfilerRecorder API を使用して独自のカウンターを作成してモジュールに加えることもできます。利用可能なカウンターのリストは、 Available Counters ペインに表示されます。

Profiler ウィンドウにデータをロードしないと、作成したカウンターは、プロファイラーモジュールエディターをロードしたときに Available Counters ペインに表示されません。カスタムカウンターを表示するには、作成したカウンターを含むデータをプロファイラーでキャプチャまたはロードして、プロファイラーモジュールエディターを再度開く必要があります。

利用可能な Unity のカウンターは、Memory、Render、Virtual Texturing の 3 つに分かれています。これらのエリアで利用できる特定のカウンターの詳細については、各モジュールのドキュメントを参照してください。

API を使用して独自のカウンターを追加する場合は、まず Profiler ウィンドウにデータをロードまたは収集する必要があります。そうすると、プロファイラーモジュールエディターの User の見出しの下にある Available Counters ペインに、カスタムカウンターが表示されます。

カウンターをモジュールに追加するには、Available Counters リストでカウンターを選択して、 Add Selected ボタンを選択します。また、カウンターをダブルクリックしてモジュールに加えることもできます。Unity は、これらのカウンターを選択した Profiler モジュールに追加します。複数のカウンターを一度にモジュールに加えるには、Shift を押しながら 2 つのカウンターをクリックして 2 つのカウンターの間にあるすべてのカウンターを選択するか、Ctrl (macOS では Command) を押しながら 1 つずつカウンターを選択してから、Add Selected ボタンを選択します。

カウンターの並び替えは、ドラッグアンドドロップで行うことができます。1 つのモジュールに追加できるカウンターの数は最大 10 個です。

カスタムモジュールの使用

カスタムモジュールが完成したら、プロファイラーモジュールエディターウィンドウの右下にある Save Changes ボタンを選択します。Unity がウィンドウを閉じると、Profiler ウィンドウに新しいモジュールが表示されます。

ビルトインモジュールでデータを効果的に使用したり比較するために、Profiler ウィンドウのモジュールの順番を変えることができます。これを行うには、プロファイラーモジュールエディターを開き、Profiler Modules ペインにモジュールをドラッグアンドドロップします。

この機能は、ビルトインの Profiler データのスパイクに対して、アプリケーションのカスタム要素を検査したい場合に特に有効です。