ドキュメント

Unity Engine

Unity Engine

プロファイラーカウンターリファレンス

ビルトインプロファイラーカウンターのリファレンス
読み終わるまでの所要時間 43 分最終更新 5日前

Unity にはビルトインプロファイラーカウンターがあり、カスタムプロファイラーモジュールでメトリクスの収集とディスプレイに使用できます。以下の表は、使用可能なビルトインプロプロファイラーカウンターのアウトラインです。この情報は、
ProfilerRecorder
API とプロファイラーモジュールエディタでも得られるため、カスタムプロファイラーモジュールに追加できます。以下の表は、Unity で使用可能なプロファイラーカウンターのリストです。

ファイルアクセスプロファイラーカウンター

使用可能なファイルアクセスプロプロファイラーカウンターと、リリース (開発以外) のプレイヤーで使用可能かどうかは以下の通りです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

File Bytes Read選択されたフレーム中に Unity がこのファイルから読み取った情報の合計バイト数。Unavailable (使用不可)
File Bytes Write (書き込まれたファイルバイト)選択されたフレーム中に Unity がこのファイルに書き込んだ情報の合計バイト数。Unavailable (使用不可)
開いているファイルハンドルこのフレーム中の任意の時点で開いているファイルハンドルの総数。Unity が同じフレーム内で開いたり閉じたりするファイルも含まれます。Unavailable (使用不可)
ファイルの読み取りが終了しましたこのフレームで完了したファイル読み込みの数Unavailable (使用不可)
ファイルの読み取りが開始しましたこのフレーム中に開始されたファイル読み込みの数Unavailable (使用不可)
ファイルシークこのフレームにローカル ファイル システムで実行されたファイル シーク操作の数。ファイルシーク操作には、ファイルのコンテンツ内の検索が含まれます。Unavailable (使用不可)
閉じられたファイルこのフレームでローカル ファイル システムで正常に閉じられたファイルの総数。Unavailable (使用不可)
開かれたファイルこのフレームでローカル ファイル システムで正常に開かれたファイルの総数。Unavailable (使用不可)
飛行中の読み取りこのフレームで進行中の読み取り操作の総数。Unavailable (使用不可)
ファイルアクセスデータの収集の詳細については、ファイルアクセスプロファイラーモジュールリファレンスを参照してください。

アセット読み込みプロファイラーカウンター

リリース (開発以外) のプレイヤーで使用可能なアセットローディングプロファイラーカウンターと可用性は次のとおりです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

オーディオ読み取りオーディオのロードのために AsyncReadManager からリクエストされたバイト数Unavailable (使用不可)
Entities ReadsEntities パッケージ内のスクリプトによって AsyncReadManager から要求されたバイト数。Unavailable (使用不可)
Mesh Readsメッシュのロードのために AsyncReadManager からリクエストされたバイト数Unavailable (使用不可)
その他の読み取り不特定のサブシステムのために AsyncReadManager からリクエストされたバイト数Unavailable (使用不可)
スクリプティング読み取りスクリプティング API を介して AsyncReadManager から要求されたバイト数。Unavailable (使用不可)
テクスチャ読み取りテクスチャのロードのために AsyncReadManager からリクエストされたバイト数Unavailable (使用不可)
仮想テクスチャ読み取り仮想テクスチャリングのために AsyncReadManager から要求されたバイト数。Unavailable (使用不可)
アセットデータの収集の詳細については、アセットロードプロファイラーモジュールリファレンスを参照してください。

Memory Profilerカウンター

以下の表は、使用可能な Memory Profiler カウンターとリリース (開発以外) のプレイヤーでの可用性の概要を示しています。
ヒント
Object.FindObjectsByType
メソッドを使用して特定のタイプのオブジェクトを検索してから、この情報を
Profiler.GetRuntimeMemorySizeLong
に渡してメモリ量を取得し、リリースプレイヤーに実装できます。例えば、Mesh Count や Mesh Memory のカウンターを取得するには、
Object.FindObjectsByType<Mesh>().length
and then pass these entries to
GetRunTimeMemorySizeLong
. Only use
Find
とその関連 API を開発コードで使用します。
GetRunTimeMemorySizeLong
はパフォーマンスに影響を与え、リリースビルドではグラフィックスメモリ量は提供されません。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

AnimationClip Countロードされたアニメーションクリップの総数Unavailable (使用不可)
AnimationClip メモリメモリロードされたアニメーションクリップの総量(バイト単位)Unavailable (使用不可)
アプリ専用メモリプラットフォームのオペレーティング システムに応じたコミットされたメモリの総量(バイト単位)。使用可能
アプリ常駐メモリプラットフォームのオペレーティング システムに応じた常駐メモリの総量(バイト単位)。使用可能
アセット数読み込まれたアセットの総数Unavailable (使用不可)
オーディオ予約されたメモリオーディオシステムの推定予約されたメモリ(バイト単位)。使用可能
オーディオ使用メモリオーディオシステムの推定メモリ使用量(バイト単位)。使用可能
AudioClip Countロードされた AudioClip の総数Unavailable (使用不可)
AudioClip メモリメモリロードされた AudioClip の総使用量 (バイト)Unavailable (使用不可)
ゲームオブジェクト数シーンのゲームオブジェクトインスタンスの総数。Unavailable (使用不可)
GC Allocated In Frame選択したフレームのマネージアロケーションの合計サイズ (バイト)。Unavailable (使用不可)
GC アロケーション イン フレーム カウント選択したフレームのマネージアロケーションの数。Unavailable (使用不可)
GC 予約されたメモリマネージコードに予約されたヒープサイズの合計 (バイト)。このメモリはガベージコレクションされます。使用可能
GC Used Memoryマネージコードが使用するヒープサイズ (バイト単位)。このメモリはガベージコレクションされます。使用可能
Gfx 予約されたメモリテクスチャ、レンダリングするゲット、シェーダー、データの予約された済みメモリの推定量 (バイト)。Unavailable (使用不可)
Gfx Used Memoryドライバーがテクスチャ、レンダリングするゲット、シェーダー、データに使用する推定メモリ量 (バイト)。Unavailable (使用不可)
Material count (マテリアル数)読み込まれたマテリアルの総数Unavailable (使用不可)
マテリアルメモリメモリにロードされたマテリアルの総使用量 (バイト単位)。Unavailable (使用不可)
メッシュ数ロードされたメッシュの総数Unavailable (使用不可)
メッシュメモリメモリロードされたメッシュの総使用量 (バイト単位)。Unavailable (使用不可)
オブジェクト数アプリケーションのネイティブオブジェクトインスタンスの数。Unavailable (使用不可)
物理演算使用メモリ物理演算システムが使用したメモリの総量(バイト単位)。Unavailable (使用不可)
物理演算予約されたメモリ(2D)2DD 物理演算システムが予約されたしたメモリの総量 (バイト単位)。Unavailable (使用不可)
プロファイラー予約されたメモリプロファイラー機能がシステムから予約するメモリ (バイト単位)。使用可能
プロファイラー使用メモリプロファイラー機能が使用するメモリ (バイト単位)。使用可能
シーンオブジェクト数動的
UnityEngine.Object
インスタンスの総数。この数には、ゲームオブジェクト数カウンターに加え、コンポーネントの総数、およびシーン内のアセット以外のすべてが含まれます。
Unavailable (使用不可)
System Total Used Memoryデバイス上で実行されているすべてのアプリケーションによって使用されている合計メモリ(バイト単位)。使用可能
System Used Memoryプラットフォームのオペレーティング システムに応じた常駐メモリの総量(バイト単位)。この値は、アプリ常駐メモリの値と同じです。使用可能
Texture count (テクスチャ数)読み込まれたテクスチャの総数Unavailable (使用不可)
テクスチャメモリメモリにロードされたテクスチャの総量 (バイト単位)。Unavailable (使用不可)
予約された合計メモリオペレーティング システムでアプリケーションに予約された合計メモリ(バイト単位)。使用可能
Total Used Memory (合計使用メモリ)アプリケーションが使用した合計メモリ (バイト)。使用可能
ビデオ予約されたメモリビデオシステムの推定予約されたメモリ (バイト単位)。使用可能
ビデオ使用メモリビデオシステムの推定メモリ使用量 (バイト単位)。使用可能
メモリデータの収集の詳細については、「 Memory Profiler モジュール 」を参照してください。

物理演算プロファイラー カウンタ

リリース (開発以外) のプレイヤーで使用可能な物理演算プロファイラーカウンターと可用性は次のとおりです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

アクティブな制約物理演算システムが処理したプリミティブ制約の数。Unavailable (使用不可)
アクティブ動的ボディスリープステートではない Rigidbody コンポーネントと
ArticulationBody
コンポーネントの数。
Unavailable (使用不可)
アクティブなキネマティックなボディアクティブな Kinematic Rigidbody コンポーネントの数Unavailable (使用不可)
連結ボディシーン内の
ArticulationBody
コンポーネントの数
Unavailable (使用不可)
ブロードフェーズ追加ブロードフェーズ アルゴリズムによって追加されたコライダーの総数。Unavailable (使用不可)
ブロードフェーズ追加/削除ブロードフェーズ アルゴリズムが追加または削除したコライダーの総数。Unavailable (使用不可)
ブロードフェーズ削除ブロードフェーズ アルゴリズムによって削除されたコライダーの総数。Unavailable (使用不可)
Colliders SyncedTransform と同期しているコライダーの数。Unavailable (使用不可)
継続的なオーバーラップUnity が連続型衝突判定を使用して解決した重複イベントの数。Unavailable (使用不可)
個別のオーバーラップUnity が離散型衝突判定を使用して解決した重複イベントの数。Unavailable (使用不可)
動的ボディ
Rigidbody
コンポーネントと
ArticulationBody
コンポーネントの数。
Unavailable (使用不可)
変更された重複Unity が接触修正 API を使用して変更した重複イベントの数。Unavailable (使用不可)
ナローフェーズ ロスト タッチ前のフレーム以降に失われた衝突イベントの総量。Unavailable (使用不可)
ナローフェーズ新規タッチ前のフレーム以降に新規として発生した衝突イベントの総量。Unavailable (使用不可)
ナローフェーズタッチ前のフレーム以降に失われた、または新しく発生した衝突イベントの総量。Unavailable (使用不可)
Overlaps重複イベントの数重複イベントは、コライダーが互いに重なることです。Unavailable (使用不可)
物理演算クエリレイキャストやシェイプキャストなどの物理演算クエリの総量。Unavailable (使用不可)
リジッドボディの同期Transform と同期している Rigidbody コンポーネントの数Unavailable (使用不可)
静的コライダーRigidbody コンポーネントまたは ArticulationBody コンポーネントを持たないコライダーの数Unavailable (使用不可)
トリガー オーバーラップトリガー コライダーとの重複イベントの数(ペアでカウント)。Unavailable (使用不可)
物理演算データの収集の詳細については、物理演算プロファイラーモジュール リファレンスを参照してください。

2D 物理演算プロファイラーカウンター

使用可能な 2D 物理演算プロファイラーカウンターとリリース (開発以外) のプレイヤーで使用可能なものは次のとおりです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

追加された連絡先このフレームで追加されたコンタクトの数。これには衝突接触とトリガー接触の両方が含まれます。Unavailable (使用不可)
スリープボディこのフレームでスリープ状態 (スリープ状態ではない) で存在していた Rigidbody2D の数。Unavailable (使用不可)
スリープシェイプこのフレームでスリープ状態(Awake ではない)で存在した物理演算形状の数。Unavailable (使用不可)
Awakebodyこのフレームで起きていて存在した Rigidbody2D の数Unavailable (使用不可)
Awake シェイプこのフレームで発生し、存在した物理演算形状の数。Unavailable (使用不可)
ブロードフェーズペアこのフレームで物理演算演算システムが処理したブロードフェーズの数。Unavailable (使用不可)
ブロードフェーズアップデートこのフレームで物理演算システムが処理したブロードフェーズ更新の数。Unavailable (使用不可)
衝突エンターこのフレームで物理演算システムが呼び出した OnCollisionEnter2D コールバックの数。Unavailable (使用不可)
衝突出口このフレームで物理演算システムが呼び出した OnCollisionExit2D コールバックの数。Unavailable (使用不可)
衝突停止このフレームで物理演算システムが呼び出した OnCollisionStay2D コールバックの数。Unavailable (使用不可)
連続ボディこのフレームに存在した
Continuous
衝突判定モードの Rigidbody2D の数。
Unavailable (使用不可)
Discrete Bodiesこのフレームに存在した
Discrete
衝突判定モードの Rigidbody2D の数。
Unavailable (使用不可)
動的ボディこのフレームに存在した
Dynamic
ボディタイプの Rigidbody2D の数。
Unavailable (使用不可)
動的形状
Dynamic
であり、かつこのフレームに存在した物理演算形状の数。
Unavailable (使用不可)
GetContacts クエリ物理演算システムがこのフレームで呼び出した接触取得クエリの数。これには、
Physics2D.GetContacts
、
Collider2D.GetContacts
、
Rigidbody2D.GetContacts
などのクエリが含まれます。
Unavailable (使用不可)
IsTouching クエリ物理演算システムがこのフレームで呼び出した接触接触クエリの数。これには、
Physics2D.IsTouching
、
Collider2D.IsTouching
、
Rigidbody2D.IsTouching
などのクエリが含まれます。
Unavailable (使用不可)
キネマティックなボディこのフレームに存在した
Kinematic
ボディタイプの Rigidbody2D の数。
Unavailable (使用不可)
重複クエリ物理演算システムがこのフレームで呼び出したオーバーラップクエリの数。これには、
Physics2D.OverlapPoint
、
Physics2D.OverlapCircle
、
Collider2D.OverlapCollider
などのクエリが含まれます。
Unavailable (使用不可)
パーティクルクエリこのフレームでパーティクルシステムが呼び出したクエリの数。Unavailable (使用不可)
レイキャストクエリ物理演算システムがこのフレームで呼び出した、レイまたは線に基づくクエリーの数。これには、
Physics2D.Raycast
や
Physics2D.Linecast
などのクエリが含まれます。
Unavailable (使用不可)
削除された連絡先このフレームで物理演算システムが削除した接触の数。これには衝突接触とトリガー接触の両方が含まれます。Unavailable (使用不可)
Shapecast クエリ物理演算システムがこのフレームで呼び出した形状スイープクエリの数。これには、
Physics2D.BoxCast
、
Physics2D.CircleCast
、
Collider2D.Cast
などのクエリが含まれます。
Unavailable (使用不可)
Solver Continuous Islands連続的な解決ステップの処理中に解決されたアイランドの数。Unavailable (使用不可)
ソルバー諸島離散的な解決ステップを処理するときに解決された接触アイランドの数。Unavailable (使用不可)
ソルバーシミュレーション数Unity が自動的に、または
Physics2D.Simulate
または
PhysicsScene2D.Simulate
を呼び出して、すべての物理演算シーンをシミュレーションした回数。
Unavailable (使用不可)
ソルバーワールド数このフレームに存在した物理演算シーンの総数。Unavailable (使用不可)
静的ボディこのフレームに存在した
Static
ボディタイプの Rigidbody2D の数。
Unavailable (使用不可)
Static静的かつこのフレームに存在した物理演算形状の数。Unavailable (使用不可)
合計ボディ数このフレームに存在した
Rigidbody2D
の総数。
Unavailable (使用不可)
Total Callbacks (合計コールバック数)物理演算システムがこのフレームで呼び出した
OnCollisionEnter2D
、
OnCollisionStay2D
、
OnCollisionExit2D
、OnTriggerEnter2D、
OnTriggerStay2D
、
OnTriggerExit2D
コールバックの総数。
Unavailable (使用不可)
合計コンタクト数このフレームに存在したコンタクトの総数。これには衝突接触とトリガー接触の両方が含まれます。Unavailable (使用不可)
合計ジョイントこのフレームに存在した
Joint2D
の総数。
Unavailable (使用不可)
合計形状このフレームに存在した物理演算形状の総数。Unavailable (使用不可)
合計クエリ数物理演算システムがこのフレームで呼び出したクエリの総数。これには、
Physics2D.Raycast
や
Physics2D.OverlapPoint
などのクエリが含まれます。
Unavailable (使用不可)
Total Transform 同期コール物理演算システムがこのフレームで呼び出した Transform 同期コールの総数。Unavailable (使用不可)
Transform 親同期ボディTransform の親によって発生した Transform 同期の影響を受けた Rigidbody2D の数。Unavailable (使用不可)
Transform 親同期コライダーTransform の親に起因する Transform 同期の影響を受けた Collider2D の数。Unavailable (使用不可)
Transform 同期ボディTransform 同期の影響を受けた Rigidbody2D の数。Unavailable (使用不可)
Transform 同期コライダーTransform 同期の影響を受けた Collider2D の数。Unavailable (使用不可)
トリガー Enterこのフレームで呼び出された OnTriggerEnter2D コールバックの数Unavailable (使用不可)
トリガー終了このフレームで呼び出された OnTriggerExit2D コールバックの数Unavailable (使用不可)
トリガー ステイこのフレームで呼び出された OnTriggerStay2D コールバックの数Unavailable (使用不可)
2D 物理演算データの収集の詳細については、2D 物理演算プロファイラーモジュール リファレンスを参照してください。

レンダリングプロファイラーカウンター

リリース (開発以外) のプレイヤーで使用可能なレンダリングプロファイラーのカウンターと可用性は次のとおりです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

バッチ数フレーム中に Unity が処理したバッチの総数。この数には静的バッチと動的バッチの両方が含まれます。使用可能
CPU メインスレッドフレーム時間フレームの開始から、メインスレッドがそのフレーム中に実行する作業を終了するまでの時間。Frame Timing Stats が有効になっている場合に使用できます。
CPU レンダリングするスレッドフレーム時間レンダリングするスレッドでの作業開始から Unity が
Present
メソッドを呼び出すまでの時間。
Frame Timing Stats が有効になっている場合に使用できます。
CPU 合計フレーム時間合計 CPU フレーム時間。Unity はこれを、オーバーヘッドやフレーム間の待機時間など、2 つのフレームの終了間の時間として計算します。Frame Timing Stats が有効になっている場合に使用できます。
描画コール数Unity がフレーム中に発行した描画コールの総数。使用可能
動的バッチ描画コール数Unity が動的バッチにまとめた描画呼び出しの数。Unavailable (使用不可)
動的バッチ三角形数動的バッチに含まれる GameObjects の三角形の数。Unavailable (使用不可)
動的バッチ頂点数動的バッチに含まれる GameObjects の頂点数。Unavailable (使用不可)
動的バッチ数Unity がフレーム中に処理した動的バッチの数。Unavailable (使用不可)
動的バッチ処理時間Unity が動的バッチ処理構造の作成に費やした時間。Unavailable (使用不可)
GPUフレーム時間GPU が 1 つのフレームをレンダリングする開始と終了の時間差。Frame Timing Stats が有効になっている場合に使用できます。
フレーム バイト単位のインデックス バッファ アップロードCPU が GPU にアップロードしたジオメトリの量 (バイト単位)。使用可能
インデックス バッファ アップロードのフレーム数CPU がフレーム内で GPU にアップロードしたジオメトリの量。使用可能
Instanced Batched 描画コール数Unity がインスタンスのバッチに組み合わせた描画呼び出しの数。Unavailable (使用不可)
インスタンス化されたバッチ三角形の数インスタンス化された GameObjects の三角形の数。Unavailable (使用不可)
Instanced Batched Vertices Countインスタンス化された GameObjects の頂点数。Unavailable (使用不可)
Instanced Batches Count (インスタンス化されたバッチ数)1 フレーム中にインスタンス化された GameObjects をレンダリングするために Unity が処理したバッチの数。Unavailable (使用不可)
レンダリングするテクスチャのバイト数レンダーテクスチャが使用したメモリ量 (バイト単位)。使用可能
レンダリングするテクスチャの変更数Unity がフレーム中に 1 つまたは複数のレンダーテクスチャをレンダリングするターゲットとして設定した回数。使用可能
レンダリングするテクスチャ数Unity がフレーム中に使用したレンダーテクスチャの数。使用可能
SetPass Calls CountUnity がフレーム中にGameObjectsオブジェクトのレンダリングするに使用するシェーダーを切り替えた回数。使用可能
影落としの数フレーム内で影を落とす GameObjects の数。ゲームオブジェクトが複数の影を投影する場合 (複数のライトがライトを照らすため)、投影する影ごとに 1 エントリーを持ちます。使用可能
静的バッチ描画コール数Unity が静的バッチにまとめた描画呼び出しの数。Unavailable (使用不可)
静的バッチ三角形数静的バッチに含まれる GameObjects の三角形の数。Unavailable (使用不可)
静的バッチ頂点数静的バッチに含まれる GameObjects の頂点数。Unavailable (使用不可)
静的バッチ数Unity がフレーム中に処理した静的バッチの数。Unavailable (使用不可)
Triangles Countフレーム中に Unity が処理した三角形の数。使用可能
Used Buffers Bytesバイト単位で使用されるメモリ GPU バッファの量。使用可能
Used Buffers Count (使用済みバッファ数)GPU バッファの総数これには、頂点、インデックス、演算バッファ、およびレンダリングに必要なすべての内部バッファが含まれます。使用可能
Used Textures Bytesテクスチャが使用したメモリ量 (バイト単位)。Unavailable (使用不可)
Used Textures Count (使用済みテクスチャ数)Unity がフレーム中に使用したテクスチャの数。Unavailable (使用不可)
フレーム バイトでの頂点バッファ アップロードCPU が GPU にアップロードしたジオメトリの量 (バイト単位)。使用可能
フレーム数での頂点バッファアップロードCPU がフレーム内で GPU にアップロードしたジオメトリの量。使用可能
Vertices Count (頂点数)Unity がフレーム中に処理した頂点の数。使用可能
ビデオメモリバイトアプリケーションでビデオが使用したシステム メモリの量(バイト単位)。使用可能
Visible Skinned Meshes Countフレーム内のスキンメッシュレンダラーの数。使用可能
レンダリングデータの収集の詳細については、レンダリングプロファイラーモジュールリファレンス を参照してください。

仮想テクスチャリングプロファイラーカウンタ

リリース (開発以外) のプレイヤーで使用可能な仮想テクスチャリングプロファイラーカウンターと可用性は次のとおりです。

プロファイラーカウンター

説明

リリース (開発以外) のプレイヤーで使用可能

アトラス仮想テクスチャ空間またはアトラスの数 (最大 64)Unavailable (使用不可)
Max Cache Demand選択したフレーム内のすべての GPU キャッシュのキャッシュ需要の最高値。Unavailable (使用不可)
最大キャッシュ ミップ バイアス同じテクスチャ形式のすべてのテクスチャに適用される自動ミップマップバイアス。この値がゼロでない場合、キャッシュは表示されているその形式のタイルをすべて格納できるだけのサイズではありません。ミップマップバイアスが高いほど、テクスチャの品質は低くなります。Unavailable (使用不可)
不足ディスクデータ選択したフレームを満たすためにアプリケーションがディスクから読み取る必要のあった残りのデータ (バイト単位)。Unavailable (使用不可)
ストリーミング タイルの欠落画面上には表示されるが、ビデオ メモリには表示されていないタイルの数。Unavailable (使用不可)
ディスクからロードする。選択されたフレームで Unity が完了したディスク読み取り操作のバイト数。Unavailable (使用不可)
必要なタイル画面に表示されたテクスチャチャタイルの数選択されたフレームをレンダリングするためにシェーダーがサンプルしようとしたタイルです。Unavailable (使用不可)
CPU キャッシュサイズ合計Unity がテクスチャチャタイルをディスクからロードした後に、そのタイルを格納するために割り当てたメモリ量。Unavailable (使用不可)
GPUキャッシュサイズ合計仮想テクスチャリングモジュールが選択したフレームに割り当てたすべての GPU キャッシュのサイズ。Unavailable (使用不可)
仮想テクスチャリングデータの収集の詳細については、仮想テクスチャリングモジュールリファレンスを参照してください。

追加リソース