WebGL 빌드를 배포하려면 브라우저가 올바른 리스폰스를 수신하고 이를 올바르게 처리할 수 있도록 서버를 설정하고 올바른 리스폰스 헤더를 사용하고 있는지 확인해야 합니다.
Unity에는 서버 설정 방식에 영향을 미치는 다음의 두 가지 주요 설정이 있습니다.
WebGL 플레이어 설정 창(메뉴: Edit > Project Settings > Player에서 WebGL을 선택한 후 Publishing Settings 섹션 확장)에서 압축 타입을 선택하십시오.
압축 방식 | 설명 |
---|---|
gzip | 기본 옵션입니다. Gzip 파일은 Brotli 파일보다 크지만, 빌드 속도가 더 빠르고 모든 브라우저에서 HTTP와 HTTPS를 통해 모두 기본적으로 지원됩니다. |
Brotli | Brotli 압축은 최고의 압축 비율을 자랑합니다. Brotli 압축 파일은 gzip보다 작지만 압축하는 데 시간이 더 오래 걸리므로, 릴리스 빌드에서 반복 시간이 늘어납니다. Chrome 및 Firefox는 기본적으로 HTTPS를 통한 Brotli 압축만 지원합니다. |
Disabled | 압축을 비활성화합니다. 포스트 프로세싱 스크립트에서 자체 압축을 구현하려면 이 옵션을 사용하십시오. 호스팅 서버에서 정적 압축을 사용하려는 경우에도 이 옵션을 사용해야 합니다. |
선택한 압축 방식의 브라우저 지원에 대한 자세한 내용은 WebGL 브라우저 호환성 문서를 참조하십시오.
특정 빌드 설정에 맞도록 서버 설정을 조정해야 할 수 있습니다. 특히 호스팅된 파일을 압축하기 위한 다른 서버측 설정이 이미 있는 경우 문제가 발생할 수 있으며, 이로 인해 이 설정이 작동하지 않을 수 있습니다. 브라우저가 애플리케이션을 다운로드하는 동안 기본적으로 압축 풀기를 수행하도록 하려면 Content-Encoding header를 서버 리스폰스에 추가하십시오. 이 헤더는 Unity가 빌드 시점에 사용하는 압축 타입과 일치해야 합니다. 코드 샘플은 서버 설정 코드 샘플을 참조하십시오.
압축 풀기 폴백 옵션을 사용하면 Unity가 JavaScript 압축 풀기 소프트웨어를 빌드에 자동으로 포함할 수 있습니다. 이 압축 풀기 소프트웨어는 선택한 압축 방식에 해당하며, 브라우저가 콘텐츠의 압축을 풀지 못할 경우 해당 작업을 대신 수행합니다.
Player Settings 창(메뉴: Edit > Project Settings > Player에서 WebGL을 선택한 후 Publishing Settings 섹션 확장)에서 압축 풀기 폴백을 활성화하십시오.
압축 풀기 폴백을 활성화하면 Unity는 빌드 파일에 .unityweb
확장자를 추가합니다.
서버 설정에 대한 경험이 별로 없거나 서버 설정을 사용할 수 없는 경우 Decompression Fallback을 사용하는 것을 고려해야 합니다.
참고:압축 풀기 폴백을 활성화하면 로더 크기가 커지고 빌드 파일 로드 체계의 효율성이 떨어집니다.
Decompression Fallback 옵션은 기본적으로 비활성화되어 있습니다.따라서 기본적으로 빌드 파일에는 선택한 압축 방식에 해당하는 확장자가 포함되어 있습니다.
선택할 수 있는 압축 방식은 gzip 또는 Brotli입니다. 자세한 내용은 압축 포맷 섹션을 참조하십시오.
브라우저가 다운로드하는 동안 Unity 빌드 파일의 압축 풀기를 기본적으로 활성화하려면, 적절한 HTTP 헤더를 사용하여 압축 파일을 제공하도록 웹 서버를 설정해야 합니다.이를 네이티브 브라우저 압축 풀기라고 합니다.이는 JavaScript 압축 풀기 폴백보다 빠르며, 애플리케이션의 시작 시간을 줄일 수 있습니다.
기본 브라우저 압축 풀기를 위한 설정 프로세스는 웹 서버에 따라 다릅니다. 코드 샘플은 서버 설정 코드 샘플을 참조하십시오.
Content-Encoding 헤더는 Unity가 압축 파일에 사용한 압축 타입을 브라우저에 알립니다. 이렇게 하면 브라우저가 기본적으로 파일의 압축을 풀 수 있습니다.
Content-Encoding 리스폰스 헤더를 플레이어 설정에서 선택한 압축 방식으로 설정하십시오.
압축 방식 | 파일 확장자 | 리스폰스 헤더 |
---|---|---|
gzip | .gz | Content-Encoding: gzip |
Brotli | .br | Content-Encoding: br |
WebAssembly 스트리밍을 사용하면 브라우저가 코드를 다운로드하는 동안 WebAssembly 코드를 컴파일할 수 있습니다.이렇게 하면 로드 시간이 상당히 개선됩니다.
WebAssembly 스트리밍 컴파일이 작동하려면 서버가 application/wasm
MIME 타입의 WebAssembly 파일을 반환해야 합니다.
WebAssembly 스트리밍을 사용하려면 Content-Type: application/wasm
리스폰스 헤더를 사용하여 WebAssembly 파일을 제공해야 합니다.
Content-Type 헤더는 콘텐츠의 미디어 타입을 서버에 알립니다. WebAssembly 파일의 경우 이 값은 application/wasm
으로 설정해야 합니다.
파일 확장자 | 리스폰스 헤더 |
---|---|
.wasm, .wasm.gz, .wasm.br | Content-Type: application/wasm |
참고:WebAssembly 스트리밍은 Decompression Fallback 옵션이 활성화된 경우 JavaScript 압축 풀기와 함께 작동하지 않습니다.다운로드한 WebAssembly 파일은 브라우저가 다운로드 중에 이를 스트리밍할 수 없으므로 먼저 JavaScript 압축 해제기를 거쳐야 합니다.
파일에 JavaScript가 포함된 경우 application/javascript
콘텐츠 타입 헤더를 추가해야 합니다.이는 일부 서버에 자동으로 포함되어 있을 수 있으며 일부 서버에는 포함되어 있지 않을 수 있습니다.
파일 확장자 | 리스폰스 헤더 |
---|---|
.js, .js.gz, js.br | Content-Type: application/javascript |