퍼포먼스 히트맵
퍼포먼스 히트맵은 게임 맵 위에 퍼포먼스 데이터를 오버레이 표시하는 Framedash의 핵심 기능입니다.
SDK가 수집하는 퍼포먼스 샘플에는 위치 정보 (월드 좌표)가 포함됩니다. 이를 맵 이미지 위에 플로팅하고 컬러 그라데이션으로 시각화한 것이 히트맵입니다.
시각화할 수 있는 메트릭
섹션 제목: “시각화할 수 있는 메트릭”- FPS: 프레임 레이트 분포. 빨간 영역은 퍼포먼스가 낮은 곳
- 프레임 타임: 프레임당 처리 시간
- GPU 시간: 렌더링 병목 지점 파악
- 메모리 사용량: 메모리 누수 발견
필터링
섹션 제목: “필터링”맵 상세 페이지의 컨트롤로 다음 조건에 따라 표시를 좁힐 수 있습니다:
- 메트릭: FPS, 프레임 타임, GPU 시간, 메모리 등(퍼포먼스 모드). 이벤트 모드에서는 이벤트 이름으로 좁힙니다
- 셀 크기: 집계 격자의 크기(5m / 10m / 25m / 50m)
- 기간: 최근 1 / 7 / 14 / 30일
- 빌드: 표시할 빌드를 하나 선택합니다(여러 빌드를 동시에 표시할 수 없습니다)
- 플랫폼: windows, android 등
- 색상 모드: 상대 표시와 임계값 표시 전환
- Z축(높이): 높이 범위를 좁히는 슬라이서
퍼포먼스 데이터에 해상도, GPU, 스토리지, 빌드 구성 속성이 포함되어 있으면 그 차원으로도 좁힐 수 있습니다. 임계값 프로필을 쓰면 이 속성별로 합격/불합격 임계값을 전환할 수 있습니다.
빌드 비교
섹션 제목: “빌드 비교”히트맵 자체는 빌드 하나를 표시합니다. 두 빌드를 비교할 때는 회귀 페이지를 사용합니다. 회귀 페이지는 기준 빌드와 후보 빌드를 선택해 FPS, 프레임 타임 등의 지표를 수치 표로 비교합니다. 히트맵을 나란히 놓고 보여주는 화면이 아닙니다.
에디터 내 클라우드 히트맵
섹션 제목: “에디터 내 클라우드 히트맵”UE5 SDK 0.1.7 이상에서는 FramedashEditor 모듈이 추가하는 Framedash Heatmap 탭에서 클라우드에서 집계된 히트맵을 에디터 안에서 직접 가져올 수 있습니다. 0.1.13 이상에서는 Play-in-Editor(PIE)가 아닌 상태에서 각 레벨 뷰포트의 Show > Framedash Heatmap을 활성화하세요. 히트맵은 PIE 중 자동으로 일시 중지되고 종료 후 복원됩니다. 자세한 내용은 UE5 SDK 가이드를 참고하세요.
Unity SDK 0.1.4 이상에서는 에디터 전용 Framedash.Editor 어셈블리가 클라우드에서 집계된 히트맵 셀을 SceneView에 반투명 쿼드로 오버레이합니다. 자세한 내용은 Unity SDK 가이드를 참고하세요.
PNG 내보내기
섹션 제목: “PNG 내보내기”맵 상세 페이지(프로젝트 → [프로젝트] → 맵 → [맵])에서 현재 히트맵 뷰를 PNG 이미지로 내보낼 수 있습니다. 이미지는 클라이언트 측에서 렌더링되며, 파일 이름은 맵 이름과 모드에서 파생됩니다.
Free 플랜에서는 내보낸 이미지 오른쪽 아래에 작은 “Powered by Framedash” 워터마크가 들어갑니다. 유료 플랜(Starter 이상)에서는 브랜드 표시 없이 내보냅니다.
맵 이미지
섹션 제목: “맵 이미지”히트맵의 배경이 되는 맵 이미지는 다음 방법으로 등록할 수 있습니다:
- 수동 업로드: 대시보드 또는 API에서 이미지 업로드
- CI 자동 캡처: 빌드 파이프라인에서 월드 좌표 메타데이터가 포함된 이미지를 자동 생성