코드에 프로파일러 카운터 추가
프로파일러 카운터를 사용하여 특정 통계를 수집합니다.
읽는 시간 2분최근 업데이트: 9일 전
프로파일러 카운터를 추가하려면 다음을 수행하는 스크립트를 생성합니다.
- 새 카운터를 만들고 정의합니다.
- 카운터 값을 업데이트합니다.
이 섹션의 코드 예제는 프로파일러 카운터를 추가하여 Unity 게임 오브젝트의 트레일 효과의 모든 인스턴스에 대해 생성한 총 파티클 수를 추적합니다. 이 예제에서 게임 오브젝트의 이름은 "Tank"입니다.
필수 조건
일부 예제에서는 시작하기 전에 설치해야 하는 Profiling Core 패키지를 사용합니다. Unity 프로파일링 코어 패키지는 코어 패키지이므로 패키지 관리자 UI에서 검색할 수 없습니다. 패키지를 설치하려면 이름을 추가합니다, 즉 .
com.unity.profiling.core카운터 생성 및 정의
새 카운터를 생성하려면:
- 새 카운터의 값 타입을 정의하는 스크립트를 작성합니다.
- 이름과 유닛을 이 타입에 할당합니다.
프로파일러 카운터 API 푸시 및 풀 작업을 지원합니다. 카운터의 값을 프로파일러로 푸시하거나, 프로파일러는 프레임 마지막에 값을 가져올 수 있습니다.
데이터가 자주 변경되지 않는 경우(예: 프레임당 한 번), API를 사용하여 카운터 데이터를 프로파일러로 푸시합니다. 프레임당 데이터가 여러 번 변경되면 API를 사용합니다. 이렇게 하면 프로파일러가 프레임이 끝날 때 마지막 값을 자동으로 가져옵니다.
ProfilerCounterProfilerCounterValue다음 예제 스크립트는 이름이 이고 단위가 인 를 정의합니다.
Tank Trail ParticlesProfilerMarkerDataUnit.CountProfilerCounterValueTankTrailParticleCountpublic static class GameStats{ public static readonly ProfilerCategory TanksCategory = ProfilerCategory.Scripts; public const string TankTrailParticleCountName = "Tank Trail Particles"; public static readonly ProfilerCounterValue<int> TankTrailParticleCount = new ProfilerCounterValue<int>(TanksCategory, TankTrailParticleCountName, ProfilerMarkerDataUnit.Count, ProfilerCounterOptions.FlushOnEndOfFrame | ProfilerCounterOptions.ResetToZeroOnFlush);}
옵션 및 는 카운터를 프로파일러 데이터 스트림으로 자동으로 보내 프레임이 끝날 때 Count 값을 0으로 초기화합니다.
FlushOnEndOfFrameResetToZeroOnFlush카운터 값 업데이트
카운터의 값을 업데이트하려면 정의한 카운터의 값을 설정하는 MonoBehaviour 스크립트를 생성합니다.
다음 MonoBehaviour 스크립트는 Update 함수의 프레임마다 할당된 게임 오브젝트에 속하는 트레일 파티클의 수를 계산합니다. 이를 위해서는 카운터를 사용합니다.
TankTrailParticleCount다음 예제 스크립트는 인스펙터에서 트레일 파티클 시스템()이라는 공용 프로퍼티도 생성합니다.
m_TrailParticleSystemusing UnityEngine; TankMovement 클래스: MonoBehaviour { public ParticleSystem m_TrailParticleSystem; void Update() { GameStats.TankTrailParticleCount.Value += m_TrailParticleSystem.particleCount; } }
커스텀 프로파일러 모듈에 프로파일러 카운터 추가
코드를 통해 커스텀 프로파일러 모듈에 프로파일러 카운터를 표시하려면 새 스크립트를 생성하고 표시되는 카운터, 카운터 이름, 아이콘을 포함한 모듈의 프로퍼티를 정의해야 합니다. 이를 수행하는 방법에 대한 자세한 내용은 코드에서 프로파일러 모듈 생성을 참조하십시오.
ProfilerModule