언리얼은 4 최종 버전까지 웹 빌드를 지원하였으나 성능+호환성 이슈로 5부터 중단되었다가
언리얼 5.9 프리뷰 부터 공식적으로 유니티처럼 웹 빌드를 지원한다.
Core Engine and Programming
UE 5.9 introduces a new experimental WebAssembly target with its own project settings and WebGPU rendering support.
https://dev.epicgames.com/documentation/unreal-engine/unreal-engine-5-9-release-notes
개념

WebAssembly(WASM)
- 웹 브라우저에서 동작하는 네이티브 수준의 고성능을 내기 위해 설계된 저수준 바이트코드 형식의 언어
- 느린 자바스크립트를 대체하는 것은 아니고 상호 운용적인 개념
- 게임이나 AI 같이 고성능 연산이 필요한 부분에 부분적으로 실행
Emscripten
- C++, Rust 등 코드를 WASM으로 변환해 주는 Clang/LLVM 기반의 toolchain
- Clang: C++ 소스 코드를 분석해 LLVM의 중간 표현(IR)으로 변환하는 컴파일러 프론트엔드
- LLVM: IR을 최적화하고, WebAssembly 같은 대상의 명령어를 생성하는 컴파일러 인프라 (보통 Clang이랑 한 묶음)
- 툴체인(toolchain): 특정 플랫폼에서 실행할 프로그램을 만들기 위해 함께 쓰는 도구들의 조합
emsdk (Emscripten SDK)
- Emscripten 관련 도구 모음 + 버전을 관리하는 패키지 매니저
설치 및 빌드
Android나 iOS 처럼 에픽 런처에서 플랫폼 SDK를 직접 추가하는 방식이 아닌
직접 emsdk를 설치하고 환경 변수를 설정해야 한다.
git clone https://github.com/emscripten-core/emsdk C:\emsdk
관리자 권한, 경로 길이 제한 등 이슈로 가급적이면 C:/ 드라이브 상위에 emsdk를 clone한다.
emsdk install 6.0.10
설치 된 폴더로 들어가서 5.9 프리뷰 버전에선 정확히 6.0.10 버전을 설치한다.
이후 환경 변수를 설정해야하는데
C:\emsdk>emsdk activate 6.0.10 --permanent
Resolving SDK version '6.0.10' to 'sdk-releases-666337b525e673e769121856d175f6f52b8ead64-64bit'
Registering active Emscripten environment permanently
activate <버전> --permanent 로 해당 버전을 환경 변수로 등록해준다.
언리얼 엔진에서 환경 변수 탐색 순서는 아래와 같은데
- WASM_EMSDK_ROOT
- EMSDK
- 둘 다 없으면 AutoSDK 를 통해 경로 획득을 시도 한다.
activate --permanent로 가 설정 해주는 건 2번쪽이라 다른 버전의 sdk를 설정하고 싶다면 그 보다 더 우선적으로 찾는 WASM_EMSDK_ROOT를 설정해줄 수 있다.
환경변수를 설정 후에 엔진에서 인식할 수 있도록 에픽런처, 에이터 모두 종료 후 다시 실행하면 인식하게 된다.
안되는 경우 런처가 완전히 종료되지 않는 경우일 수도 있으니 재부팅해 본다.

프로젝트 설정

주요 설정
| 설정 | 기본값 | 설명 |
| PageTitle | 프로젝트 이름 | 브라우저 탭 제목과 로딩 화면에 표시되는 제목을 지정 |
| StartMode | Auto | Auto는 게임이 준비되면 로딩 화면을 자동으로 닫음 Click은 사용자가 클릭할 때까지 기다렸다가 로딩 화면을 닫음 |
| MobileDevices | Warn | 스마트폰과 태블릿의 접속했을 때 Warn은 경고를 표시 Block은 게임 실행을 막고 안내 메시지를 표시 Allow는 실행을 허용 |
| MinLogicalCpus MinDeviceMemoryGB |
4, 8 | 각각 논리 CPU 수와 기기 메모리(GB)의 기준값 기기 사양이 기준에 미달하면 플레이어에게 경고를 표시 |
| bTargetMobileDeferredTier | True | Mobile Forward와 함께 Mobile Deferred 렌더러도 쿠킹 |
| bTargetDesktopTier | False | True로 설정하면 실험용 데스크톱 렌더러(WebGPU SM5)도 쿠킹 |
실행

지정한 폴더에 python으로 serve.py를 실행하거나 Play-<ProjectName>.bat을 실행하면 파일 서빙하는 서버가 열린다.
이후 URL에 매개변수를 지정하여 엔진쪽으로 전달 가능하다.
기본 매개변수
| 매개변수 | 설명 |
| ?args=<UE command line> | 엔진 실행 인수를 URL 인코딩해 전달(공백은 %20). |
| ?tier=forward / ?tier=deferred | 지정한 렌더러 티어로 실행 요청 ?tier=mobile은 forward와 동일. ?tier=desktop은 실험용 데스크톱 티어 요청 |
| ?sw=0 | 서비스 워커 비활성화 및 캐싱 중지. 이미 등록된 서비스 워커도 제거 |
| ?debug=1 | 프레임 속도, 로딩 단계, 메모리, 최근 엔진 로그, 캐시 상태를 오버레이에 표시. Ctrl+Alt+D로 표시 전환 |
| ?compat=1 | 게임 실행 대신 호환성 보고서 표시 |
| ?gpucheck=1 | GPU 검사 실행 후 결과에 따라 초기 렌더링 해상도 선택 |
| ?sp=NN | 초기 렌더링 해상도 비율을 NN%로 지정(50~200%) |
| ?tab=browser | Tab 키를 브라우저에 맡겨 기본 포커스 이동 동작 유지 |