カスタムプロファイラーモジュールの作成
カスタムプロファイラーモジュールは、システムのパフォーマンスデータを Profiler ウィンドウに表示します。
カスタムプロファイラーモジュールは、以下のいずれかの方法で作成できます。
パッケージによっては、カスタムプロファイラーモジュールが含まれており、その特定のパッケージをインストールするときに使用することができます。詳細については、プロファイラーモジュールリスト を参照してください。
カスタムモジュールは、コードで指定したカウンターを Profiler ウィンドウのチャートビュー (A) に表示し、カウンターはモジュールの詳細パネル (B) にリストとして表示されます。
Profiler Module エディターを使用したカスタムプロファイラーモジュールの作成
Unity のビルトイン Profiler Module エディターを使用して、カスタムのプロファイラーモジュールを作成することができます。詳しくは、Profiler Module エディターのドキュメントセクション カスタムモジュールの作成 を参照してください。
カスタムプロファイラーモジュールをコードで作成
カスタムプロファイラーモジュールをコードで作成するには、新しい ProfilerModule スクリプトを作成し、表示するカウンター、名前、アイコンなどのモジュールのプロパティを定義する必要があります。
カスタムプロファイラーモジュールを定義するには、スクリプトで以下のことを行う必要があります。
- プロジェクトまたはパッケージの ProfilerModule から派生したクラスを定義します。以下の例では、クラス名を
TankEffectsProfilerModuleとします。
public class TankEffectsProfilerModule : ProfilerModule
- このクラスにProfilerModuleMetadata 属性を割り当て、属性の引数にモジュールの表示名を指定します。以下の例では、表示名を “Tank Effects” としています。
[ProfilerModuleMetadata("Tank Effects")]
- パラメーターを持たないコンストラクターを実装し、チャートカウンター説明のリストを基本コンストラクターに渡します。以下の例では、パラメーターを持たないコンストラクターは
TankEffectsProfilerModule()、チャートカウンター説明のリストはk_Counters、基本コンストラクターはbaseとなっています。
static readonly ProfilerCounterDescriptor[] k_Counters = new ProfilerCounterDescriptor[].
{
new ProfilerCounterDescriptor(GameStatistics.TankTrailParticleCountName, GameStatistics.TanksCategory),
new ProfilerCounterDescriptor(GameStatistics.ShellExplosionParticleCountName, GameStatistics.TanksCategory),
new ProfilerCounterDescriptor(GameStatistics.TankExplosionParticleCountName, GameStatistics.TanksCategory)。
};
public TankEffectsProfilerModule() : base(k_Counters) { }.
Profiler ウィンドウにカスタムプロファイルモジュールを表示
カスタムプロファイラーモジュールを定義すると、Profiler ウィンドウはそれを自動的に検出します。カスタムロファイラーモジュールのデータを Profiler ウィンドウで表示するには、以下を行います。
- Profiler をアプリケーションに接続します。詳細については、アプリケーションのプロファイル を参照してください。
- アプリケーションを実行します。
アプリケーションが再生モードのときにもプロファイラーを実行することもできます。しかし、再生モードでアプリケーションをプロファイリングすると、プロファイラーは、ハードウェアデバイス上でアプリケーションをビルドする場合のアプリケーションの実行を表すものではないデータを表示します。