Version: 2023.1
言語: 日本語
Physics プロファイラーモジュール
Rendering Profiler モジュール

Physics 2D Profiler モジュール

Physics 2D Profiler モジュールは、プロジェクトのシーン内で物理演算システムによって処理された物理演算に関する情報を表示します。この情報は、プロジェクトのシーンにおける、物理演算に関連したパフォーマンス問題や予期せぬ矛盾の診断と解決に役立てることができます。

Physics 2D Profiler ウィンドウ
Profiler ウィンドウ 内の Physics 2D Profiler モジュール

チャートのカテゴリ

Physics 2D Profiler モジュールのチャートは、プロジェクトのシーンで物理演算システムが処理する物理演算に関連した様々な統計情報を、以下のチャートカテゴリ別にトラッキングします。フレームチャートのウィンドウをクリックするか、チャートグラフ内のキャプチャされたフレームを選択すると、選択したカテゴリをトラッキングできます。チャート内のカテゴリの順序を変更するには、チャートの凡例内でカテゴリをドラッグアンドドロップします。カテゴリの色の付いた凡例をクリックして、表示を切り替えることもできます。選択した統計に関するより詳細な情報は、モジュールの詳細ペイン で参照できます。

Chart 説明
Total Contacts このフレーム内に存在した接触の総数です。これには Collision (衝突) 接触と Trigger (トリガー) 接触の両方が含まれます。接触の処理と解決には時間がかかる場合があるため、最小限に抑える必要があります。
Total Shapes このフレーム内に存在した 物理形状 の総数です。Collider2D によって、生成する物理形状の数が異なります (最小で 1、最大で無限)。形状カウント を取得して 物理形状を取得 することで、どの Collider2D に関してもこの数を特定できます。
Total Queries このフレームで呼び出されたクエリの総数です。これには Physics2D.RaycastPhysics2D.OverlapPoint などのクエリが含まれます。
Total Callbacks このフレームで呼び出された、OnCollisionEnter2DOnCollisionStay2DOnCollisionExit2DOnTriggerEnter2DOnTriggerStay2D、および OnTriggerExit2D コールバックの総数です。
Total Joints このフレームに存在した Joint2D の総数です。
Total Bodies このフレームに存在した Rigidbody2D の総数です。
Awake Bodies Awake (スリープ していない状態、“起きている” 状態) で、かつこのフレームに存在した、Rigidbody2D の総数です。
Dynamic Bodies このフレームに存在した、Dynamic (動的) ボディタイプの Rigidbody2D の総数です。Dynamic (動的) ボディは全てのボディタイプの中で最も処理に時間がかかるため、数を最小限に抑える必要があります。
Continuous Bodies このフレームに存在した、Continuous (連続的) 衝突判定モードの Rigidbody2D の総数です。Continuous (連続的) 衝突判定モードを使用したボディは、Discrete (非連続的) 衝突判定モードを使用した場合よりもはるかにコストがかかるため、最小限に抑える必要があります
Physics Used Memory 2D 物理演算システムのみによって使用された永続メモリの総量です。これには、コアエンジンと各物理コンポーネントの使用メモリが両方含まれますが、このフレーム内で使用された一時メモリは含まれません。

モジュールの詳細ペイン

Physics 2D Profiler モジュールでフレームを選択すると、プロジェクトのシーンの物理演算に関する詳細情報が、詳細ペインに表示されます。詳細ペインはカテゴリ別にソートされ、各カテゴリがそれぞれ 1 つの行に表示されます。

以下の参照表には、利用可能な統計情報の説明と、対応の Profiler Counter (プロファイラーカウンター)、および、リリースビルドで使用可能かどうかの情報が掲載されています。プロファイラーカウンターは、エディタービルドと開発ビルドで常に利用可能です。この情報は、ProfilerRecorder APIProfiler Module Editor でもアクセス可能なので、カスタムProfiler モジュールに追加することができます。

Physics Used Memory

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total 2D 物理演算システムのみによって使用された永続メモリの総量です。これには、コアエンジンと各物理演算コンポーネントの使用メモリが両方含まれますが、このフレームで使用された一時メモリは含まれません。 Physics Used Memory 2D 不可
Relative Unity の全体のメモリ使用量と比較した、2D 物理演算システムのメモリ使用量の相対的な割合です。 該当なし 該当なし

Bodies

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレームに存在した Rigidbody2D の総数です。 Total Bodies 不可
Awake Awake (スリープ していない状態、“起きている” 状態) で、かつこのフレーム内に存在した、Rigidbody2D の数です。Static (静的) ボディタイプの Rigidbody2D は常にスリープ状態です。 Awake Bodies 不可
Asleep スリープ状態 (Awake でない状態) で、かつこのフレーム内に存在した、Rigidbody2D の数です。Static (静的) ボディタイプの Rigidbody2D は常にスリープ状態です。 Asleep Bodies 不可
Dynamic このフレームに存在した Dynamic (動的) ボディタイプの Rigidbody2D の数です。Dynamic ボディは全てのボディタイプの中で最も処理に時間がかかるため、数を最小限に抑える必要があります。 Dynamic Bodies 不可
Kinematic このフレームに存在した Kinematic (キネマティック) ボディタイプの Rigidbody2D の数です。Kinematic ボディの処理は最小限なので、“明示的な動きは必要だが外力への反応は必要ない” 場合には、これを使用してください。 Kinematic Bodies 不可
Static このフレームに存在した Static (静的) ボディタイプの Rigidbody2D の数です。 Static (静的) ボディは、全てのボディタイプの中で最も処理が少ないので、動きが必要ない場合は可能な限りこれを使用してください。 Static Bodies 不可
Discrete このフレームに存在した、Discrete (非連続的) 衝突判定モードの Rigidbody2D の数です。Discrete (非連続的) 衝突判定モードを使用したボディは、Continuous (連続的) 衝突判定モードを使用した場合よりもはるかにコストが低いため、可能な限りこれを使用してください。 Discrete Bodies 不可
Continuous このフレームに存在した、Continuous (連続的) 衝突判定モードの Rigidbody2D の数です。Continuous (連続的) 衝突判定モードを使用したボディは、Discrete (非連続的) 衝突判定モードを使用した場合よりもはるかにコストがかかるため、数を最小限に抑える必要があります。 Continuous Bodies 不可

Shapes

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレームに存在した 物理形状 の総数です。Collider2D によって生成する物理形状の数が異なります (最小で 1、最大で無限)。形状カウント を取得して 物理形状を取得 することで、どの Collider2D に関してもこの数を特定できます。 Total Shapes 不可
Awake Awake な (スリープ状態でない、“起きている”) Rigidbody2D にアタッチされた物理形状は、Awake です。これは、Awake (スリープしていない) 状態で、かつこのフレームに存在した、物理形状の数です。 Awake Shapes 不可
Asleep スリープ状態の Rigidbody2D にアタッチされた物理形状は、スリープ状態です。これは、スリープ状態 (Awake でない状態) で、かつこのフレームに存在した、物理形状の数です。 Asleep Shapes 不可
Dynamic Dynamic (動的) ボディタイプの Rigidbody2D にアタッチされた物理形状は Dynamic (動的) です。これは、Dynamic (動的) でかつこのフレームに存在した物理形状の数です。 Dynamic Shapes 不可
Kinematic Kinematic (キネマティック) ボディタイプの Rigidbody2D にアタッチされた物理形状は Dynamic (動的) です。これは、Kinematic (キネマティック) でかつこのフレームに存在した物理形状の数です。 Kinematic Shapes 不可
Static Static (静的) ボディタイプの Rigidbody2D にアタッチされた物理形状は Dynamic (静的) です。これは、Static (静的) でかつこのフレームに存在した物理形状の数です。 Static Shapes 不可

Queries

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレームで呼び出されたクエリの総数です。これには、Physics2D.RaycastPhysics2D.OverlapPoint などのクエリが含まれます。 Total Queries 不可
Raycast このフレームで呼び出されたレイベースまたは線ベースのクエリの数です。これには、Physics2D.Raycast や Physics2D.Linecast などのクエリが含まれます。 Raycast Queries 不可
Shapecast このフレームで呼び出されたシェイプスイープクエリの数です。これには、Physics2D.BoxCastPhysics2D.CircleCastCollider2D.Cast などのクエリが含まれます。 Shapecast Queries 不可
Overlap このフレームで呼び出された Overlap クエリの数です。これには、Physics2D.OverlapPointPhysics2D.OverlapCircleCollider2D.OverlapCollider などのクエリが含まれます。 Overlap Queries 不可
IsTouching このフレームで呼び出された接触の Touching クエリの数です。これには、Physics2D.IsTouchingCollider2D.IsTouchingRigidbody2D.IsTouching などのクエリが含まれます。 IsTouching Queries 不可
GetContacts このフレームで呼び出された接触取得クエリの数です。Physics2D.GetContactsCollider2D.GetContactsRigidbody2D.GetContacts などのクエリが含まれます。Collision2D.GetContacts は物理演算クエリではなく、ここには含まれません。 GetContacts Queries 不可
Particle このフレームでパーティクルシステムによって呼び出されたクエリの数です。これが使用されるのは、パーティクルシステムモジュールが 2D 物理演算のコライダーと接触するように設定されていて、パーティクルシステムによって完全に制御されている場合です。この数は非常に大きくなる場合がありますが、処理効率も非常に高くなります。 Particle Queries 不可

Contacts

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレーム内に存在した接触の総数です。これには Collision (衝突) 接触と Trigger (トリガー) 接触の両方が含まれます。接触の処理と解決には時間がかかる場合があるため、最小限に抑える必要があります。 Total Contacts 不可
Added このフレームで追加された接触の数です。これには Collision (衝突) 接触と Trigger (トリガー) 接触の両方が含まれます。1 つのフレームに接触を多く追加し過ぎるとパフォーマンス負荷が急増する可能性があるため、これは最小限に抑えてください。 Added Contacts 不可
Removed このフレームで削除された接触の数です。これには Collision (衝突) 接触と Trigger (トリガー) 接触の両方が含まれます。接触の削除は素早く行われるので、パフォーマンスへの影響は最小限です。 Removed Contacts 不可
Broadphase Updates このフレームで処理されたブロードフェーズ更新の数です。ブロードフェーズ更新は、物理形状が追加、削除、またはサイズ変更された時に発生します。ブロードフェーズ更新は、2 つの物理形状が重なる可能性があり、結果としてブロードフェーズペア (以下参照) が作成され得る場合に、接触の変更を検出するために使用されます。 Broadphase Updates 不可
Broadphase Pairs このフレームで処理されたブロードフェーズペアの数です。ブロードフェーズペアは、ブロードフェーズ更新の結果として 2 つの物理形状が重なる可能性がある場合に作成されます。ブロードフェーズペアは、作成された後で処理され、その結果、新しい接触になるか、(物理形状が接触し合うように設定されていない場合は) 無視されます。 Broadphase Pairs 不可

Callbacks

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレームで呼び出された、OnCollisionEnter2DOnCollisionStay2DOnCollisionExit2DOnTriggerEnter2DOnTriggerStay2D、および OnTriggerExit2D コールバックの総数です。 Total Callbacks 不可
Collision Enter このフレームで呼び出された OnCollisionEnter2D コールバックの数です。 Collision Enter 不可
Collision Stay このフレームで呼び出された OnCollisionStay2D コールバックの数です。 Collision Stay 不可
Collision Exit このフレームで呼び出された OnCollisionExit2D コールバックの数です。 Collision Exit 不可
Trigger Enter このフレームで呼び出された OnTriggerEnter2D コールバックの数です。 Trigger Enter 不可
Trigger Stay このフレームで呼び出された OnTriggerStay2D コールバックの数です。 Trigger Stay 不可
Trigger Exit このフレームで呼び出された OnTriggerExit2D コールバックの数です。 Trigger Exit 不可

Solver

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
World Count このフレームに存在した 物理演算シーン の総数です。各物理演算シーンには 1 つの物理演算世界が含まれており、これは他の全ての物理演算世界から切り離してシミュレートすることができます。世界の数が多くても、それ自体はパフォーマンスの問題にはなりません。なぜなら、これはメモリを占有するだけで、シミュレーションが行われない限り何も実行しないからです。 Solver World Count 不可
Simulation Count (Unity の Physics2D.Simulate の呼び出しで自動的に行われたか、PhysicsScene2D.Simulate の直接の呼び出しによって行われたかのいずれかの方法で) 全ての物理演算シーンのシミュレーションが行われた回数です。 Solver Simulation Count 不可
Discrete Islands アイランドは、共有のジョイントや共有の接触によって接続される複数のボディの連結グラフです。Static (静的) ボディタイプはアイランドを接続しないことに注意してください。これは、非連続的な解決ステップの処理中に解決された接触アイランドの数です。 Solver Discrete Islands 不可
Continuous Islands アイランドは、共有のジョイントや共有の接触によって接続される複数のボディの連結グラフです。Static (静的) ボディタイプはアイランドを接続しないことに注意してください。これは、連続的な解決ステップの処理中に解決された接触アイランドの数です。連続的アイランドの解決は非常にコストのかかる処理で、アイランドの再生成と再処理を要するイテレーションを何度も行う必要があります。したがって、これは最小限に抑える必要があります。こうした追加的な連続的アイランドの形成と処理を発生させるのは、Continuous (連続的) 衝突判定モードを使用した Rigidbody2D だけです。 Solver Continuous Islands 不可

Transform Sync

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Sync Calls このフレームで呼び出された Transform Sync コールの総数です。Transform Sync (Transform Read として知られる) では、Transform が変更されたかどうかのチェックが行われ、もし変更されている場合は Transform のポーズが読み取られて Rigidbody2DCollider2D が更新されます。物理演算コンポーネントを使用する場合は Transform は変更すべきではありません。これが必要な場合もありますが、処理される数が多すぎるとパフォーマンスに問題が起きる可能性があるため、避ける必要があります。全ての動きは Rigidbody2D API を使用して処理する必要があります。

物理演算システムはシミュレーションステップの実行の最初の部分として 1 回の Transform Sync を実行するので、シミュレーションが発生した場合には、この数字は必ず少なくとも 1 になります (上記 Simulation Count 参照)。

Physics2D.AutoSyncTransforms (デフォルトでは非アクティブ) がアクティブな場合、あるいは Physics2D.SyncTransforms が呼び出された場合は、追加の呼び出しが行われますが、これらはどちらもパフォーマンスに深刻な影響を与えるため、避ける必要があります。
Total Transform Sync Calls 不可
Sync Bodies Transform Sync の影響を受けた Rigidbody2D の数です。これは最小限 (できれば 0) に抑える必要があります。 Transform Sync Bodies 不可
Sync Colliders Transform Sync の影響を受けた Collider2D の数です。これは最小限 (できれば 0) に抑える必要があります。 Transform Sync Colliders 不可
Parent Sync Bodies Transform の親の変更によって発生した Transform Sync の影響を受けた Rigidbody2D の数です。これは最小限 (できれば 0) に抑える必要があります。 Transform Parent Sync Bodies 不可
Parent Sync Colliders Transform の親の変更によって発生した Transform Sync の影響を受けた Collider2D の数です。これは最小限 (できれば 0) に抑える必要があります。 Transform Parent Sync Colliders 不可

Joints

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Total このフレームに存在した Joint2D の総数です。ジョイントの解決には高いコストがかかる可能性があるので、これは最小限に抑える必要があります。 Total Joints 不可

Timings

ノート: 全ての Timing (タイミング) は、全ての物理演算世界にわたっての合計です (World Count 参照)。タイミングが抽出された回数は、タイミング自体の後ろに続けて、角括弧内に表示されます。タイミングを World Count の値で割れば平均時間が算出できます。

統計 説明 対応のプロファイラーカウンター (正確な名称) リリースプレイヤーで利用可能か
Sim 完全なシミュレーションステップの処理に費やされた時間の合計です。これは、Unity によって (Physics2D.Simulate の呼び出しによって) 自動的に呼び出される場合と、直接の PhysicsScene2D.Simulate の呼び出しによって呼び出される場合があります。この時間には、Transform Sync (Read)、接触の計算、統合、接触とジョイントの解決、Transform Write、接触コールバックなどの、シミュレーションステップを完了に関わる全てのステージが含まれます。 該当なし 該当なし
Sync Transform Sync (Sync Calls 参照) の処理に費やされた時間の合計です。 該当なし 該当なし
Step シミュレーションステップの処理に費やされた時間の合計です。この時間には、シミュレーションステップの完了に関わるコアステージ (接触の計算、統合、接触とジョイントの解決など) のみが含まれます。 該当なし 該当なし
Write Transform Write 処理に費やされた時間の合計です。これは、シミュレーションステップの終了中の、ボディポーズが読み取られて Transform システムに書き戻される時に発生します。 該当なし 該当なし
Callbacks 全てのコールバックの処理に費やされた時間の合計です (コールバックの合計 参照)。 該当なし 該当なし

古い Physics プロファイラー

Legacy モードに切り替えると、(古いバージョンの Unity のデフォルトモジュールだった) 古いバージョンの Physics 2D Profiler モジュールを表示できます。これを行うには、Profiler モジュールの詳細ペインの右上にあるドロップダウンメニューから Legacy を選択してください。

このモードでは、古いバージョンの Unity で保存されたプロファイラーデータをロードして調査することができます。Unity の新しいバージョンでキャプチャされたデータを調査する時にこのモードに切り替えると、表示されるデータが信頼性の低い不正確なものになる可能性があります。最新バージョンの Unity の Physics 2D プロファイラーデータを確認する場合は、常に Current モードを使用することをお勧めします。

Legacy Profiler view
Legacy Profiler view
Physics プロファイラーモジュール
Rendering Profiler モジュール