Unreal Engine 프로젝트 설정

해당 XR 기기
이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.
XR 기기 유형 알아보기 →
XR 헤드셋
유선 XR 안경
XR 기기 유형 알아보기 →

이 가이드에서는 Android XR용 Unreal Engine 앱을 개발할 때 권장되는 엔진 버전, 필수 SDK, Android 프로젝트 설정을 자세히 설명합니다.

기본 요건

Android XR 개발을 위해 Unreal Engine을 설정하려면 먼저 다음 애플리케이션과 도구를 설치해야 합니다.

  1. Epic Games Launcher를 다운로드하고 설치합니다.

    1. Epic Games Launcher에서 Unreal Engine 버전 5.6.1 (이상)을 설치합니다.

  2. C++ 코드를 빌드하도록 시스템을 설정합니다 (예: Windows용 Visual Studio 2022 또는 macOS용 Xcode 사용). 자세한 내용은 Epic의 C++ 개발 환경 설정을 참고하세요.

  3. .NET 8.0 SDK를 설치합니다.

  4. Android 스튜디오 (Panda 4 | 2025.3.4 패치 1 이상)를 설치합니다.

Android 빌드 지원 설치

Android XR은 특정 SDK 버전을 사용하므로 Unreal Engine과 함께 올바른 Android 빌드 도구를 설치해야 합니다.

  1. Epic Games Launcher를 엽니다.

  2. 설치된 엔진 버전 (실행 버튼) 옆에 있는 드롭다운 화살표를 클릭하고 옵션 을 클릭합니다.

    1. 설치 옵션으로 더 스크롤하여 Android를 선택하고 적용을 클릭합니다.
    2. 메시지가 표시되면 엔진이 필요한 파일 확장자를 등록하도록 허용합니다.

  3. Java JDK 17을 설치합니다.

  4. Android 스튜디오에서 SDK Manager를 사용하여 Android XR 샘플에 필요한 다음 특정 버전을 설치합니다.

    • SDK 플랫폼: 34, 35, 36
    • NDK: 29.0.x
    • 명령줄 도구 (모든 항목)

  5. Epic의 고급 설정 및 문제 해결 가이드에 따라 다음 시스템 환경 변수를 구성합니다.

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Unreal XR 프로젝트 만들기

다음으로 새 프로젝트를 만들고 필요한 XR 플러그인과 입력으로 구성합니다.

  1. Unreal Engine 5.6.1을 실행합니다.
  2. 새 프로젝트 카테고리에서 가상 현실 템플릿을 선택합니다.
  3. 프로젝트 기본값 메뉴에서 타겟 플랫폼 을 모바일 로 설정합니다.
  4. 모바일 XR 하드웨어에서 최적의 성능을 구현하도록 품질 사전 설정 을 확장 가능 으로 설정합니다.
  5. 프로젝트 이름을 선택한 다음 만들기 를 클릭합니다.

Android 설정 구성

프로젝트가 열리면 다음 단계를 완료하여 Android XR에 필요한 Android API 수준과 그래픽 설정을 지정합니다.

  1. 수정 > 프로젝트 설정 으로 이동합니다.
  2. 플랫폼 > Android 로 이동합니다.
  3. SDK 라이선스 동의 버튼이 빨간색으로 강조표시되면 클릭합니다.
  4. APKPackaging 섹션에서 다음을 실행합니다.
    • 최소 SDK 버전 을 34로 설정합니다.
    • 타겟 SDK 버전 을 34 (이상)로 설정합니다.

  5. 빌드 섹션으로 더 스크롤하여 Vulkan 지원 을 선택합니다.

    Vulkan은 Android XR에 권장되는 고성능 그래픽 API입니다.

렌더링 설정 구성

Android XR에 필요한 높은 프레임 속도와 시각적 선명도를 구현하려면 최적화된 모바일 렌더링 경로를 사용하도록 Unreal Engine을 구성해야 합니다.

  1. 수정 > 프로젝트 설정 으로 이동하여 엔진 > 렌더링 으로 이동합니다.

  2. 전방 렌더러 섹션에서 전방 음영 을 선택합니다.

    전방 렌더러는 기본 지연 렌더러보다 모바일 VR에서 훨씬 빠릅니다. 이 기능을 사용 설정하려면 에디터를 다시 시작하고 셰이더를 컴파일해야 합니다.

  3. 기본 설정 섹션에서 앤티앨리어싱 방법 을 MSAA 로 설정합니다.

  4. 모바일 섹션에서 모바일 MSAA 를 4x 로 설정합니다.

    MSAA는 시간적 AA (TAA)로 인한 흐림 효과 없이 VR에 가장 선명한 결과를 제공합니다.

  5. VR 섹션에서 다음을 실행합니다.

    1. 모바일 HDR 을 선택 해제합니다.

      모바일에서 HDR(High Dynamic Range)을 사용 중지하면 후처리 오버헤드가 크게 줄어듭니다.

    2. 모바일 멀티 뷰 를 선택합니다.

      이렇게 하면 엔진이 단일 패스에서 두 눈을 모두 렌더링할 수 있으므로 CPU 성능이 크게 개선됩니다.

참고 항목

템플릿 프로젝트를 Android 지원 기기에 배포하는 방법에 관한 자세한 안내는 Android 개발을 위한 Unreal Engine 프로젝트 설정 을 참고하세요.