기술 자료

Unity 엔진

Unity 엔진

웹 플레이어 설정

웹 플레이어 설정의 UI 설명을 참고하십시오.
읽는 시간 14분최근 업데이트: 9일 전

플레이어 설정을 사용하여 Unity가 최종 웹 애플리케이션을 어떻게 빌드하고 표시하는지 확인합니다. 일반적인 플레이어 설정에 대한 설명은 플레이어 설정을 참조하십시오.
웹 플레이어 설정에 액세스하려면:
  • Unity 메인 메뉴에서 편집 >
    프로젝트 설정

    ?

    > 플레이어로 이동합니다. 플레이어 설정 창이 나타납니다.
  • 웹 탭을 선택하여 웹 플레이어 설정을 확인합니다.

Web Player settings

다음 섹션에서 프로퍼티에 대한 기술 자료를 확인할 수 있습니다.
참고
Icon 패널이 웹 플레이어 설정에 나타나지만 웹 게임이 아이콘을 사용하지 않으므로 사용할 수 있는 아이콘 설정은 없습니다.
웹 퍼블리싱 설정에 대한 자세한 내용은 웹 빌드 및 실행을 참조하십시오.

해상도 및 프레젠테이션

해상도 섹션의 화면 모양을 커스터마이즈하려면 해상도 및 프레젠테이션 섹션을 사용합니다.

Resolution section for the Web Player platform

해결 방법

다음 옵션을 편집하여 웹 캔버스 요소의 화면 모드와 기본 크기를 커스터마이즈할 수 있습니다.

설정

**함수

기본 캔버스 너비웹 캔버스 요소의 너비를 설정합니다.
기본 캔버스 높이웹 캔버스 요소의 높이를 설정합니다.
배경에서 실행이 옵션을 활성화하면 캔버스 또는 브라우저 창이 포커스를 잃을 때 콘텐츠가 계속 실행됩니다.

웹 템플릿

웹 프로젝트에 사용할 템플릿을 선택합니다.
  • 기본 페이지는 회색 캔버스에 로딩 바가 있는 간단한 흰색 페이지입니다.
  • Minimal 페이지에는 웹 콘텐츠를 실행하는 데 필요한 보일러플레이트 코드만 있습니다.
  • PWA 페이지에는 웹 매니페스트 파일과 서비스 워커 코드가 포함된
    프로그레시브 웹 앱

    ?

    가 있습니다.
웹 템플릿의 지침을 사용하여 완성된 게임과 유사한 환경에서 게임을 실행할 수 있습니다.

스플래시 이미지(Splash Image)

가상 현실 스플래시 이미지 설정을 사용하여 XR 디스플레이에 대한 커스텀 스플래시 이미지를 선택합니다. 일반적인 스플래시 화면 설정에 대한 자세한 내용은 스플래시 화면을 참조하십시오.

Splash screen settings for virtual reality.

기타 설정

이 섹션에서는 다음 그룹으로 구성된 다양한 옵션을 커스터마이즈할 수 있습니다.

렌더링

다음 설정을 사용하여 Unity 웹 플랫폼용으로 게임을 렌더링하는 방법을 커스터마이즈합니다.

Rendering Player settings for the Web platform

프로퍼티

설명

색 공간
렌더링에 사용할 색 공간 선택합니다. 자세한 내용은 색 공간을 참조하십시오.
  • Gamma: 감마 색 공간 일반적으로 프레임버퍼 포맷에 대해 채널당 8비트로 제한된 구형 하드웨어의 조명을 계산하는 데 사용됩니다. 오늘날 모니터는 디지털이지만 여전히 감마로 인코딩된 신호를 입력으로 받습니다.
  • Linear: 선형 색 공간 렌더링은 더 정확한 결과를 제공합니다. 선형 색 공간에서 작업하도록 선택하면 에디터는 sRGB 샘플링을 사용하도록 기본 설정합니다. 선형 색 공간에 있는 텍스처의 경우 선형 색 공간에서 작업하고 각 텍스처에 대해 sRGB 샘플링을 비활성화해야 합니다.
자동 그래픽스 API
기본 웹 그래픽스 API(WebGL 2.0)를 활성화합니다. 기본적으로 이 옵션은 활성화되어 있습니다. 그래픽스 API를 수동으로 선택하고 순서를 변경하려면 이 옵션을 비활성화합니다.
정적 배칭
정적 배칭을 사용하려면 이 옵션을 활성화합니다.
동적 배칭
빌드에서 동적 배칭을 사용합니다(기본적으로 활성화됨).
참고: 스크립터블 렌더 파이프라인이 활성화된 경우 동적 배칭에는 영향이 없습니다. 따라서 이 설정은 스크립터블 렌더 파이프라인 에셋 그래픽스 설정이 비어 있는 경우에만 표시됩니다.
그래픽스 잡(실험 단계)
그래픽스 작업(루프 렌더링)을 다른 CPU 코어에서 실행되는 워커 스레드에 오프로드하도록 Unity 지시하려면 이 옵션을 활성화합니다. 이는 종종 병목 현상인 메인 스레드의
Camera.Render
에 소요되는 시간을 줄이기 위한 것입니다.
참고
이 기능은 실험 단계입니다. 프로젝트의 성능이 개선되지 않을 수 있으며, 새로운 크래시가 발생할 수 있습니다.
텍스처 압축 포맷
웹 플랫폼의 텍스처 압축 포맷을 설정하려면 DXT, ETC2 또는 ASTC를 선택합니다. 올바른 형식을 선택하는 방법에 대한 자세한 내용은 텍스처 압축 형식 개요를 참조하십시오. 스크립트에서 데스크톱 및 모바일 브라우저용 빌드를 생성하려면 웹의 텍스처 압축을 참조하십시오.
라이트맵 인코딩
라이트맵의 인코딩 방식과 압축 포맷을 정의합니다.
Low Quality, Normal Quality 또는 High Quality 중에서 선택할 수 있습니다.
HDR 큐브맵 인코딩
HDR 큐브맵의 인코딩 방식 및 압축 포맷을 정의합니다.
Low Quality, Normal Quality, High Quality 중에서 선택할 수 있습니다. 자세한 내용은 라이트맵: 기술 정보.
라이트맵 스트리밍
이 옵션을 활성화하면 라이트맵에 Mipmap Streaming을 사용합니다. Unity 이를 생성할 때 모든 라이트맵에 이 설정을 적용합니다.
참고: 이 설정을 사용하려면 텍스처 맵 스트리밍 품질 설정을 활성화해야 합니다.
스트리밍 우선 순위
모든 라이트맵에 대한 우선 순위를 설정하십시오. Mipmap Streaming 시스템. Unity 이를 생성할 때 모든 라이트맵에 이 설정을 적용합니다.
양수는 우선순위가 더 높습니다. 유효한 값의 범위는
-128
에서
127
입니다.
프레임 타이밍 통계
FrameTimingManager API를 사용하여 CPU 및 GPU 프레임 타이밍 데이터를 수집하려면 이 프로퍼티를 활성화합니다. 이 프로퍼티를 비활성화하면 다이내믹 해상도 카메라 설정이 이 데이터를 사용하여 GPU 워크로드를 줄이기 위해 해상도를 동적으로 조정할 수 없습니다.
가상 텍스처링(실험 단계)
씬에 고해상도 텍스처가 많은 경우 GPU 메모리 사용량과 텍스처 로딩 시간을 줄입니다. 자세한 내용은 가상 텍스처링을 참조하십시오.
참고: 이 프로퍼티를 적용하려면 Unity 에디터 다시 시작해야 합니다.
셰이더 정밀도 모델
샘플러의 기본 정밀도와 셰이더에 사용되는
half
의 정의를 선택합니다. 자세한 내용은 ShaderPrecisionModel을 참조하십시오.
360개 스테레오 캡처
Unity 양안 360도 이미지 및 비디오를 캡처할 수 있는지 여부를 지정합니다. 활성화하면 Unity 추가 셰이더 배리언트를 컴파일하여 360 캡처를 지원합니다(현재는 Windows 해당).
enable_360_capture
키워드는
RenderToCubemap
호출 중에 추가되지만 이 함수 외부에서는 트리거되지 않습니다.

설정

Configuration settings for the Web platform

프로퍼티

설명

스크립팅 백엔드:
사용할 스크립팅 백엔드를 선택합니다. 스크립팅 백엔드는 Unity 프로젝트에서 C# 코드를 컴파일하고 실행하는 방식을 결정합니다.
  • Mono: C# 코드를 .NET 공용 중간 언어(CIL)로 컴파일하고 공용 언어 런타임을 사용하여 해당 CIL을 실행합니다. 자세한 내용은 Mono 를 참조하십시오.
  • IL2CPP

    ?

    : C# 코드를 CIL로 컴파일하고 CIL을 C++로 전환한 다음 해당 C++를 런타임 시 직접 실행되는 네이티브 기계어 코드 컴파일합니다. 자세한 내용은 IL2CPP를 참조하십시오.
API 호환성 수준
프로젝트에 사용할 .NET API를 선택합니다. 이 설정은 타사 라이브러리와의 호환성에 영향을 미칠 수 있습니다. 하지만 에디터 전용 코드(에디터 디렉토리 또는 에디터 전용 어셈블리 정의 내 코드)에는 영향을 미치지 않습니다.
팁 타사 어셈블리에 문제가 있는 경우 API 호환성 수준 섹션에서 제안을 시도해 보십시오.
  • .Net Framework: .NET Framework 4와 호환됩니다(.NET Standard 2.0 프로파일의 모든 사항과 추가 API 포함). .NET Standard 2.0에 포함되지 않은 API에 액세스하는 라이브러리를 사용하는 경우 이 옵션을 선택합니다. 대형 빌드를 생성하며 사용 가능한 추가 API는 반드시 모든 플랫폼에서 지원되지 않습니다. 자세한 내용은 추가 클래스 라이브러리 어셈블리 참조를 참조하십시오.
  • .Net Standard 2.1: 소형 빌드를 생성하고 크로스 플랫폼 완벽하게 지원합니다.
에디터 어셈블리 호환성 레벨
에디터 어셈블리에 사용할 .NET API를 선택합니다.
  • .NET 프레임워크: .NET Framework 4와 호환됩니다(.NET Standard 2.1 프로파일의 모든 사항과 추가 API 포함). .NET Standard 2.1에 포함되지 않은 API에 액세스하는 라이브러리를 사용하는 경우 이 옵션을 선택합니다. 대형 빌드를 생성하며 사용 가능한 추가 API는 반드시 모든 플랫폼에서 지원되지 않습니다. 자세한 내용은 추가 클래스 라이브러리 어셈블리 참조를 참조하십시오.
  • .NET Standard: .NET Standard 2.1 와 호환됩니다. 소형 빌드를 생성하고 크로스 플랫폼 완벽하게 지원합니다.
IL2CPP 코드 생성
Unity IL2CPP 코드 생성을 관리하는 방법을 정의합니다.
참고: 이를 사용하려면 스크립팅 백엔드를 IL2CPP로 설정합니다.
C++ 컴파일러 설정
IL2CPP 생성 코드를 컴파일할 때 사용할 C++ 컴파일러 설정을 선택합니다.
  • --debug 디버그 구성은 모든 최적화를 해제하여 코드를 더 빠르게 빌드할 수 있지만 실행 속도가 느려집니다.
  • ** !release 릴리스 구성을 사용하면 컴파일된 코드가 더 빠르게 실행되고 바이너리 크기가 줄어들지만 컴파일 시간이 더 오래 걸립니다.
  • master 마스터 구성을 사용하면 가능한 모든 최적화를 수행하여 성능을 최대한 높일 수 있습니다. 예를 들어 MSVC++ 컴파일러를 사용하는 플랫폼에서 이 옵션은 링크 타임 코드 생성을 활성화합니다. 이 구성을 사용하여 코드를 컴파일하는 데는 릴리스 구성을 사용하는 것보다 훨씬 오래 걸릴 수 있습니다. 빌드 시간이 늘어날 수 있는 경우 마스터 구성을 사용하여 게임의 출시 버전을 빌드하는 것이 좋습니다.
증분 GC 사용
점진적 가비지 컬렉터 사용합니다. 점진적 가비지 컬렉터는 가비지 컬렉션 여러 프레임에 분산하여 프레임 기간의 가비지 컬렉션 관련 스파이크를 줄입니다. 자세한 내용은 자동 메모리 관리를 참조하십시오.
HTTP를 통한 다운로드 허용
HTTP를 통해 콘텐츠를 다운로드할지 여부를 지정합니다. 기본 옵션은 권장되는 프로토콜이 더 안전한 HTTPS이므로 허용되지 않음입니다.
  • 허용 안 함: HTTP를 통한 다운로드를 허용하지 않습니다.
  • 개발용 빌드에서 허용됨: 개발 빌드에서 HTTP를 통한 다운로드만 허용합니다.
  • 항상 허용됨: 개발 및 릴리스 빌드에서 HTTP를 통한 다운로드를 허용합니다.
활성 입력 처리
사용자의 입력을 처리하는 방식을 선택합니다.
  • 입력 관리자(이전): 원래의 입력 설정을 사용합니다.
  • Both 두 시스템 모두 사용합니다.

셰이더 배리언트 로딩 중

이 설정을 사용하여 런타임 시 셰이더가 사용하는 메모리 양을 제어합니다.

프로퍼티

설명

기본 청크 크기(MB)모든 플랫폼에서 Unity 빌드된 애플리케이션에 저장하는 압축된 셰이더 배리언트 데이터 청크의 최대 크기를 설정합니다. 기본값은
16
입니다. 자세한 내용은 셰이더 로딩을 참고하십시오.
기본 청크 수Unity 모든 플랫폼에서 메모리에 보관하는 압축 해제된 청크의 기본 제한을 설정합니다. 기본값은
0
이므로 제한이 없습니다.
오버라이드이 빌드 타겟에 대해 기본 청크 크기 및 기본 청크 수를 오버라이드할 수 있습니다.
Chunk size(MB)이 빌드 타겟의 기본 청크 크기(MB) 값을 오버라이드합니다.
Chunk count이 빌드 타겟의 기본 청크 수 값을 오버라이드합니다.

API 호환성 수준

모든 타겟에 대한 Mono API 호환성 레벨을 선택할 수 있습니다. 타사 .NET 라이브러리가 .NET 호환성 레벨을 벗어난 기능을 사용하는 경우도 있습니다. 이러한 경우 발생하는 상황과 문제를 해결하는 방법을 이해하려면 다음 제안을 따르십시오.
  1. Windows용 ILSpy 설치.
  2. 문제가 있는 API 호환성 수준의 .NET 어셈블리를 ILSpy로 드래그합니다.
    Frameworks/Mono/lib/mono/YOURSUBSET/
    에서 문제가 있는 파일을 찾을 수 있습니다.
  3. 타사 어셈블리를 드래그합니다.
  4. 타사 어셈블리를 오른쪽 클릭하고 분석을 선택합니다.
  5. 분석 보고서에서 종속성 섹션을 확인합니다. 리포트에는 타사 어셈블리가 의존하지만 선택한 .NET 호환성 레벨에서 사용할 수 없는 항목이 빨간색으로 강조 표시됩니다.

스크립트 컴파일

Script compilation settings for the Web platform

프로퍼티

설명

스크립팅 정의 기호커스텀 컴파일 플래그를 설정합니다.

자세한 내용은 플랫폼별 컴파일을 참조하십시오.
추가 컴파일러 인자Roslyn C# 컴파일러에 전달할 추가 인자를 지정합니다. 리스트 엔트리당 하나의 유효한 컴파일러 인자를 입력합니다. 새 항목을 만들려면 **추가(+)**를 선택합니다. 항목을 제거하려면 **제거(-)**를 선택합니다. 새로 추가된 인자를 향후 컴파일에 포함하려면 적용을 선택합니다. 목록을 가장 최근에 적용된 상태로 초기화하려면 Revert를 선택합니다. 인수는
csc.exe
구문(예:
-warnaserror
)을 사용해야 합니다. 지원되는 Roslyn 컴파일러 옵션의 전체 목록은 Microsoft 문서의 C# 컴파일러 옵션을 참조하십시오.

또한 프로젝트의
Assets
폴더에 있는
csc.rsp
리스폰스 파일을 사용하여 C# 컴파일러에 추가 커맨드 라인 인자를 제공할 수도 있습니다. 응답 파일 생성에 대한 자세한 내용은 응답 파일 생성을 참조하십시오. 참고: 추가 컴파일러 인자 리스트와 응답 파일 모두에서 동일한 인자를 정의하면 오류와 의도치 않은 동작이 발생할 수 있습니다.
일반적인 경고 해제C# 경고 CS0169 및 CS0649를 표시할지 여부를 나타냅니다.
'안전하지 않은' 코드 허용사전 정의된 어셈블리(예:
Assembly-CSharp.dll
)에서 '안전하지 않은' C# 코드 컴파일에 대한 지원을 활성화합니다.
어셈블리 정의 파일(
.asmdef
)의 경우,
.asmdef
파일 중 하나를 클릭하고 인스펙터 창에 있는 옵션을 활성화합니다.
결정적 컴파일 사용
-deterministic
C# 플래그로 컴파일을 방지할지 여부를 나타냅니다. 이 설정을 활성화하면 컴파일된 어셈블리는 컴파일될 때마다 바이트당 동일합니다.

자세한 내용은 코드 생성을 제어하는 C# 컴파일러 옵션을 참조하십시오.

최적화

Optimization settings for the Web platform

프로퍼티

설명

충돌 메시 사전 베이크
빌드 시 충돌 데이터를 메시에 추가합니다.
사전 로드된 에셋
시작 시 플레이어가 로드할 에셋 배열을 설정합니다.
새 에셋을 추가하려면 Size 프로퍼티의 값을 늘린 후 나타나는 새 Element 상자에 로드할 에셋에 대한 레퍼런스를 설정합니다.
엔진 코드 스트립
프로젝트가 사용하지 않는 Unity 엔진 기능에 대한 코드를 Unity Linker 툴에서 제거하려면 이 옵션을 활성화합니다. 이 설정은 IL2CPP 스크립팅 백엔드에서만 사용할 수 있습니다. 대부분의 앱 사용 가능한 모든 DLL을 사용하지 않습니다. 이 옵션은 앱이 빌드된 플레이어의 크기를 줄이기 위해 사용하지 않는 DLL을 제외합니다. 앱에서 현재 설정에서 일반적으로 스트리핑되는 클래스를 하나 이상 사용 중인 경우 앱을 빌드하려고 할 때 Unity 디버그 메시지를 표시합니다.
관리되는 스트리핑 레벨
Unity 사용되지 않는 관리되는(C#) 코드를 얼마나 적극적으로 스트리핑할지 선택합니다. Unity 앱을 빌드할 때 Unity Linker 프로세스는 프로젝트에서 사용하는 관리되는 DLL에서 사용되지 않는 코드를 스트리핑할 수 있습니다. 코드를 스트리핑하면 결과 실행 파일이 작아질 수 있지만, 사용 중인 코드를 제거할 수도 있습니다.
이러한 옵션과 IL2CPP로 바이트코드 스트리핑에 대한 자세한 내용은 ManagedStrippingLevel을 참조하십시오.
  • 최소 클래스 라이브러리, UnityEngine, Windows 런타임 어셈블리를 스트리핑하고 다른 모든 어셈블리를 복사할 때 사용합니다.
  • 낮음 도달할 수 없는 관리되는 코드를 제거하여 빌드 크기와 Mono/IL2CPP 빌드 시간을 단축합니다.
  • 중급 UnityLinker를 실행하여 Low를 초과하여 코드 크기를 줄입니다. 커스텀 link.xml 파일을 지원해야 할 수 있으며 일부 반사 코드 경로는 동일하게 동작하지 않을 수 있습니다.
  • High UnityLinker는 최대한 많은 코드를 스트리핑합니다. 이렇게 하면 Medium이 달성할 수 있는 것 이상으로 코드 크기를 줄일 수 있지만 일부 메서드의 관리되는 코드 디버깅은 더 이상 작동하지 않을 수 있습니다. 커스텀 link.xml 파일을 지원해야 할 수 있으며 일부 반사 코드 경로는 동일하게 동작하지 않을 수 있습니다.
내부 프로파일러 활성화(사용 중단 예정)
이 기능은 지원이 중단되어 향후 Unity 버전에서 지원이 중단될 예정입니다. 대신 프로파일러 창을 사용합니다(메뉴: Window > Analytics > Profiler).
프로파일러가 애플리케이션 퍼포먼스 데이터 수집하고 콘솔에 보고서를 출력합니다. 이 보고서에는 각 Unity 하위 시스템이 각 프레임에서 실행하는 데 걸리는 밀리초 수가 포함되어 있으며, 평균 30프레임에 걸쳐 표시됩니다.
버텍스 압축
채널당 버텍스 압축을 설정합니다. 이는 프로젝트의 모든 메시에 영향을 줍니다.
일반적으로 버텍스 압축은 메모리의 메시 데이터 크기를 줄이고 파일 크기를 줄이고 GPU 성능을 개선하는 데 사용됩니다.
버텍스 압축을 구성하는 방법과 이 설정의 제한 사항에 대한 자세한 내용은 메시 데이터 압축을 참조하십시오.
메시 데이터 최적화
빌드에 사용된 메시에서 미사용 버텍스 속성을 스트리핑하려면 이 옵션을 활성화합니다. 메시의 데이터 양을 줄여 빌드 크기, 로딩 시간, 런타임 메모리 사용량을 줄일 수 있습니다.
경고: 이 설정을 활성화한 경우 런타임 시 머티리얼 또는 셰이더 설정을 변경하지 마십시오.
자세한 내용은 PlayerSettings.stripUnusedMeshComponents를 참조하십시오.
텍스처 밉맵 스트리핑
모든 플랫폼에 대해 밉맵 스트리핑을 활성화합니다. 이는 빌드 시 텍스처에서 미사용 밉맵 레벨을 스트리핑합니다.
Unity는 현재 플랫폼에 대한 품질 설정과 비교하여 사용되지 않는 칠맵 레벨을 결정합니다. 현재 플랫폼의 모든 품질 설정에서 밉맵 레벨이 제외된 경우 Unity 빌드 시 빌드 시 해당 밉맵 레벨을 빌드에서 스트리핑합니다.
QualitySettings.globalTextureMipmapLimit
값이 스트리핑되었을 때는 Unity가 스트리핑되지 않은 값을 스트리핑되지 않은 가장 가까운 값으로 설정합니다.

Stack Trace

웹 플랫폼의 로깅 설정을 선택합니다.

Logging settings for the Web platform

필요한 로깅 타입에 따라 각 로그 타입에 해당하는 옵션(Error, Assert, Warning, Log, Exception)을 활성화하여 원하는 스택 추적 방법을 선택합니다. 자세한 내용은 스택 추적 로깅을 참조하십시오.

프로퍼티

설명

없음어떤 로그도 기록되지 않습니다.
ScriptOnly스크립트를 실행할 때만 로그합니다.
full항상 로깅합니다.

레거시

스킨드 메시 렌더러에서 블렌드 셰이프 가중치 범위를 고정하려면 Clamp BlendShapes (Deprecated) 옵션을 활성화합니다.

Legacy settings for the Web platform

퍼블리싱 설정

퍼블리싱 설정을 사용하여 Unity 웹 플랫폼 애플리케이션을 빌드하는 방식을 설정합니다. 예를 들어 브라우저 캐시를 활성화하여 파일을 빌드에 저장할 수 있습니다.

Publishing settings for the Web platform

프로퍼티

설명

압축 포맷릴리스 빌드 파일에 사용할 압축 포맷을 선택합니다. 옵션은 다음과 같습니다. Gzip, Brotli, Disabled(없음)。 이 옵션은 개발 빌드에 영향을 주지 않습니다.
이름 파일을 해시로 지정압축되지 않은 파일 콘텐츠의 MD5 해시를 빌드의 각 파일에 대한 파일 이름으로 사용하려면 이 옵션을 활성화합니다.
데이터 캐싱이 옵션을 활성화하면 콘텐츠 에셋 데이터가 사용자의 컴퓨터에 자동으로 캐시되므로 콘텐츠가 변경되지 않는 한 이후 실행 시 다시 다운로드할 필요가 없습니다.
캐싱은 브라우저에서 제공하는 IndexedDB API 사용하여 구현됩니다. 일부 브라우저는 특정 크기의 데이터를 캐싱할 권한을 사용자에게 요청하는 등의 제한을 적용할 수 있습니다.
디버그 기호사용 가능한 옵션 중에서 선택하여 빌드에 디버그 심볼을 추가하는 방법을 지정합니다.
  • 끄기 빌드에 디버그 기호를 추가하지 않으려면 이 옵션을 선택합니다.
  • 외부: 오류가 발생할 때 서버에서 다운로드할 수 있는 별도의 파일에 디버그 심볼을 저장하려면 이 옵션을 선택합니다. 릴리스 빌드에는 이 옵션을 선택하는 것이 좋습니다.
  • 내장: WASM 파일에 디버그 심볼을 포함하려면 이 옵션을 선택합니다. 이 옵션은 오류가 발생할 때 디버그 심볼을 보존하고 스택 추적의 디맹글링(원본 함수 이름 표시)을 수행하는 데 도움이 됩니다. 기본적으로 이 옵션에서 디맹글링 지원을 사용할 수 있습니다.
압축 풀기 폴백로더에 빌드 파일에 대한 압축 풀기 폴백 코드를 포함합니다. 선택한 압축 방법에 따라 서버 응답 헤더를 설정할 수 없는 경우 이 옵션을 사용합니다.
전력 환경 설정멀티 GPU 기기에서 렌더링할 때 사용할 GPU에 대한 환경 설정을 설정합니다. 브라우저가 이 환경 설정을 무시할 수 있습니다.
  • 기본: 브라우저가 GPU 구성을 선택합니다.
  • 낮은 성능: 브라우저가 내장된 GPU를 사용하여 전력 절감에 우선순위를 지정하도록 요청합니다.
  • 고성능: 브라우저가 외부 GPU를 사용하여 렌더링 성능의 우선 순위를 지정하도록 요청합니다.

WebAssembly 언어 기능

이 섹션을 사용하여 웹 애플리케이션의 WebAssembly 언어 기능을 커스터마이즈합니다.

프로퍼티

설명

예외 사용런타임 시 예기치 않은 코드 동작(일반적으로 오류로 간주됨)을 처리하는 방법을 선택합니다.
  • None: 예외가 발생하면 콘텐츠가 오류와 함께 중지됩니다. 예외 지원이 필요하지 않은 경우 이 옵션을 선택합니다. 최상의 성능과 가장 작은 빌드를 제공합니다.
  • 명시적으로 발생한 예외만(기본값): 스크립트의
    throw
    문에서 명시적으로 지정된 예외를 캡처하고
    finally
    블록이 호출되는지 확인합니다. 이 옵션을 사용하면 스크립트에서 생성된 JavaScript 코드가 더 길고 느려집니다. 스크립트가 프로젝트의 주요 병목 현상인 경우에만 문제가 될 수 있습니다.
  • 스택트레이스가 없는 전체: 스크립트, Null 레퍼런스 및 바운드 외 배열 액세스의
    throw
    문에서 명시적으로 지정된 예외를 캡처합니다.
  • 스택트레이스와 함께 전부: 스택트레이스없이 전부와 동일하지만 스택 트레이스를 캡처합니다. Unity 코드에 확인을 포함하여 이러한 예외를 생성하므로 이 옵션을 선택하면 성능이 저하되고 브라우저 메모리 사용량이 증가합니다. 디버깅 시에만 이 옵션을 사용하고 항상 64비트 브라우저에서 테스트합니다.
네이티브 C/C++ 멀티스레드 활성화WebAssembly/
SharedArrayBuffer
멀티스레딩을 대상으로 하는 네이티브 Unity C/C++ 엔진 코드를 사용하려면 이 옵션을 활성화합니다(실험 단계). 이 설정을 활성화하면 서버 구성에서 COOP(Cross-Origin Opener Policy), COEP(Cross-Origin Embedded Policy), CORP(Cross-Origin Resource Policy) 헤더를 설정해야 합니다. 이러한 헤더를 설정하는 방법의 예시는 서버 구성 코드 샘플을 참조하십시오. 모든 브라우저가
SharedArrayBuffer
를 지원하는 것은 아닙니다.

이 설정은 멀티스레딩 C# 코드를 활성화하지 않습니다. 이 설정은 WebAssembly 언어 표준을 향상해야 하기 때문입니다. 이 옵션을 비활성화하고 향후 웹 기능을 평가하는 데만 사용하는 것이 좋습니다.
WebAssembly 2023 활성화이 옵션을 활성화하면 생성된 WebAssembly 코드가 WebAssembly 2023를 타게팅합니다. WebAssembly 2023은 최신 WebAssembly 언어 기능을 선택하기 위한 Unity 코인 이름입니다. 이러한 기능은 다음과 같습니다. 기호 확장 옵코드, 트래핑되지 않는 fp-to-int 명령어, 일괄 메모리, JS BigInt 통합,
WebAssembly.Table
, 네이티브 WebAssembly 예외, SIMD(Chrome ≥ 91(2021년 5월), Firefox ≥ 89(2021년 6월) 또는 Safari ≥ 16.4(2023년 3월) 필요). 비활성화하면 원래 WebAssembly MVP 기능 집합을 타게팅합니다.
WebAssembly.Table 사용웹 빌드가 JS-Wasm 인터롭 및 빌드 시간을 단축하기 위해
WebAssembly.Table
언어 기능을 타게팅하도록 하려면 이 옵션을 활성화합니다. 이 옵션을 비활성화하면 웹 빌드는 이전 버전과의 호환성을 위해 지원이 중단된 이전 Emscripten
-sDYNCALLS
모델을 대상으로 합니다. 이전의 호환되지 않는 JavaScript 플러그인을 사용하지 않는 새 프로젝트에 이 옵션을 활성화하고 이전의
dynCall()
메커니즘에 의존하는
.jslib
파일을 사용하는 경우 이 옵션을 비활성화하는 것이 좋습니다.
참고:
WebAssembly.Table
은 역호환되지 않습니다.
WebAssembly.Table
를 타게팅할 때 Emscripten 런타임 함수
getWasmTableEntry(functionPtr)
를 사용하여 함수 포인터를 호출 가능한 JS 함수로 전환하거나 Emscripten 코드 템플릿
{{{ makeDynCall('sig', 'variableName') }}}(...args);
를 사용하여 함수 포인터를 호출합니다. 이전 Emscripten 런타임 함수 제품군
dynCall_sig(ptr, ...args);
은 더 이상
WebAssembly.Table
에서 지원되지 않습니다. 코드 예시는 Emscripten 기술 자료를 참고하십시오.
Enable BigInt이 옵션을 활성화하면
WebAssembly.BigInt
언어 기능을 타게팅하고 WebAssembly에서
BigInt
유형을 사용하므로 빌드 시간이 빨라지고 코드 크기가 약간 작아집니다. 이 옵션을 비활성화하면 WebAssembly에서
BigInt
유형을 사용할 수 없습니다. 생성된 WebAssembly 코드는 64비트 변수를 포함하는 함수 서명에 대해 BigInt ABI에 의존합니다. Wasm BigInt 기능을 지원하지 않는 기존 브라우저를 타게팅하려면 이 옵션을 비활성화합니다. 새 프로젝트에 대해 이 옵션을 활성화하고 빌드 반복 시간을 단축하고 이전 브라우저와 이전 버전과의 이전 버전과의 호환성 타게팅하는 것이 중요할 경우 이 옵션을 비활성화하는 것이 좋습니다.
참고: Wasm BigInt 기능에는 Chrome 85(2020년 8월 25일), Firefox 78(2020년 6월 30일), Safari 14.5(2021년 4월 26일) 이상이 필요합니다.
초기 메모리 크기WASM 힙 메모리의 초기 크기(MB)입니다. 기본 설정은 32MB입니다. **메모리 성장 모드(Memory Growth Mode)**가 **없음(None)**으로 설정된 경우, 이는 WASM 힙 메모리의 최대 크기입니다.
메모리 성장 모드다음 옵션 중에서 WASM 힙 메모리의 증가 모드를 선택합니다. 권장되는 옵션은 지오메트릭입니다.
  • None: WASM 힙 메모리는 초기 메모리 크기로 구성된 고정 크기입니다.
  • Linear: WASM 힙 메모리는 리니어 메모리 성장 단계에 의해 구성된 고정된 양으로 증가합니다.
  • Geometric: WASM 힙 메모리는 현재 힙 크기에 비례하여 지오메트리 메모리 성장 단계 및 지오메트리 메모리 성장 한도에 구성된 인자에 따라 증가합니다.
최대 메모리 크기WASM 힙 메모리의 최대 크기(MB)입니다. 기본적으로 권장되는 설정인 2048MB로 설정됩니다. 최대 4096MB의 메모리 크기를 입력할 수 있지만, 2048MB를 초과하는 빌드에 대한 Firefox 및 Chrome 버그가 알려져 있습니다. 이 옵션은 메모리 성장 모드의 선형 또는 지오메트리 모드에서만 사용할 수 있습니다.
리니어 메모리 성장 단계WASM 힙 성장 단계를 MB 단위로 제어하는 고급 튜닝 옵션입니다. 기본 설정은 16MB입니다. 성장 단계가 16MB이면 힙이 성장해야 할 때마다 16MB씩 증가합니다. 메모리 성장 모드가 **선형(Linear)**으로 설정된 경우에만 사용할 수 있습니다.
지오메트리 메모리 성장 단계현재 힙 크기를 기준으로 WASM 힙 성장 인자를 제어하는 고급 튜닝 옵션입니다. 기본적으로 이 값은 0.2로 설정되어 있습니다. 성장 인자 0.2는 힙이 성장해야 할 때마다 힙의 크기가 0.2 * currentHeapSize로 증가한다는 의미입니다. 메모리 성장 모드가 **지오메트릭(Geometric)**으로 설정된 경우에만 사용할 수 있습니다.
지오메트리 메모리 증가 한도(MB)힙 성장 단계의 상한을 제어하는 고급 튜닝 옵션(MB)입니다. 기본 설정은 96MB입니다. 96MB의 증가 한도는 힙의 크기가 최대 96MB만큼 증가한다는 의미입니다. 메모리 성장 모드가 **지오메트릭(Geometric)**으로 설정된 경우에만 사용할 수 있습니다.

진단 오버레이 설정 표시

웹 빌드를 최적화하고 잠재적인 문제를 진단하는 데 도움이 되도록 이 설정을 활성화하여 진단 정보(현재 메모리 사용량으로 제한됨)를 볼 수 있습니다. 활성화되면 빌드에 데이터가 포함된 오버레이를 표시하는 아이콘이 나타납니다. 개발 빌드와 릴리스 빌드 모두에서 사용할 수 있습니다.
  1. 진단 정보를 보려면 플레이어 설정 창(File > Build Profiles > Player Settings > Publishing Settings)에서 진단 오버레이 표시 옵션을 활성화합니다.
    바탕화면에서 웹 캔버스의 바닥부분에 진단 아이콘이 나타납니다.

    Diagnostics button on the footer of the canvas

    모바일 디바이스에서는 화면 오른쪽 하단에 진단 아이콘이 나타납니다.

    An Android phone displaying the diagnostics button

  2. 진단 아이콘을 클릭합니다. JavaScript 메모리를 보여주는 오버레이가 나타나며, 이 메모리는 Wasm 힙 메모리 사용량을 표시하기 위해 추가로 분할됩니다.

The Diagnostics overlay shows the JavaScript memory distribution and the WASM heap memory usage

다음 진단 기능이 오버레이 화면에 나타납니다.

프로퍼티

**함수

총 JS 메모리JS 객체에 할당되지 않은 미사용 메모리를 포함하여 JavaScript(JS) 힙의 현재 크기(메가바이트)입니다.
  • 사용된 JS 메모리:JS 객체에서 사용 중인 메모리(메가바이트)입니다.
총 Wasm 힙 메모리Emscripten으로 컴파일된 C/C++ Unity 엔진의 전체 힙을 나타내는 선형 메모리(메가바이트 단위로 할당 해제된 메모리 포함).
  • 사용된 WASM 힙: 메가바이트로 할당된 WASM 힙의 공간입니다.
첫 번째 프레임으로의 페이지 로드 시간첫 번째 애플리케이션 프레임 렌더링이 완료될 때까지의 전체 시간(밀리초)입니다.
  • 페이지 로드 시간: 페이지 로드에서 첫 번째 프레임 렌더링을 시작하는 데 걸리는 시간(다운로드, 컴파일, 파싱, 메인 애플리케이션 등)을 밀리초 단위로 나타냅니다.
  • 코드 다운로드 시간: 빌드가 코드 파일을 다운로드하는 데 걸리는 시간(밀리초)입니다.
  • 에셋 파일(.data)의 로드 시간: 빌드가 .data 파일 바이너리를 다운로드하는 데 걸리는 시간(밀리초)입니다.
  • WebAssembly 시작 시간: JavaScript 프레임워크를 로드하고 Unity C++ 메인()에 도달하는 데 걸리는 시간입니다. Wasm 컴파일 시간과 비슷합니다(밀리초 단위).
  • 게임 시작 시간: Unity C++ main()을 메인의 첫 번째 프레임으로 실행하는 데 걸리는 시간으로, 일반적으로 첫 번째 게임 씬의 로딩이 밀리초 단위로 포함됩니다.
평균 FPS(10초)초당 마지막 10프레임의 평균입니다.
  • 초당 현재 프레임 수: 초당 화면에 렌더링되는 프레임 수입니다.
프레임 스탠드 수이전 프레임과 비교하여 완료하는 데 비정상적으로 오래 걸린 렌더링된 프레임 수입니다.

JS 메모리에 대한 중요한 참고 사항

JS 메모리 정보는 현재 Chrome 또는 Edge에서만 지원되는 performance.memory API를 사용하여 얻을 수 있습니다. Safari 또는 Firefox에 대해 이 정보를 반환하는 다른 API를 사용할 수 없습니다.
참고
iOS 기기에서는
performance.memory
API가 지원되지 않습니다.
이 API 지원되지 않는 브라우저에서는 N/A라는 메시지가 나타납니다.

A N/A message appears on browsers that don't support performance.memory API

추가 리소스: