물리 2D 프로파일러 모듈 참조
물리 2D 프로파일러 모듈을 사용하여 애플리케이션의 2D 물리 성능을 분석합니다.
읽는 시간 10분최근 업데이트: 9일 전
물리 2D 프로파일러 모듈은 프로젝트의 씬에서 물리 시스템이 처리한 물리에 대한 정보를 표시합니다. 이 정보는 프로젝트 씬의 물리와 관련된 성능 문제나 예기치 않은 불일치를 진단하고 해결하는 데 도움이 됩니다.

Profiler window with the Physics 2D module selected.
프로파일러 창 열려면 다음 메뉴로 이동합니다. 창 > 분석 > 프로파일러 프로파일러 창을 사용하는 방법에 대한 자세한 내용은 프로파일러 창 시작하기를 참조하십시오.
차트 카테고리
물리 2D 프로파일러 모듈의 차트는 다음 카테고리로 구성됩니다.
차트 | 설명 |
|---|---|
| 총 연락처 수 | 이 프레임에 있었던 전체 접촉 수입니다. 여기에는 충돌 및 트리거 접점이 모두 포함됩니다. |
| 총 모양 | 이 프레임에 있었던 총 물리 모양 수입니다. 다른 Collider2D는 하나에서 무제한까지 다양한 물리 모양을 생성합니다. 모양 횟수를 가져오고 물리 모양을 가져오고 모든 Collider2D에 대해 이를 결정할 수 있습니다. |
| 총 쿼리 | 이 프레임에서 호출된 총 쿼리 수입니다. 여기에는 Physics2D.Raycast, Physics2D.OverlapPoint 등과 같은 쿼리가 포함됩니다. |
| 총 콜백 | 이 프레임에서 호출된 총 OnCollisionEnter2D, OnCollisionStay2D, OnCollisionExit2D, OnTriggerEnter2D, OnTriggerStay2D 및 OnTriggerExit2D 콜백 수입니다. |
| 총 조인트 | 이 프레임에 있었던 모든 Joint2D의 총 수입니다. |
| 총 본문 | 이 프레임에 있었던 총 Rigidbody2D 수입니다. |
| Awake 바디 | 이 프레임에서 깨어 있지 않은 (잠자지 않는) Rigidbody2D의 총 수입니다. |
| 동적 바디 | 이 프레임에 있었던 동적 바디 타입의 총 Rigidbody2D 수입니다. |
| 연속된 바디 | 이 프레임에 있었던 연속 충돌 검사 모드가 있는 총 Rigidbody2D 수입니다. |
| 물리 사용 메모리 | 2D 물리 시스템에서만 사용되는 총 영구 메모리 양입니다. 여기에는 각 물리 컴포넌트가 사용하는 코어 엔진과 메모리가 모두 포함되지만, 이 프레임에서 사용되는 임시 메모리는 포함되지 않습니다. |
프레임 차트 창을 클릭 수 차트 그래프에서 캡처된 프레임을 선택하여 선택한 카테고리를 트래킹합니다. 차트의 카테고리 순서를 변경하려면 차트 범례에서 카테고리를 드래그합니다. 카테고리의 컬러 범례를 클릭 수 표시를 토글할 수도 있습니다. 선택한 통계에 대한 자세한 내용은 모듈 세부 정보 창을 참조하십시오.
모듈 세부 정보 창
물리 2D 프로파일러 모듈에서 프레임을 선택하면 세부 정보 창에 프로젝트 씬의 물리에 대한 자세한 정보가 표시됩니다. 세부 정보 창은 카테고리별로 정렬되며, 각 카테고리는 한 줄에 있습니다.
다음 참조 표에는 사용 가능한 통계와 해당하는 프로파일러 카운터, 릴리스 빌드의 가용성에 대한 설명이 나와 있습니다. 프로파일러 카운터는 에디터와 개발 빌드에서 항상 사용할 수 있습니다. 이 정보는 사용자 지정 프로파일러 모듈에 추가할 수 있도록 ProfilerRecorder API 및 프로파일러 모듈 에디터에서도 사용할 수 있습니다.
물리 사용 메모리
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 2D 물리 시스템에서만 사용되는 총 영구 메모리 양입니다. 여기에는 각 물리 컴포넌트가 사용하는 코어 엔진과 메모리가 모두 포함되지만, 이 프레임에 사용되는 임시 메모리는 포함되지 않습니다. | 물리 사용 메모리 2D | 지원 안 함 |
| 상대 | Unity 전체 메모리 사용량과 비교하여 2D 물리 시스템이 사용한 상대적인 메모리 비율입니다. | N/A | N/A |
바디
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에 있었던 총 Rigidbody2D 수입니다. | 전체 바디 | 지원 안 함 |
| Awake | 이 프레임에서 깨어 있지 않은 (잠자지 않는) Rigidbody2D 수입니다. 정적 바디 유형의 Rigidbody2D는 항상 잠자고 있습니다. | Awake 바디 | 지원 안 함 |
| 휴면 | 잠자고 있거나 깨지지 않은 상태에서 이 프레임에 있었던 Rigidbody2D 수입니다. 정적 바디 타입의 Rigidbody2D는 항상 잠자기 상태입니다. | Asleep Bodies(휴면 바디) | 지원 안 함 |
| --dynamic | 이 프레임에 있었던 동적 바디 타입의 Rigidbody2D 수입니다. 동적 바디는 모든 바디 타입 중에 가장 많은 처리를 받습니다. | 동적 바디(Dynamic Bodies) | 지원 안 함 |
| 운동학 | 이 프레임에 있었던 키네마틱 바디 타입의 Rigidbody2D 수입니다. 키네마틱 바디는 프로세싱이 최소화되어 있습니다. | 키네마틱 바디(Kinematic Bodies) | 지원 안 함 |
| Static | 이 프레임에 있었던 정적 바디 타입의 Rigidbody2D 수입니다. 정적 바디는 모든 바디 타입 중에서 처리를 가장 적게 사용합니다. | 정적 바디(Static Bodies) | 지원 안 함 |
| 불연속 | 이 프레임에 있었던 불연속 충돌 검사 모드가 있는 Rigidbody2D 수입니다. 이산 바디는 연속 충돌 검사 모드를 사용할 때보다 성능 소모가 훨씬 낮습니다. | 이산 바디(Discrete Bodies) | 지원 안 함 |
| 지속 | 이 프레임에 있었던 연속 충돌 검사 모드가 있는 Rigidbody2D 수입니다. 연속 바디는 불연속 충돌 검사 모드를 사용할 때보다 성능이 훨씬 더 많이 소모됩니다. | 연속 바디 | 지원 안 함 |
셰이프
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에 있었던 총 물리 모양 수입니다. 다른 Collider2D는 하나에서 무제한까지 다양한 물리 모양을 생성합니다. 모양 횟수를 가져오고 물리 모양을 가져오고 모든 Collider2D에 대해 이를 결정할 수 있습니다. | 전체 셰이프 | 지원 안 함 |
| Awake | 물리 모양은 깨어있는 Rigidbody2D에 연결되어 있으면 깨어납니다. 이 값은 깨어 있거나(잠을 자지 않음) 이 프레임에 있었던 물리 모양의 수입니다. | Awake Shapes | 지원 안 함 |
| 휴면 | 물리 모양이 휴면 상태인 Rigidbody2D에 연결되어 있으면 휴면 상태입니다. 잠자기(깨지지 않음) 상태였고 이 프레임에 있었던 물리 모양의 수입니다. | 잠자기 모양(Asleep Shapes) | 지원 안 함 |
| --dynamic | 물리 모양은 동적 바디 타입의 Rigidbody2D에 연결된 경우 동적입니다. 동적이었고 이 프레임에 있었던 물리 모양의 수입니다. | 동적 셰이프(Dynamic Shapes) | 지원 안 함 |
| 운동학 | 물리 모양은 키네마틱 바디 타입의 Rigidbody2D에 연결된 경우 키네마틱입니다. 키네마틱이었고 이 프레임에 있었던 물리 모양의 수입니다. | 키네마틱 셰이프 | 지원 안 함 |
| Static | 물리 모양은 정적 바디 타입의 Rigidbody2D에 연결된 경우 정적입니다. 정적이었고 이 프레임에 있었던 물리 모양의 수입니다. | 정적 셰이프(Static Shapes) | 지원 안 함 |
쿼리
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에서 호출된 총 쿼리 수입니다. 여기에는 | 총 쿼리 | 지원 안 함 |
| 레이캐스트 | 이 프레임에서 호출된 레이 또는 라인 기반 쿼리 수입니다. 여기에는 | 레이캐스트 쿼리 | 지원 안 함 |
| Shapecast | 이 프레임에서 호출된 셰이프 스위트 쿼리 수입니다. 여기에는 | 셰이프캐스트 쿼리 | 지원 안 함 |
| 오버랩: | 이 프레임에서 호출된 오버랩 쿼리 수입니다. 여기에는 | 쿼리 오버랩 | 지원 안 함 |
| IsTouching | 이 프레임에서 호출된 접촉 터치 쿼리 수입니다. 여기에는 | IsTouching 쿼리 | 지원 안 함 |
| GetContacts | 이 프레임에서 호출된 컨택트 검색 쿼리 수입니다. 여기에는 | GetContacts 쿼리 | 지원 안 함 |
| 파티클 | 파티클 시스템 이 프레임을 호출한 쿼리 수입니다. 파티클 시스템 모듈이 2D 물리 콜라이더에 접촉하도록 설정되고 파티클 시스템 의해 완전히 제어될 때 사용합니다. 이는 성능에 큰 영향을 미칠 수 있지만 처리에 매우 효율적입니다. | 파티클 쿼리 | 지원 안 함 |
접촉
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에 있었던 전체 접촉 수입니다. 여기에는 충돌 컨택트와 트리거 컨택트가 모두 포함됩니다. 접촉을 처리하고 해결하는 데 시간이 오래 걸릴 수 있습니다. | 전체 연락처 수 | 지원 안 함 |
| 추가 내역 | 이 프레임에 추가된 접촉 수입니다. 여기에는 충돌 컨택트와 트리거 컨택트가 모두 포함됩니다. 단일 프레임에 너무 많은 접점을 추가하면 성능이 급증할 수 있습니다. | 접촉 추가 | 지원 안 함 |
| 삭제 내역 | 이 프레임에서 제거된 접촉 수입니다. 여기에는 충돌 컨택트와 트리거 컨택트가 모두 포함됩니다. 접촉을 빠르게 제거하고 성능에 미치는 영향을 최소화합니다. | 제거된 접촉 | 지원 안 함 |
| 범위 단계 업데이트 | 이 프레임에서 처리된 브로드페이즈 업데이트 수입니다. 광단위 업데이트는 물리 모양이 추가되거나 제거되거나 크기가 변경될 때 발생합니다. 브로드페이즈 업데이트는 두 물리 모양이 잠재적으로 겹치고 브로드페이즈 페어가 생성될 수 있는 경우 접촉 변경을 감지하는 데 사용됩니다. | 광단위 업데이트 | 지원 안 함 |
| 브로드페이즈 페어 | 이 프레임에서 처리된 광대상 쌍의 수입니다. 브로드페이즈 페어는 브로드페이즈 업데이트로 인해 두 물리 모양이 잠재적으로 오버랩될 수 있을 때 생성됩니다. 그런 다음 광대상 페어가 처리되고 그 결과는 새로운 접점이 되거나 물리 모양이 서로 접촉하도록 설정되지 않은 경우 무시됩니다. | 광단위 쌍 | 지원 안 함 |
콜백
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에서 호출된 총 OnCollisionEnter2D, OnCollisionStay2D, OnCollisionExit2D, OnTriggerEnter2D, OnTriggerStay2D 및 OnTriggerExit2D 콜백 수입니다. | 총 콜백 수 | 지원 안 함 |
| 충돌 입력 | 이 프레임에서 호출된 OnCollisionEnter2D 콜백 수입니다. | 충돌 입력(Collision Enter) | 지원 안 함 |
| 충돌 유지 | 이 프레임에서 호출된 OnCollisionStay2D 콜백 수입니다. | 충돌 스테이(Collision Stay) | 지원 안 함 |
| 충돌 출력 | 이 프레임에서 호출된 OnCollisionExit2D 콜백 수입니다. | 충돌 종료 | 지원 안 함 |
| 트리거 입력 | 이 프레임에서 호출된 OnTriggerEnter2D 콜백 수입니다. | 트리거 Enter | 지원 안 함 |
| 트리거 스테이 | 이 프레임에서 호출된 OnTriggerStay2D 콜백 수입니다. | 트리거 스테이(Trigger Stay) | 지원 안 함 |
| 트리거 출력 | 이 프레임에서 호출된 OnTriggerExit2D 콜백 수입니다. | 트리거 종료 | 지원 안 함 |
솔버
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 월드 카운트 | 이 프레임에 있었던 총 물리 씬 수입니다. 각 물리 씬에는 다른 물리 월드와 독립적으로 시뮬레이션할 수 있는 물리 월드가 포함되어 있습니다. 월드가 많으면 성능 문제가 되지 않습니다. 월드가 메모리만 차지하고 시뮬레이션되지 않는 한 작업을 수행하지 않기 때문입니다. | 솔버 월드 카운트(Solver World Count) | 지원 안 함 |
| 시뮬레이션 수 | 모든 물리 씬이 Physics2D.Simulate를 호출하거나 PhysicsScene2D.Simulate를 직접 호출하여 Unity에서 자동으로 시뮬레이션된 횟수입니다. | 솔버 시뮬레이션 수 | 지원 안 함 |
| 기타 섬 | 섬은 상호 조인트 또는 상호 접촉을 통해 연결된 바디의 연결 그래프입니다. 정적 바디 유형은 섬을 연결하지 않습니다. 이산 솔빙 단계를 처리할 때 해결된 컨택트 아일랜드 수입니다. | 솔버 불연속 섬 | 지원 안 함 |
| 연속 섬 | 섬은 상호 조인트 또는 상호 접촉을 통해 연결된 바디의 연결 그래프입니다. 정적 바디 타입은 섬을 연결하지 않습니다. 연속 솔빙 단계를 처리할 때 해결된 아일랜드 수입니다. 연속적 아일랜드를 해결하는 것은 성능이 많이 소모되는 프로세스이며, 여러 번 반복하여 아일랜드를 재생성하고 재처리해야 합니다. 연속 충돌 검사 모드가 있는 Rigidbody2D만이 이 추가 연속 섬을 형성하고 처리합니다. | 솔버 연속 섬 | 지원 안 함 |
트랜스폼 동기화(Transform Sync)
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 동기 호출 | 이 프레임에서 호출된 총 트랜스폼 동기화 호출 수입니다. 트랜스폼 동기화(트랜스폼 읽음이라고도 함)는 트랜스폼이 변경되었는지 확인하고 트랜스폼 포즈가 읽히면 Rigidbody2D 또는 Collider2D가 업데이트되도록 합니다. 물리 컴포넌트를 사용할 때는 트랜스폼을 변경해서는 안 되지만, 때로는 필수이지만, 너무 많은 수의 트랜스폼을 사용할 경우 성능 문제가 발생할 수 DUE 이를 피해야 합니다. 모든 이동은 Rigidbody2D API 사용하여 수행해야 합니다. 물리 시스템은 시뮬레이션 단계를 수행하는 첫 번째 부분으로 단일 트랜스폼 동기화를 수행하므로 시뮬레이션이 발생한 경우 항상 최소 하나입니다(위의 시뮬레이션 수 참조). 물리 시스템은 리지드바디 2D 보간을 처리하는 경우 프레임당 하나의 트랜스폼 동기화를 수행합니다. 추가 호출은 Physics2D.AutoSyncTransforms가 활성 상태(기본적으로 비활성 상태)이거나 Physics2D.SyncTransforms가 호출된 경우에 표시되지만, 성능에 심각한 영향을 미칠 수 있으므로 두 가지는 모두 피해야 합니다. | 총 트랜스폼 동기화 호출 수 | 지원 안 함 |
| 동기 바디 | 트랜스폼 동기화에 영향을 받은 Rigidbody2D 수입니다. 이 값은 최소값으로 유지해야 하며, 0이면 더 좋습니다. | 트랜스폼 동기화 바디(Transform Sync Bodies) | 지원 안 함 |
| 동기 콜라이더 | 트랜스폼 동기화에 영향을 받은 Collider2D 수입니다. 이 값은 최소값으로 유지해야 하며, 0이면 더 좋습니다. | 트랜스폼 동기화 콜라이더(Transform Sync Colliders) | 지원 안 함 |
| 부모 동기화 본문 | 트랜스폼 리퍼런싱으로 인해 트랜스폼 동기화에 영향을 받은 Rigidbody2D 수입니다. 이 값은 최소값으로 유지해야 하며, 0이면 더 좋습니다. | 부모 동기화 바디 변환 | 지원 안 함 |
| 부모 동기화 콜라이더 | 트랜스폼 리퍼런싱으로 인해 트랜스폼 동기화에 영향을 받은 Collider2D 수입니다. 이 값은 최소값으로 유지해야 하며, 0이면 더 좋습니다. | 부모 동기화 콜라이더 변환 | 지원 안 함 |
조인트
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| 합계 | 이 프레임에 있었던 모든 Joint2D의 총 수입니다. 조인트 해결은 비용이 많이 들 수 있으므로 최소한으로 유지해야 합니다. | 전체 조인트 | 지원 안 함 |
시간
통계 | 설명 | 해당 프로파일러 카운터(정확한 이름) | 릴리스 플레이어에서 사용 가능? |
|---|---|---|---|
| Sim | 전체 시뮬레이션 단계를 처리하는 데 소요된 총 시간입니다. Unity에서 Physics2D.Simulate를 호출하거나 직접 PhysicsScene2D.Simulate를 호출하여 자동으로 호출할 수 있습니다. 이번에는 트랜스폼 동기화(읽기), 접촉 계산, 통합, 접촉 및 조인트 해결, 트랜스폼 쓰기 및 접촉 콜백 등 시뮬레이션 단계를 완료하는 데 관련된 모든 단계가 포함됩니다. | N/A | N/A |
| sync | 트랜스폼 동기화를 처리하는 데 소요된 총 시간입니다(동기 호출 참조). | N/A | N/A |
| STEP | 시뮬레이션 단계 처리에 소비한 총 시간입니다. 이번에는 컨택트 계산, 통합, 컨택트 솔빙, 조인트 등 시뮬레이션 단계를 완료하는 데 관련된 핵심 단계만 포함됩니다. | N/A | N/A |
| Write | 트랜스폼 쓰기를 처리하는 데 소요된 총 시간입니다. 이는 바디 자세가 읽히고 트랜스폼 시스템에 다시 작성되는 시뮬레이션 단계의 끝에 발생합니다. | N/A | N/A |
| 콜백 | 모든 콜백을 처리하는 데 소요된 총 시간입니다(총 콜백 참조). | N/A | N/A |