プロファイラーカウンターの可視化
カスタムプロファイラーモジュールにプロファイラーカウンターを追加する。
読み終わるまでの所要時間 11 分最終更新 5日前
コードに追加したプロファイラーカウンターは、プロファイラーウィンドウまたはアプリケーションのビルドで表示できます。
プロファイラー ウィンドウでのカスタムカウンターの可視化
プロファイラーウィンドウでまたはが生成するデータを表示するには、カスタムプロファイラーモジュールを使用します。これは、他のシステムメトリクスとの関係を視覚的に認識し、パフォーマンスの問題を迅速に特定するのにヘルプます。
ProfilerCounterProfilerCounterValueコードへのメトリクスの追加
以下の例は、GameManager クラスが高レベルのロジックを処理し、敵について知っていることを前提としています。カウンターの値を更新するには、 メソッドまたは メソッドで (ロジックが敵のスポーンまたは破棄とともに実行されるタイミングに応じて)、 メソッドを使用して敵のカウント値をプロファイラーにプッシュします。
UpdateLateUpdateSampleusing UnityEngine;using Unity.Profiling;class GameManager :MonoBehaviour{ Enemy[] m_Enemies; void Update() { GameStats.EnemyCount.Sample(m_Enemies.Length); }}
弾数をプロファイラーに渡すために、この例では弾のライフライフサイクルを管理するスクリプトと仮定しています。その後、ゲーム内の現在の弾の流れに関する正確な情報が得られるに、で値を増やし、値を減らします。
OnDestroyAwakeGameStats.BulletCountusing UnityEngine;using Unity.Profiling;public class Shell :MonoBehaviour{ void Awake() { GameStats.BulletCount.Value += 1; } void OnDestroy() { GameStats.BulletCount.Value -= 1; }}
プロファイラー ウィンドウにカスタムモジュールを追加する
プロファイラーモジュールエディタを使用して、ビルトインまたは新しく追加したカウンターを可視化用に選択します。プロファイラーモジュールエディタを開く
- プロファイラーウィンドウ (ウィンドウ> 分析> プロファイラー) を開きます。
- ウィンドウの左上にあるプロファイラーモジュールのドロップダウンを選択します。歯車のアイコンをクリックすると、プロプロファイラーモジュールエディターが新しいウィンドウで開きます。
- Add を選択し、ウィンドウの右側のユーザー リストから表示するカウンタを選択します。
その後、プロファイラー ウィンドウで他のカウンターと一緒にデータを表示できます。詳細については、カスタムプロファイラーモジュール作成 を参照してください。

Module with custom counters in Profiler Window.
ビルドされたプレイヤーでのプロファイラーカウンターの可視化
ビルドされたプレイヤーでプロジェクトを実行すると、プロファイラー ウィンドウにアクセスできません。ただし、作成したプレイヤーでは、UI 要素としてカウンタをディスプレイできます。つまり、アプリケーションのビルドにプロファイリングツールを含めることができます。
以下の画像は、ビルドされたプレイヤーのカスタムUIを使用して、シーンの左上にカウンターを表示しています。

Tanks game with custom information overlaid
プレイヤーでのカウンター値の取得
プロファイラーカウンターは、重要なゲームまたはエンジンシステムメトリクスに関する情報を提供します。継続的なインテグレーション設定がある場合、またはテスト再生中にアプリケーション内のキーパフォーマンスメトリクスを可視化する場合は、 API を使用してカスタムおよびビルトインプロファイラーのカウンター値を取得できます。
ProfilerRecorder例えば、以下のスクリプトは、フレーム時間、Mono/IL2CPP ヒープサイズ、およびアプリケーションが使用する総メモリー量を表示します。
using System.Collections.Generic;using System.Text;using Unity.Profiling;using UnityEngine;public class StatsScript :MonoBehaviour{ string statsText; ProfilerRecorder systemMemoryRecorder; ProfilerRecorder gcMemoryRecorder; ProfilerRecorder mainThreadTimeRecorder; double GetRecorderFrameAverage(ProfilerRecorder recorder) { var samplesCount = recorder.Capacity; if (samplesCount == 0) return 0; double r = 0; 安全ではない { var samples = stackalloc ProfilerRecorderSample[samplesCount]; recorder.CopyTo(samples, samplesCount); for (var i = 0; i < samplesCount; ++i) r += samples[i].Value; r /= samplesCount; } return r; } void OnEnable() { systemMemoryRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Memory, "System Used Memory"); gcMemoryRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Memory, "GC Reserved Memory"); mainThreadTimeRecorder = ProfilerRecorder.StartNew(ProfilerCategory.Internal, "Main Thread", 15); } void OnDisable() { systemMemoryRecorder.Dispose(); gcMemoryRecorder.Dispose(); mainThreadTimeRecorder.Dispose(); } void Update() { var sb = new StringBuilder(500); sb.AppendLine($"Frame Time: {GetRecorderFrameAverage(mainThreadTimeRecorder) * (1e-6f):F1} ms"); sb.AppendLine($"GC Memory: {gcMemoryRecorder.LastValue / (1024 * 1024)} MB"); sb.AppendLine($"System Memory: {systemMemoryRecorder.LastValue / (1024 * 1024)} MB"); statsText = sb.ToString(); } void OnGUI() { GUI.TextArea(new Rect(10, 30, 250, 50), statsText); }}
エディタのプロファイラーフレームデータからのカウンター値の取得
エディターでプロファイラーフレームデータを処理するときにプロファイラーカウンターの値を取得するには、 API を使用します。
FrameDataViewFrameDataView.GetCounterValueAsIntFrameDataView.GetCounterValueAsLongFrameDataView.GetCounterValueAsFloatFrameDataView.GetCounterValueAsDoubleusing UnityEditor.Profiling;クラス例{ static int ExtractMyCounterValue(FrameDataView frameData, string counterName) { var counterMarkerId = frameData.GetMarkerId(counterName); return frameData.GetCounterValueAsInt(counterMarkerId); }}