Version: 2023.1
言語: 日本語
カスタムのプロファイラーカウンターの作成
プロファイラーモジュールエディター

カスタムプロファイラーモジュールの作成

カスタムプロファイラーモジュールは、システムのパフォーマンスデータを Profiler ウィンドウに表示します。

カスタムプロファイラーモジュールは、以下のいずれかの方法で作成できます。

パッケージによっては、カスタムプロファイラーモジュールが含まれており、その特定のパッケージをインストールするときに使用することができます。詳細については、プロファイラーモジュールリスト を参照してください。

カスタムモジュールは、コードで指定したカウンターを Profiler ウィンドウのチャートビュー (A) に表示し、カウンターはモジュールの詳細パネル (B) にリストとして表示されます。

Profiler Module エディターを使用したカスタムプロファイラーモジュールの作成

Unity のビルトイン Profiler Module エディターを使用して、カスタムのプロファイラーモジュールを作成することができます。詳しくは、Profiler Module エディターのドキュメントセクション カスタムモジュールの作成 を参照してください。

カスタムプロファイラーモジュールをコードで作成

カスタムプロファイラーモジュールをコードで作成するには、新しい ProfilerModule スクリプトを作成し、表示するカウンター、名前、アイコンなどのモジュールのプロパティを定義する必要があります。

カスタムプロファイラーモジュールを定義するには、スクリプトで以下のことを行う必要があります。

  1. プロジェクトまたはパッケージの ProfilerModule から派生したクラスを定義します。以下の例では、クラス名を TankEffectsProfilerModule とします。
public class TankEffectsProfilerModule : ProfilerModule
  1. このクラスにProfilerModuleMetadata 属性を割り当て、属性の引数にモジュールの表示名を指定します。以下の例では、表示名を “Tank Effects” としています。
[ProfilerModuleMetadata("Tank Effects")]
  1. パラメーターを持たないコンストラクターを実装し、チャートカウンター説明のリストを基本コンストラクターに渡します。以下の例では、パラメーターを持たないコンストラクターは 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 ウィンドウで表示するには、以下を行います。

  1. Profiler をアプリケーションに接続します。詳細については、アプリケーションのプロファイル を参照してください。
  2. アプリケーションを実行します。

アプリケーションが再生モードのときにもプロファイラーを実行することもできます。しかし、再生モードでアプリケーションをプロファイリングすると、プロファイラーは、ハードウェアデバイス上でアプリケーションをビルドする場合のアプリケーションの実行を表すものではないデータを表示します。

カスタムのプロファイラーカウンターの作成
プロファイラーモジュールエディター