장면 분석

Scene Analysis 도구는 Roblox Studio에서 클라이언트와 서버 장면의 구성 방식, 사용 중인 리소스, 해당 리소스 사용에 책임이 있는 인스턴스에 대한 비교 정보를 즉시 제공하는 다양한 보기를 제공합니다. Scene Analysis는 플레이 및 테스트 세션 중에 사용하도록 설계되었으며, 클라이언트와 서버 데이터 모델을 모두 검사할 수 있습니다.

Scene Analysis 활성화

1. 파일 > 베타 기능에서 Scene Analysis를 활성화합니다.
2. 메뉴 바에서 창 > 성능 요약 > Scene Analysis를 선택합니다.

Scene Analysis 사용

Scene Analysis는 플레이 또는 테스트 세션 중에 사용되도록 설계되었습니다. Scene Analysis 창을 열고 사용 가능한 모드를 탐색합니다. 모드가 활성화되면 보는 리소스의 상대적 크기와 기여하는 인스턴스를 보여주는 상자 구성의 표시—사각형화된 트리맵 보기를 볼 수 있습니다.

• 사각형화된 트리맵 보기 아래에 현재 보기의 모든 항목 목록이 표시됩니다.
• Scene Analysis에서 선택된 항목을 마우스 오른쪽 버튼으로 클릭하면 Explorer에서 해당 항목으로 바로 이동할 수 있습니다.
• 검색 표시줄을 사용하여 현재 표시에서 이름으로 필터링할 수 있습니다.

모드

Scene Analysis는 각각 다른 사용 사례에 맞춘 여러 가지 모드를 제공합니다.

스크립트 메모리

이 보기에서는 Script, LocalScript, 및 ModuleScript가 Luau VM에서 사용하는 메모리 양을 보여 줍니다. 이는 테이블 및 기타 스크립트 할당에 의해 사용되는 메모리이며, 애니메이션, 텍스처 및 사운드와 같은 자산에서 사용되는 메모리는 아닙니다. 이 보기는 스크립트가 실행되는 일반 위치와 Script와 ModuleScript별로 더 세분화됩니다.

부모가 없는 인스턴스

부모가 없는 인스턴스 뷰는 어떤 스크립트와 모듈이 인스턴스를 참조하고 있는지를 유형별 개수로 보여줍니다.

인스턴스를 참조하는 스크립트는 정상이므로, 그 자체로 버그나 메모리 누수를 나타내는 것은 아닙니다. 그러나 메모리 누수를 조사하는 경우, 이 보기를 통해 스크립트가 예상치 못한 작업을 수행하고 있는지 쉽게 확인할 수 있습니다.

메모리 누수의 근본 원인을 찾는 데 여전히 문제가 있는 경우, 이 도구는 개별 할당에 대한 더 많은 정보를 보여줄 수 있는 Luau 힙 도구와 보완적으로 사용할 수 있습니다.

이 보기에서 어떤 스크립트든 마우스 오른쪽 버튼으로 클릭하여 Explorer에서 직접 선택할 수 있습니다.

인스턴스 구성

인스턴스 구성 보기는 현재 클라이언트 또는 서버에 존재하는 인스턴스를 보여줍니다. 이는 큰 복잡한 빌드를 작업할 때 매우 귀중하며, 각 인스턴스는 복제 및 메모리 비용을 모두 수반합니다.

캐릭터, 지오메트리, 텍스처와 같은 카테고리는 장면의 균형을 이해하는 데 도움을 주기 위해 설계되었습니다. 예를 들어, 25,000개의 입자 방출기를 보유하고 싶지는 않았지만 이 보기를 통해 이를 알 수 있습니다.

이 보기에서는 특정 유형의 모든 인스턴스를 쉽게 선택할 수 있습니다.

오디오 메모리

오디오 메모리 보기에서는 각 오디오 자산이 현재 소비하고 있는 메모리 양을 보여줍니다. 특정 오디오 트랙에서 사용되는 실제 메모리는 상당히 복잡하지만, 실질적으로는 오디오 트랙을 참조하는 모든 인스턴스를 삭제하면 해당 메모리가 언로드됩니다.

이 보기에서 어떤 오디오 자산이든 마우스 오른쪽 버튼으로 클릭하여 이를 사용하는 모든 인스턴스를 선택할 수 있습니다.

애니메이션 메모리

애니메이션 자산은 생산에서 메모리 누수가 가장 흔하게 발생하는 원인 중 하나입니다. Roblox는 사용되지 않는 애니메이션 자산을 aggressive하게 언로드하지만, 모델이 파괴된 후에도 스크립트가 애니메이션을 활성화 상태로 유지하는 것이 일반적입니다.

오디오 자산과 마찬가지로, 애니메이션 자산을 참조하는 모든 인스턴스를 삭제하면 애니메이션이 언로드됩니다.

이 보기와 부모가 없는 인스턴스 보기를 통해 애니메이션의 생애 주기를 추적하고 실제로 사용 중인 메모리 양을 쉽게 파악할 수 있습니다.

이 보기에서 어떤 애니메이션이든 마우스 오른쪽 버튼으로 클릭하여 이를 사용하는 모든 인스턴스를 선택할 수 있습니다.

삼각형 구성

삼각형 구성 보기는 현재 주요 뷰포트에서 렌더링되고 있는 삼각형 및 드로우 호출에 대한 더 구체적인 분석을 제공합니다.

이 분석에는 그림자, 불투명, 투명, 지형, 풀, 입자, 하늘, UI에 대한 수치가 포함됩니다.

이 구성 정보는 장면 기하학이 어떻게 구성되어 있는지를 더 잘 이해하고 장면에 예상치 못한 기하학이 포함된 경우를 식별하는 데 도움을 줍니다.

엔진 API

또한 SceneAnalysisService를 통해 프로그래밍 방식으로 Scene Analysis 데이터를 액세스할 수 있으며, 이는 MCP 서버를 통해 노출됩니다. 각 메서드는 시각적 표시에서 사용하는 것과 동일한 데이터를 포함하는 중첩된 자식 테이블을 반환합니다.