ドキュメント

Unity Engine

Unity Engine

物理演算 2D プロファイラーモジュールリファレンス

物理演算 2D プロファイラーモジュールを使用して、アプリケーションの 2D 物理演算のパフォーマンスを分析できます。
読み終わるまでの所要時間 31 分最終更新 6日前

物理演算 2D プロファイラーモジュールは、プロジェクトのシーンで物理演算システムが処理した物理演算に関する情報を表示します。この情報は、プロジェクトのシーンにおける物理演算特性に関連するパフォーマンスの問題や予期しない矛盾を診断し、解決するのにヘルプます。

Profiler window with the Physics 2D module selected.

プロファイラー ウィンドウを開くには、メニュー (メニュー) に移動します。ウィンドウ> 分析> プロファイラー。プロファイラーウィンドウの使用方法の詳細は、 プロファイラーウィンドウの概要 を参照してください。

グラフのカテゴリ

物理演算 2D プロファイラーモジュールのチャートは、以下のカテゴリに分かれています。

グラフ

説明

合計コンタクト数このフレームに存在したコンタクトの総数。これには衝突接触とトリガー接触の両方が含まれます。
合計形状このフレームに存在した物理演算形状の総数。Collider2D によって生成される物理演算形状は異なり、1 から無制限まであります。形状数と物理演算形状を取得して、任意の Collider2D でこれを判定できます。
合計クエリ数このフレームで呼び出されたクエリの総数。これには、Physics2D.Raycast、Physics2D.OverlapPoint などのクエリが含まれます。
Total Callbacksこのフレームで呼び出された OnCollisionEnter2D、OnCollisionStay2D、OnCollisionExit2D、OnTriggerEnter2D、OnTriggerStay2D、および OnTriggerExit2D コールバックの総数。
合計ジョイントこのフレームに存在した Joint2D の総数。
合計ボディ数このフレームに存在した Rigidbody2D の総数。
Awakebodyこのフレームに存在した、 スリープ状態ではない Awake 状態の Rigidbody2D の総数です。
動的ボディこのフレームに存在した動的ボディ タイプの Rigidbody2D の総数。
連続ボディこのフレームに存在した、連続衝突判定モードの Rigidbody2D の総数です。
物理演算使用メモリ2D 物理演算システムによって排他的に使用される永続化されたメモリの総量。これには、コア エンジンと各物理演算コンポーネントによって使用されるメモリの両方が含まれますが、このフレームで使用される一時メモリは含まれません。
フレーム チャート ウィンドウをクリックするか、チャート グラフでキャプチャしたフレームを選択して、選択したカテゴリを追跡します。グラフ内のカテゴリの順序を変更するには、カテゴリをグラフの凡例内でドラッグします。カテゴリの色の付いた凡例をクリックして、ディスプレイをトグルすることもできます。選択した統計の詳細については、モジュール詳細ペインを参照してください。

モジュール詳細ペイン

2D 物理演算プロファイラーモジュールでフレームを選択すると、詳細ペインにプロジェクトのシーンの物理演算に関する詳細情報が表示されます。詳細ペインはカテゴリでソートされ、各カテゴリは 1 行に表示されます。
以下のリファレンス表は、使用可能な統計、対応するプロファイラーカウンタ、およびリリースビルドでの可用性を示しています。プロファイラーカウンターは、常にエディターと開発ビルドで使用できます。この情報は、ProfilerRecorder API およびプロファイラーモジュールエディタでも得られるため、カスタムプロファイラーモジュールに追加できます。

物理演算使用メモリ

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計2D 物理演算システムによって排他的に使用される永続化されたメモリの総量。これには、コア エンジンと各物理演算コンポーネントによって使用されるメモリの両方が含まれますが、このフレームで使用される一時メモリは含まれません。物理演算使用メモリ 2Dいいえ
相対Unity の全体的なメモリ使用量と比較した、2D 物理演算システムのメモリ使用量の相対的な割合。N/AN/A

ボディ

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームに存在した Rigidbody2D の総数。Total Bodies (合計ボディ数)いいえ
Awakeこのフレームに存在した、 スリープ状態ではない Awake 状態の Rigidbody2D の数です。静的ボディタイプの Rigidbody2D は常にスリープ状態です。Awakebodyいいえ
Asleepスリープ状態 (Awake ではない状態) でこのフレームに存在した Rigidbody2D の数。静的 ボディの Rigidbody2D は常にスリープ状態です。スリープボディいいえ
--dynamicこのフレームに存在した動的ボディ タイプの Rigidbody2D の数。動的ボディは、すべてのボディタイプの中で最も処理を行います。動的ボディいいえ
キネマティックこのフレームに存在した Kinematic ボディタイプの Rigidbody2D の数。キネマティックなボディの処理は最小限です。キネマティックなボディいいえ
Staticこのフレームに存在した静的ボディ タイプの Rigidbody2D の数。静的ボディは、すべてのボディ タイプの中で最も処理が少なくなります。静的ボディいいえ
離散このフレームに存在した、Discrete 衝突判定モードの Rigidbody2D の数。非 連続 衝突判定モードを使用する場合よりも、非連続衝突判定ボディのパフォーマンス負荷ははるかに低くなります。離散ボディいいえ
継続的このフレームに存在した、連続衝突判定モードの Rigidbody2D の数。連続ボディは、離散型衝突判定モードを使用した場合よりもはるかにパフォーマンス負荷がかかります。連続ボディいいえ

形状

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームに存在した物理演算形状の総数。Collider2D によって生成される物理演算形状は異なり、1 から無制限まであります。形状数と物理演算形状を取得して、任意の Collider2D でこれを判定できます。合計シェイプ数いいえ
Awake物理演算形状は、Awake 状態の Rigidbody2D にアタッチされている場合は Awake 状態になります。これは、スリープ状態でなく、かつこのフレームに存在した物理演算形状の数です。Awake シェイプいいえ
Asleep物理演算形状は、スリープ状態の Rigidbody2D にアタッチされている場合はスリープ状態になります。これは、スリープ状態 (Awake ではない状態) で、かつこのフレームに存在した物理演算形状の数です。スリープシェイプいいえ
--dynamic物理演算形状が動的ボディタイプの Rigidbody2D にアタッチされている場合、その形状は動的です。これは、動的かつこのフレームに存在した物理演算形状の数です。動的形状いいえ
キネマティック物理演算形状が Kinematic ボディタイプの Rigidbody2D にアタッチされている場合、Kinematic になります。これは Kinematic (キネマティック) であり、かつこのフレームに存在した物理演算形状の数です。キネマティック形状いいえ
Static物理演算形状は、Rigidbody2D に静的ボディタイプでアタッチされている場合は静的です。これは、静的かつこのフレームに存在した物理演算形状の数です。静的形状いいえ

クエリ

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームで呼び出されたクエリの総数。これには、
Physics2D.Raycast
や
Physics2D.OverlapPoint
などのクエリが含まれます。
Total Queries (合計クエリ数)いいえ
レイキャストこのフレームで呼び出されたレイまたはラインベースのクエリの数。これには、
Physics2D.Raycast
や
Physics2D.Linecast
などのクエリが含まれます。
Raycast クエリいいえ
Shapecastこのフレームで呼び出された形状スイープクエリの数。これには、
Physics2D.BoxCast
、
Physics2D.CircleCast
、
Collider2D.Cast
などのクエリが含まれます。
Shapecast クエリいいえ
Overlap:このフレームで呼び出されたオーバーラップクエリの数。これには、
Physics2D.OverlapPoint
、
Physics2D.OverlapCircle
、
Collider2D.OverlapCollider
などのクエリが含まれます。
Overlap Queries (重複クエリ)いいえ
IsTouchingこのフレームで呼び出された接触接触接触クエリーの数。これには、
Physics2D.IsTouching
、
Collider2D.IsTouching
、
Rigidbody2D.IsTouching
などのクエリが含まれます。
IsTouching クエリいいえ
GetContactsこのフレームで呼び出された接触取得クエリの数。これには、
Physics2D.GetContacts
、
Collider2D.GetContacts
、Rigidbody2D.GetContacts などのクエリが含まれます。これには物理演算クエリではない
Collision2D.GetContacts
は含まれません。
GetContacts クエリいいえ
パーティクルパーティクルシステムがこのフレームで呼び出したクエリの数。Particle System モジュールが 2D 物理演算コライダーと接触するように設定され、Particle System によって完全に制御されている場合に使用されます。これはパフォーマンスに大きな影響を与える可能性があるだけでなく、処理が非常に効率的であることに注意してください。パーティクルクエリいいえ

連絡先

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームに存在したコンタクトの総数。これには衝突接触とトリガー接触の両方が含まれます。コンタクトの処理と解決には、処理に時間がかかる場合があります。Total Contacts (合計コンタクト数)いいえ
追加このフレームで追加されたコンタクトの数。これには衝突接触とトリガー接触の両方が含まれます。1 つのフレームに接触を追加すると、パフォーマンスが急激に向上する可能性があります。追加された連絡先いいえ
削除このフレームで削除された接触の数。これには衝突接触とトリガー接触の両方が含まれます。接触の削除は迅速で、パフォーマンスへの影響は最小限です。削除された連絡先いいえ
ブロードフェーズアップデートこのフレームで処理されたブロードフェーズ更新の数。ブロードフェーズ更新は、物理演算形状が追加、削除、またはサイズ変更されるときに発生します。ブロードフェーズ更新は、2 つの物理演算形状が重なる可能性があり、その結果ブロードフェーズが作成される可能性がある場合に、接触の変化を検出するために使用されます。ブロードフェーズアップデートいいえ
ブロードフェーズペアこのフレームで処理されたブロードフェーズの数。ブロードフェーズは、ブロードフェーズ更新の結果、2 つの物理演算形状が重なる可能性がある場合に作成されます。ブロードフェーズ ペアが処理され、その結果が新しい接触になります。物理演算形状が互いに接触するように設定されていない場合は無視されます。ブロードフェーズフェーズペアいいえ

コールバック

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームで呼び出された OnCollisionEnter2D、OnCollisionStay2D、OnCollisionExit2D、OnTriggerEnter2D、OnTriggerStay2D、および OnTriggerExit2D コールバックの総数。Total Callbacks (合計コールバック数)いいえ
衝突エンターこのフレームで呼び出された OnCollisionEnter2D コールバックの数衝突エンターいいえ
衝突停止このフレームで呼び出された OnCollisionStay2D コールバックの数衝突停止いいえ
衝突出口このフレームで呼び出された OnCollisionExit2D コールバックの数衝突出口いいえ
トリガー Enterこのフレームで呼び出された OnTriggerEnter2D コールバックの数トリガー Enterいいえ
トリガー ステイこのフレームで呼び出された OnTriggerStay2D コールバックの数トリガー ステイいいえ
トリガー終了このフレームで呼び出された OnTriggerExit2D コールバックの数トリガー終了いいえ

ソルバー

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

ワールド数このフレームに存在した物理演算シーンの総数。各物理演算シーンには、他の物理演算ワールドから独立してシミュレーションできる物理演算ワールドが含まれています。多くのワールドを持つことはパフォーマンスの問題ではありません。なぜなら、それはメモリを占有するだけであり、シミュレーションされない限り作業を実行しないからです。ソルバーワールド数いいえ
シミュレーション数Unity が自動的に、物理演算 2D.シミュレーションを行うか、直接 PhysicsScene2D.シミュレーションを行うことによって、すべての物理演算シーンをシミュレーションした回数。ソルバーシミュレーション数いいえ
離散諸島アイランドは、相互のジョイントまたは相互の接触を介して接続されたボディの連結グラフです。静的ボディタイプはアイランドを接続しないことに注意してください。離散的な解決ステップを処理するときに解決された接触アイランドの数。ソルバー離散諸島いいえ
連続する島アイランドは、相互のジョイントまたは相互の接触を介して接続されたボディの連結グラフです。静的 ボディはアイランドを接続しないことに注意してください。これは、連続的な解決ステップを処理するときに解決されたアイランドの数です。連続的なアイランドの解決はパフォーマンス負荷の高いプロセスであり、アイランドの再生成と再処理が必要な複数のイテレーションを伴います。連続衝突判定モードを持つ Rigidbody2D だけが、この追加の連続アイランドの形成と処理の結果になります。ソルバー連続島いいえ

Transform 同期

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

同期コールこのフレームで呼び出された Transform 同期コールの総数。Transform 同期(Transform Read と呼ばれます)では、Transform が変更されたかどうかを確認し、変更されている場合は Transform ポーズが読み取られ、Rigidbody2D または Collider2D が更新されます。物理演算コンポーネントを使用する場合はトランスフォームを変更しないでください。ただし、これが必要になる場合もありますが、実行数が多すぎるとパフォーマンスの問題が発生する可能性があるため、避ける必要があります。すべての移動は Rigidbody2D API を使用して実行する必要があります。

物理演算システムは、シミュレーション ステップの実行の最初の部分として単一のTransform同期を実行するため、シミュレーションが発生した場合、これは常に少なくとも1つになります(上記のシミュレーション数を参照)。物理演算システムは、Rigidbody2D 補間を処理している場合、フレームごとに 1 つの Transform 同期も実行します。

Physics2D.AutoSyncTransforms がアクティブの場合(デフォルトでは非アクティブ)、または Physics2D.SyncTransforms が呼び出された場合は追加の呼び出しが表示されますが、どちらもパフォーマンスに重大な影響を与える可能性があるため、避ける必要があります。
Total Transform 同期コールいいえ
同期ボディTransform 同期の影響を受けた Rigidbody2D の数。これは最小限に抑える必要があり、できれば 0 にします。Transform 同期ボディいいえ
同期コライダーTransform 同期の影響を受けた Collider2D の数。これは最小限に抑える必要があり、できれば 0 にします。Transform 同期コライダーいいえ
親同期ボディTransform の親によって発生した Transform 同期の影響を受けた Rigidbody2D の数です。これは最小限に抑える必要があり、できれば 0 にします。Transform 親同期ボディいいえ
親同期コライダーTransform の親に起因する Transform 同期の影響を受けた Collider2D の数。これは最小限に抑える必要があり、できれば 0 にします。Transform 親同期コライダーいいえ

ジョイント

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

合計このフレームに存在した Joint2D の総数。ジョイントの解決にはコストがかかるため、最小限に抑える必要があります。Total Joints (合計ジョイント数)いいえ

タイミング

注
すべてのタイミングは、すべての物理演算ワールドで合計されます(ワールド数 を参照)。タイミングがサンプリングされた回数は、タイミング自体の後の正方形こ内に表示されます。タイミングは、ワールド数 の値で割って平均時間を出すことができます。

統計

説明

対応するプロファイラーカウンター (正確な名前)

リリースプレイヤーで使用できますか?

Sim完全なシミュレーションステップの処理に費やされた時間の合計。Unity は自動的に Physics2D.シミュレーションを行うか、直接 PhysicsScene2D.シミュレーションを行うことによって呼び出します。この時間には、Transform同期(読み取り)、接触の計算、インテグレーション、接触とジョイントの解決、Transform書き込み、接触コールバックなど、シミュレーション ステップの完了に関わるすべてのステージが含まれます。N/AN/A
syncTransform 同期(同期コールを参照)の処理に費やされた時間の合計。N/AN/A
STEPシミュレーションステップの処理に費やされた時間の合計。この時間には、接触の計算、インテグレーション、接触とジョイントの解決など、シミュレーションステップの完了に関わるコアステージのみが含まれます。N/AN/A
書き込みTransform Write の処理に費やされた時間の合計。これはシミュレーションステップの終了にボディが読み取られ Transform システムに書き戻されるときに発生します。N/AN/A
コールバックすべてのコールバックの処理に費やされた時間の合計(Total Callbacks を参照)。N/AN/A

追加リソース