기술 자료

Unity 엔진

Unity 엔진

코드에 프로파일러 카운터 추가

프로파일러 카운터를 사용하여 특정 통계를 수집합니다.
읽는 시간 2분최근 업데이트: 9일 전

프로파일러 카운터를 추가하려면 다음을 수행하는 스크립트를 생성합니다.
이 섹션의 코드 예제는 프로파일러 카운터를 추가하여 Unity 게임 오브젝트의 트레일 효과의 모든 인스턴스에 대해 생성한 총 파티클 수를 추적합니다. 이 예제에서 게임 오브젝트의 이름은 "Tank"입니다.

필수 조건

일부 예제에서는 시작하기 전에 설치해야 하는 Profiling Core 패키지를 사용합니다. Unity 프로파일링 코어 패키지는 코어 패키지이므로 패키지 관리자 UI에서 검색할 수 없습니다. 패키지를 설치하려면 이름을 추가합니다, 즉
com.unity.profiling.core
.

카운터 생성 및 정의

새 카운터를 생성하려면:
  1. 새 카운터의 값 타입을 정의하는 스크립트를 작성합니다.
  2. 이름과 유닛을 이 타입에 할당합니다.
중요
카운터를 생성할 때 새로운 카운터가 속한 프로파일러 카테고리를 지정해야 합니다. 이렇게 하려면
ProfilerCategory
클래스의 기존 Unity 카테고리를 사용합니다. 다음 예제의 스크립트는 기존의
ProfilerCategory.Scripts
카테고리를 사용합니다.
프로파일러 카운터 API 푸시 및 풀 작업을 지원합니다. 카운터의 값을 프로파일러로 푸시하거나, 프로파일러는 프레임 마지막에 값을 가져올 수 있습니다.
데이터가 자주 변경되지 않는 경우(예: 프레임당 한 번),
ProfilerCounter
API를 사용하여 카운터 데이터를 프로파일러로 푸시합니다. 프레임당 데이터가 여러 번 변경되면
ProfilerCounterValue
API를 사용합니다. 이렇게 하면 프로파일러가 프레임이 끝날 때 마지막 값을 자동으로 가져옵니다.
다음 예제 스크립트는 이름이
Tank Trail Particles
이고 단위가
ProfilerMarkerDataUnit.Count
인
ProfilerCounterValue
TankTrailParticleCount
를 정의합니다.
public 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);}
옵션
FlushOnEndOfFrame
및
ResetToZeroOnFlush
는 카운터를 프로파일러 데이터 스트림으로 자동으로 보내 프레임이 끝날 때 Count 값을 0으로 초기화합니다.

카운터 값 업데이트

카운터의 값을 업데이트하려면 정의한 카운터의 값을 설정하는 MonoBehaviour 스크립트를 생성합니다.
다음 MonoBehaviour 스크립트는 Update 함수의 프레임마다 할당된 게임 오브젝트에 속하는 트레일 파티클의 수를 계산합니다. 이를 위해서는
TankTrailParticleCount
카운터를 사용합니다.
다음 예제 스크립트는 인스펙터에서 트레일 파티클 시스템(
m_TrailParticleSystem
)이라는 공용 프로퍼티도 생성합니다.
using UnityEngine; TankMovement 클래스: MonoBehaviour { public ParticleSystem m_TrailParticleSystem; void Update() { GameStats.TankTrailParticleCount.Value += m_TrailParticleSystem.particleCount; } }

커스텀 프로파일러 모듈에 프로파일러 카운터 추가

코드를 통해 커스텀 프로파일러 모듈에 프로파일러 카운터를 표시하려면 새
ProfilerModule
스크립트를 생성하고 표시되는 카운터, 카운터 이름, 아이콘을 포함한 모듈의 프로퍼티를 정의해야 합니다. 이를 수행하는 방법에 대한 자세한 내용은 코드에서 프로파일러 모듈 생성을 참조하십시오.

추가 리소스