이 가이드에서는 Android XR용 Godot 엔진 앱을 개발할 때 권장되는 엔진 버전, 필수 SDK, Android 프로젝트 설정을 자세히 설명합니다.
기본 요건
Android XR 개발을 위해 Godot Engine 프로젝트를 구성하려면 다음 기본 요건을 충족해야 합니다.
- 공식 Godot 웹사이트에서 Godot 4.6.2를 다운로드합니다.
- XR 헤드셋 또는 XR 글라스가 있어야 합니다.
- Android 스튜디오를 설치합니다.
Android 빌드 지원 설치
Godot에는 공간 컴퓨팅용 패키지를 컴파일하고 내보내는 데 특정 Android 빌드 도구가 필요합니다.
Android 스튜디오에서 SDK Manager를 사용하여 다음 패키지와 도구를 설치합니다.
- Android SDK 플랫폼: Android 14.0 ('UpsideDownCake') (API 수준 34)
- Android SDK 빌드 도구: 버전 34.0.0 이상
- NDK: 28.x 버전
- CMake: 버전 3.10.2
SDK Manager에서 Show Package Details를 선택해야 도구의 사용 가능한 모든 버전을 볼 수 있습니다.
Godot에서 Editor > Editor Settings > Export > Android로 이동하여 SDK 경로를 제공합니다.
Godot XR 프로젝트 만들기
공간 렌더링을 위한 새 프로젝트를 설정합니다.
- Godot을 열고 새 프로젝트를 만듭니다.
렌더러로 모바일을 선택합니다.
Android XR에 권장되는 고성능 Vulkan 우선 그래픽 API입니다.
원하는 다른 옵션을 선택하고 만들기를 클릭합니다.
공식 Godot XR 장면 설정 가이드를 사용하여 내부 XR 장면 (
XROrigin3D및XRCamera3D포함)을 구성합니다.
프로젝트 설정 구성
다음으로 프로젝트 설정을 구성하여 OpenXR을 사용 설정하고 모바일 성능을 위한 렌더링 파이프라인을 구성합니다.
- Godot을 엽니다.
- OpenXR에 다음 프로젝트 설정을 구성합니다.
- Project(프로젝트) > Project Settings(프로젝트 설정) > XR > OpenXR로 이동하여 Enabled(사용 설정됨)를 선택합니다.
- Project(프로젝트) > Project Settings(프로젝트 설정) > XR > Shaders(셰이더)로 이동하여 Enabled(사용 설정됨)를 선택합니다.
렌더링 > 앤티앨리어싱 > 품질 > MSAA 3D로 이동하여 4x를 선택합니다.
이 설정은 Android XR에서 최상의 선명도를 제공합니다.
Android XR로 내보내도록 프로젝트 설정
다음 단계에 따라 Android XR로 내보낼 프로젝트를 설정하세요.
내보내기 사전 설정: 프로젝트 > 내보내기로 이동하여 추가...를 클릭합니다. > Android.
배포 가이드 완료: 공식 Godot Android 배포 가이드에 따라 권한 및 클릭 한 번으로 배포에 관한 단계별 안내를 따릅니다.
프로젝트의 SDK 버전 확인:
- 최소 SDK: 34
- 타겟 SDK: 34
XR 모드 구성: 내보내기 설정에서 XR 모드를 OpenXR로 설정합니다.
Godot OpenXR 공급업체 플러그인 설치
앱은 공급업체 플러그인을 사용하여 Android XR 관련 확장 프로그램에 액세스해야 합니다. 호환되는 버전을 설치하려면 다음 단계를 따르세요.
- Godot에서 AssetLib를 선택합니다.
'공급업체'를 검색합니다.
Godot OpenXR 공급업체 플러그인 버전 5.1 이상을 찾아 다운로드합니다.
다운로드가 완료되면 설치를 선택합니다.
참고 항목
Godot을 사용한 Android XR 개발에 관한 자세한 내용은 Godot 엔진 문서의 다음 페이지를 참고하세요.