Unreal Engine용 다이렉트 미리보기 설정

적용 가능한 XR 기기

이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.

XR 기기 유형 알아보기 →

XR 헤드셋

유선 XR 글라스

XR 기기 유형 알아보기 →

Direct Preview를 사용하면 Android XR 기기의 실시간 데이터를 사용하여 Unreal Editor 내에서 직접 복잡한 상호작용을 테스트하고 반복할 수 있습니다. Direct Preview를 사용하면 호스트 머신이 콘텐츠를 렌더링하고 디버그하며, 시각적 표시 영역을 실제 Android XR 기기로 직접 스트리밍하고, 지원되는 OpenXR 확장 프로그램을 실시간으로 호스트로 다시 스트리밍합니다.

이 가이드에 따라 Unreal Engine에서 프로젝트에 대한 Direct Preview를 설정하세요.

기본 요건

시작하기 전에 개발 환경이 다음 요구사항을 충족하는지 확인하세요.

• Unreal Engine 버전: Unreal Engine 5.6.x 또는 5.8.x
• 프로젝트 설정: Unreal Engine 프로젝트 설정 가이드의 모든 단계를 완료합니다.

• Android XR 엔진 허브: Android XR 엔진 허브 가이드의 시작하기 섹션에 있는 모든 단계를 완료하여 Direct Preview를 위한 호스트 머신을 설치하고 구성합니다.

• 하드웨어:

  • Windows 11을 실행하는 호스트 머신을 사용합니다.
  • Vulkan 동영상 인코딩을 지원하는 최신 그래픽 카드를 사용합니다.
  중요: GPU 드라이버를 최신 버전으로 업데이트한 후 모든 Vulkan 기능을 확인하세요.

Android XR 플러그인 설정

필수 Android XR 플러그인을 사용하여 Unreal Engine을 설정합니다.

1. Unreal Engine용 Android XR 확장 프로그램 빠른 시작 가이드의 단계를 따릅니다.

   나중에 새 프로젝트를 만들거나 Direct Preview에서 사용하지 않은 프로젝트를 열면 동일한 단계를 다시 따릅니다.

2. 각 프로젝트에서 프로젝트에 공급업체 플러그인 폴더에 대한 심볼릭 링크가 있는지 확인합니다.

프로젝트 설정 구성

Direct Preview 스트리밍을 위한 프로젝트 설정을 구성합니다.

1. Project Settings(프로젝트 설정) > Platforms(플랫폼) > Windows로 이동합니다.
2. RHI를 Vulkan으로 설정합니다.
3. Edit > Plugins로 이동합니다.
4. AndroidXRStreaming 플러그인을 사용 설정합니다.
5. Edit(수정) > Project Settings(프로젝트 설정) > Description(설명)으로 이동합니다.
6. Start In VR을 사용 설정합니다.

스트리밍 런타임 사용 설정

이제 프로젝트에 AndroidXRStreaming 플러그인이 사용 설정되었으므로 Android XR Streaming 런타임이 있는지 확인합니다.

1. Project Settings(프로젝트 설정) > Plugins(플러그인) > AndroidXRStreaming으로 이동합니다.

2. Enable AndroidXR Streaming을 클릭합니다.

   

   참고: 이 방법은 Unreal Engine 프로세스에 세션 기반 환경 변수를 설정하여 작동하므로 머신에 여러 런타임이 있는 경우에도 레지스트리 항목을 변경할 필요가 없습니다.

3. Unreal Engine을 다시 시작하여 변경사항을 적용합니다.

스트리밍 클라이언트 구성

프로젝트에 다양한 옵션을 사용하여 스트리밍 클라이언트를 구성합니다.

1. Project Settings(프로젝트 설정) > Plugins(플러그인)로 이동합니다.

2. AndroidXRStreamingClient 섹션에서 다음 각 옵션을 검토하고 프로젝트에 필요한 항목과 일치하도록 사용 설정 또는 사용 중지합니다.

   • Auto Start Client On Preview: 사용 설정하면 편집기에서 Start VR Preview를 클릭할 때 선택한 유효한 기기에서 미리보기 클라이언트 앱을 실행합니다.
   • Auto Stop Client On Preview: 사용 설정하면 에디터의 VR 미리보기가 중지될 때 미리보기 클라이언트를 종료합니다.
   • 호환 기기 자동 선택: 사용 설정하면 기기를 검색할 때 머신에 연결된 첫 번째 호환 기기를 자동으로 선택합니다.
   • 오류 대화상자 표시: 사용 설정하면 추가 오류 대화상자가 표시됩니다(예: 클라이언트 기기를 선택하지 않고 VR 미리보기를 시작하려고 하면 오류 대화상자가 표시됨). 이러한 대화상자를 숨기려면 이 옵션을 사용 중지합니다.
   • 새로고침: 사용 설정하면 새로고침 버튼이 연결된 기기를 검색하고 호환되는 기기를 나열합니다(Android XR 엔진 허브에 Direct Preview 클라이언트 앱이 있는지 여부로 결정됨).

직접 미리보기 시작

직접 미리보기를 시작하여 Unreal Engine에서 직접 스트리밍합니다.

1. 고품질 USB-C 케이블을 사용하여 Android XR 기기를 호스트 머신에 연결합니다.

   참고: 호스트 머신이 ADB (Android 디버그 브리지) 명령어를 전송할 수 있도록 Android XR 기기에서 개발자 옵션과 디버깅을 사용 설정해야 합니다.

2. 이 기기를 Direct Preview와 함께 사용한 적이 없는 경우 게임 엔진을 통해 Direct Preview를 시작하기 전에 Android XR 엔진 허브에서 Direct Preview를 위해 기기를 연결하고 구성합니다.

3. Unreal Editor에서 Play level in VR(VR에서 레벨 재생)을 클릭합니다. Direct Preview를 시작할 때 일반적인 Play in Editor 옵션을 사용하지 마세요.