Version: 2022.3
언어: 한국어
WebGL 애플리케이션 빌드 및 배포
에셋 번들의 로드 시간 감소

WebGL 애플리케이션 빌드

WebGL용 빌드를 생성하려면 Unity의 메인 메뉴에서 File > Build Settings로 이동합니다. 플랫폼 리스트에서 WebGL을 선택한 후 Switch Platform을 클릭합니다.

빌드 설정을 완료하고 나면 다음 두 옵션 중에서 하나를 선택합니다.

  • Build:애플리케이션을 플레이어에 빌드합니다.
  • Build and Run:애플리케이션을 플레이어에서 빌드하고 타겟 플랫폼에서 해당 플레이어를 엽니다.
빌드 설정 창
빌드 설정 창

WebGL용 Unity 빌드 시스템은 다음 설정을 지원합니다.

설정 기능
Texture Compression 빌드에 사용할 텍스처 압축 포맷입니다.자세한 내용은 WebGL 텍스처 압축을 참조하십시오.가능한 옵션은 다음과 같습니다.
Use Player Settings 기본값으로 선택되는 옵션입니다.Player settings 창에서 설정한 텍스처 압축 포맷을 사용합니다.
ETC2 모바일 디바이스에서 널리 지원되는 ETC2 포맷을 사용합니다.
ASTC 모바일 디바이스에서 널리 지원되는 ASTC 포맷을 사용합니다.
DXT 데스크톱 기기에서 널리 지원되는 DXT 포맷을 사용합니다.
Development Build 빌드에 스크립팅 디버그 심볼과 프로파일러를 포함하려면 이 설정을 활성화합니다.이 옵션을 활성화하면 Unity는 DEVELOPMENT_BUILD 스크립팅 정의를 설정합니다.개발 빌드는 콘텐츠를 축소하지 않고 배포하기에 용량이 크므로 애플리케이션을 테스트하려는 경우에만 이 설정을 사용하십시오.
Code Optimization WebGL 코드를 컴파일하는 데 사용할 최적화 모드를 선택합니다.
Speed 이 옵션은 설정 기본값입니다.런타임 성능에 최적화된 WebGL 코드를 생성하려면 이 옵션을 선택합니다.
Size 빌드 크기에 최적화된 WebGL 코드를 생성하려면 이 옵션을 선택합니다.이 옵션은 WebGL 게임을 다운로드 가능한 최소 크기로 줄이거나, 모바일 브라우저(Android 또는 iOS)가 기본 속도 최적화 WebAssembly 빌드를 모바일 디바이스가 사용하기에 너무 크다는 이유로 로드를 거부하는 경우 유용합니다.
Autoconnect Profiler 일반적으로 이 설정을 활성화하면 Unity 프로파일러를 빌드에 자동으로 연결할 수 있습니다.그러나 WebGL의 경우 실행 중인 빌드에 프로파일러를 연결할 수 없으므로 이 옵션을 사용하여 콘텐츠를 에디터에 대신 연결합니다.이는 프로파일러 연결이 WebGL의 웹소켓을 사용하여 처리되지만 웹 브라우저는 콘텐츠의 발신 연결만 허용하기 때문입니다.이 설정을 사용하려면 Development Build 옵션을 활성화해야 합니다.
Deep Profiling 프로파일러에서 Deep Profiling을 활성화하려면 이 설정을 활성화합니다.이 옵션을 사용하면 프로파일러 기기가 애플리케이션에서 함수를 호출할 때마다 더 자세한 프로파일링 데이터를 반환합니다.Deep Profiling Support를 활성화하면 스크립트 실행이 느려질 수 있습니다.이 옵션은 Development Build 옵션을 활성화한 경우에만 사용할 수 있습니다.
Build 애플리케이션을 빌드하려면 이 옵션을 사용합니다.
Build And Run WebGL 플레이어를 로컬로 보려면 이 옵션을 사용합니다.Unity는 로컬 웹 서버를 사용하여 빌드를 호스팅하고 로컬 호스트 URL에서 빌드를 엽니다.또는 리스폰스 헤더가 올바르게 설정된 커스텀 로컬 웹 서버를 사용할 수도 있습니다.자세한 내용은 압축 빌드 및 서버 설정을 참조하십시오.

Asset Import Overrides 설정을 변경하려면 빌드 설정을 참조하십시오.

빌드 폴더

Build 폴더에는 다음 파일이 있으며, 여기서 [ExampleBuild]는 타겟 빌드 폴더의 이름을 나타냅니다.

파일 이름 내용물
[ExampleBuild].loader.js 웹 페이지에서 Unity 콘텐츠를 로드하는 데 필요한 JavaScript 코드입니다.
[ExampleBuild].framework.js JavaScript 런타임 및 플러그인.
[ExampleBuild].wasm WebAssembly 바이너리.
[ExampleBuild].mem 플레이어용 힙 메모리를 초기화하기 위한 바이너리 이미지입니다.Unity는 멀티 스레드 WebAssembly 빌드에만 이 파일을 생성합니다.
[ExampleBuild].data 에셋 데이터 및 씬.
[ExampleBuild].symbols.json 오류 스택 추적을 디맹글하는 데 필요한 디버그 심볼 이름. 이 파일은 Debug Symbols 옵션(File > Build Settings > Player Settings)을 활성화한 경우에만 릴리스 빌드에 대해 생성됩니다.
[ExampleBuild].jpg 빌드가 로드되는 동안 표시되는 배경 이미지입니다.이 파일은 Player Settings(File > Build Settings > Player Settings > Splash Image)에서 Background Image를 사용할 수 있는 경우에만 생성됩니다.자세한 내용은 스플래시 화면을 참조하십시오.

빌드에 대해 Compression Method를 활성화하면 Unity는 압축 방식에 해당하는 확장자를 식별하고 이 확장자를 Build 하위 폴더 내 파일 이름에 추가합니다.Decompression Fallback을 활성화하면 Unity는 .unityweb 확장자를 빌드 파일 이름에 추가합니다.그렇지 않으면 Unity는 Gzip 압축 방식에 .gz 확장자를 추가하거나 Brotli 압축 방식에 .br 확장자를 추가합니다. 자세한 내용은 압축 빌드 및 서버 설정을 참조하십시오.

Player Settings에서 Name Files As Hashes를 활성화하면 Unity는 기본 파일 이름 대신 파일 콘텐츠의 해시를 사용합니다.이는 빌드 폴더에 있는 각 파일에 적용됩니다.이 옵션을 사용하면 업데이트된 버전의 게임 빌드를 서버의 동일한 폴더에 업로드하며, 빌드 반복 간에 변경된 파일만 업로드할 수 있습니다.

참고: 일부 브라우저에서는 파일 시스템에서 플레이어를 직접 열 수 없습니다. 이는 로컬 파일 URL에 적용된 보안 제한 사항 때문입니다.

예외 활성화

런타임 시 예상치 못한 코드 동작(오류라고도 함)을 처리하는 방법을 지정하려면 예외 활성화를 사용합니다.예외 활성화에 액세스하려면 WebGL Player Settings의 Publishing Settings 섹션으로 이동합니다.

여기에는 다음 옵션이 있습니다.

  • None:예외 지원이 필요하지 않은 경우 이 옵션을 선택합니다.이 옵션을 선택하면 성능이 극대화되고 빌드가 최소화됩니다.이 옵션을 사용하면 폐기된 예외로 인해 해당 설정에 오류가 있는 경우 콘텐츠가 중지됩니다.
  • Explicitly Thrown Exceptions Only (default):스크립트의 throw 문에서 명시적으로 지정된 예외를 캡처하고 finally 블록이 호출되도록 하려면 이 옵션을 선택합니다.이 옵션을 선택하면 스크립트에서 생성된 JavaScript 코드가 더 길어지고 더 느려지지만, 스크립트가 프로젝트의 중요한 병목 지점인 경우에만 문제가 될 수 있습니다.
  • Full Without Stacktrace:스크립트의 throw 문에서 명시적으로 지정된 예외(Explicitly Thrown Exceptions Only 옵션과 동일)를 캡처하려면 이 옵션을 선택합니다.
    • Null 레퍼런스
    • 범위 이탈 배열 액세스
  • Full With Stacktrace:이 옵션은 위의 옵션과 유사하지만 스택 추적도 캡처합니다.Unity는 이런 예외에 대한 확인을 코드에 포함시켜서 예외를 생성하므로, 이 옵션을 선택하면 성능이 저하되고 브라우저 메모리 사용이 증가합니다.디버깅에만 이 옵션을 사용하고 항상 64비트 브라우저에서 테스트하십시오.
WebGL 애플리케이션 빌드 및 배포
에셋 번들의 로드 시간 감소
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961