物理演算 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/A | N/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 に静的ボディタイプでアタッチされている場合は静的です。これは、静的かつこのフレームに存在した物理演算形状の数です。 | 静的形状 | いいえ |
クエリ
統計 | 説明 | 対応するプロファイラーカウンター (正確な名前) | リリースプレイヤーで使用できますか? |
|---|---|---|---|
| 合計 | このフレームで呼び出されたクエリの総数。これには、 | Total Queries (合計クエリ数) | いいえ |
| レイキャスト | このフレームで呼び出されたレイまたはラインベースのクエリの数。これには、 | Raycast クエリ | いいえ |
| Shapecast | このフレームで呼び出された形状スイープクエリの数。これには、 | Shapecast クエリ | いいえ |
| Overlap: | このフレームで呼び出されたオーバーラップクエリの数。これには、 | Overlap Queries (重複クエリ) | いいえ |
| IsTouching | このフレームで呼び出された接触接触接触クエリーの数。これには、 | IsTouching クエリ | いいえ |
| 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/A | N/A |
| sync | Transform 同期(同期コールを参照)の処理に費やされた時間の合計。 | N/A | N/A |
| STEP | シミュレーションステップの処理に費やされた時間の合計。この時間には、接触の計算、インテグレーション、接触とジョイントの解決など、シミュレーションステップの完了に関わるコアステージのみが含まれます。 | N/A | N/A |
| 書き込み | Transform Write の処理に費やされた時間の合計。これはシミュレーションステップの終了にボディが読み取られ Transform システムに書き戻されるときに発生します。 | N/A | N/A |
| コールバック | すべてのコールバックの処理に費やされた時間の合計(Total Callbacks を参照)。 | N/A | N/A |