본문 바로가기

언리얼 5.9 웹 빌드

@exqt2026. 11. 11. 23:20

언리얼은 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 로 해당 버전을 환경 변수로 등록해준다.

 

언리얼 엔진에서 환경 변수 탐색 순서는 아래와 같은데

  1. WASM_EMSDK_ROOT
  2. EMSDK
  3. 둘 다 없으면 AutoSDK 를 통해 경로 획득을 시도 한다.

activate --permanent로 가 설정 해주는 건 2번쪽이라 다른 버전의 sdk를 설정하고 싶다면 그 보다 더 우선적으로 찾는 WASM_EMSDK_ROOT를 설정해줄 수 있다.

 

환경변수를 설정 후에 엔진에서 인식할 수 있도록 에픽런처, 에이터 모두 종료 후 다시 실행하면 인식하게 된다.

안되는 경우 런처가 완전히 종료되지 않는 경우일 수도 있으니 재부팅해 본다. 

 

정사적으로 설치 되었을 시 Wasm 빌드에 아이콘이 정상적으로 보여야 한다.

프로젝트 설정

Project Settings > Platforms > Wasm (Web)

 

주요 설정

설정  기본값 설명
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 키를 브라우저에 맡겨 기본 포커스 이동 동작 유지

 

exqt
@exqt :: exqt

gamedev

안녕하세요.

목차