기술 자료

Unity 엔진

Unity 엔진

물리 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/AN/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)지원 안 함

쿼리

통계

설명

해당 프로파일러 카운터(정확한 이름)

릴리스 플레이어에서 사용 가능?

합계이 프레임에서 호출된 총 쿼리 수입니다. 여기에는
Physics2D.Raycast
및
Physics2D.OverlapPoint
와 같은 쿼리가 포함됩니다.
총 쿼리지원 안 함
레이캐스트이 프레임에서 호출된 레이 또는 라인 기반 쿼리 수입니다. 여기에는
Physics2D.Raycast
및
Physics2D.Linecast
와 같은 쿼리가 포함됩니다.
레이캐스트 쿼리지원 안 함
Shapecast이 프레임에서 호출된 셰이프 스위트 쿼리 수입니다. 여기에는
Physics2D.BoxCast
,
Physics2D.CircleCast
,
Collider2D.Cast
와 같은 쿼리가 포함됩니다.
셰이프캐스트 쿼리지원 안 함
오버랩:이 프레임에서 호출된 오버랩 쿼리 수입니다. 여기에는
Physics2D.OverlapPoint
,
Physics2D.OverlapCircle
,
Collider2D.OverlapCollider
와 같은 쿼리가 포함됩니다.
쿼리 오버랩지원 안 함
IsTouching이 프레임에서 호출된 접촉 터치 쿼리 수입니다. 여기에는
Physics2D.IsTouching
,
Collider2D.IsTouching
,
Rigidbody2D.IsTouching
등과 같은 쿼리가 포함됩니다.
IsTouching 쿼리지원 안 함
GetContacts이 프레임에서 호출된 컨택트 검색 쿼리 수입니다. 여기에는
Physics2D.GetContacts
,
Collider2D.GetContacts
및 Rigidbody2D.GetContacts와 같은 쿼리가 포함됩니다. 여기에는 물리 쿼리가 아닌
Collision2D.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의 총 수입니다. 조인트 해결은 비용이 많이 들 수 있으므로 최소한으로 유지해야 합니다.전체 조인트지원 안 함

시간

참고
모든 타이밍은 모든 물리 월드에 합계됩니다(월드 카운트 참조). 타이밍이 샘플링된 횟수는 타이밍 자체 뒤의 대괄호로 표시됩니다. 타이밍은 실제로 평균 시간을 제공하기 위해 World Count 값으로 나눌 수 있습니다.

통계

설명

해당 프로파일러 카운터(정확한 이름)

릴리스 플레이어에서 사용 가능?

Sim전체 시뮬레이션 단계를 처리하는 데 소요된 총 시간입니다. Unity에서 Physics2D.Simulate를 호출하거나 직접 PhysicsScene2D.Simulate를 호출하여 자동으로 호출할 수 있습니다. 이번에는 트랜스폼 동기화(읽기), 접촉 계산, 통합, 접촉 및 조인트 해결, 트랜스폼 쓰기 및 접촉 콜백 등 시뮬레이션 단계를 완료하는 데 관련된 모든 단계가 포함됩니다.N/AN/A
sync트랜스폼 동기화를 처리하는 데 소요된 총 시간입니다(동기 호출 참조).N/AN/A
STEP시뮬레이션 단계 처리에 소비한 총 시간입니다. 이번에는 컨택트 계산, 통합, 컨택트 솔빙, 조인트 등 시뮬레이션 단계를 완료하는 데 관련된 핵심 단계만 포함됩니다.N/AN/A
Write트랜스폼 쓰기를 처리하는 데 소요된 총 시간입니다. 이는 바디 자세가 읽히고 트랜스폼 시스템에 다시 작성되는 시뮬레이션 단계의 끝에 발생합니다.N/AN/A
콜백모든 콜백을 처리하는 데 소요된 총 시간입니다(총 콜백 참조).N/AN/A

추가 리소스