Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

XR 편집기 사용하기

2024년에 우리는 XR 장치에서 기본적으로 실행되도록 설계된 Godot 편집기 버전인 `Godot XR 편집기 <https://godotengine.org/article/godot-editor-horizon-store-early-access-release/>`__를 출시하여 2D, 3D 및 XR 앱과 게임을 장치에서 직접 생성, 개발 및 내보낼 수 있습니다.

앱은 Google Play Store, Meta Horizon Store 또는 `Godot 다운로드 페이지 <https://godotengine.org/download/preview/>`__에서 다운로드할 수 있습니다.

참고

XR 편집기는 초기 단계에 있습니다. 기능이 교육 목적으로 충분할 수 있지만 현재로서는 출시할 게임을 작업하는 것은 권장되지 않습니다. 아래 제한 사항를 참조하세요.

XR 장치 지원

현재 Godot XR 편집기는 Android XR 장치와 **Meta Horizon OS v69 이상**을 실행하는 다음 Meta Quest 장치에서만 사용할 수 있습니다.

메타 퀘스트 2

메타 퀘스트 3

메타 퀘스트 3s

메타 퀘스트 프로

참고

우리는 PCVR 장치를 포함하여 더 많은 XR 장치에 대한 지원을 추가하기 위해 노력하고 있습니다.

요구사항

모든 파일 액세스 권한: 편집기가 장치의 모든 파일 위치에서 프로젝트 파일을 생성하고, 가져오고, 읽을 수 있도록 합니다. 이 권한이 없으면 편집기는 계속 작동하지만 장치의 파일 및 디렉터리에 대한 액세스가 제한됩니다.
REQUEST_INSTALL_PACKAGES: 편집기에서 내보낸 프로젝트 APK를 설치할 수 있습니다.
RECORD_AUDIO: audio/driver/enable_input 프로젝트 설정이 활성화된 경우 요청됩니다.
USE_SCENE(META 전용): XR 프로젝트를 실행할 때 씬 API를 활성화하고 액세스하는 데 필요합니다.

팁과 요령

입력

최고의 경험과 높은 수준의 생산성을 위해 블루투스 키보드 및 마우스를 연결하여 XR 편집기와 상호 작용하는 것이 좋습니다. XR 편집기는 `일반적인 단축키 및 키 매핑 <https://docs.godotengine.org/en/stable/tutorials/editor/default_key_mapping.html>`__을 모두 지원합니다.
추적된 컨트롤러 또는 추적된 손과 상호작용할 때 interface/touchscreen/enable_long_press_as_right_click 편집기 설정을 전환하여 길게 눌러 오른쪽 클릭을 활성화할 수 있습니다.
추적된 컨트롤러 또는 추적된 손과 상호작용할 때 interface/touchscreen/increase_scrollbar_touch_area 편집기 설정을 사용하여 스크롤바의 크기를 늘릴 수 있습니다.

멀티 스레딩(Multi-threading)

`Theater 보기 <https://www.meta.com/blog/quest/meta-quest-v67-update-new-window-layout-creator-content-horizon-feed/>`__을 사용하여 *편집기 창*을 전체 화면으로 표시할 수 있습니다.
Quest 실험 설정*에서 사용할 수 있는 `원활한 멀티태스킹 <https://www.uploadvr.com/seamless-multitasking-experimental-quest/>`__을 활성화하면 실행 중인 XR 프로젝트와 *편집기 창 간에 빠르게 전환할 수 있습니다.
비XR 프로젝트를 개발할 때 Godot 편집기 앱 아이콘은 Quest의 앱 메뉴 기능을 사용하여 *편집기 창*과 *재생 창*이 활성화된 경우 사이를 전환하는 기능을 제공합니다.
XR 프로젝트를 개발하고 실행할 때 다음 방법으로 *편집기 창*을 다시 불러올 수 있습니다.
- 메타 버튼을 눌러 메뉴 표시줄을 불러옵니다.
- Godot 편집기 앱 아이콘을 클릭하여 앱 메뉴*를 불러오고 *편집기 창 타일을 선택합니다.

프로젝트 동기화

Git을 통한 프로젝트 동기화는 Android Git 클라이언트를 다운로드하여 수행할 수 있습니다. Git 및 SSH와 같은 일반적인 터미널 유틸리티에 대한 액세스를 제공하는 Android 터미널 에뮬레이터인 `Termux 터미널 <https://termux.dev/en/>`__을 권장합니다.
- 참고: Termux 터미널에서 Git을 사용하려면 터미널에 WRITE 권한을 부여해야 합니다. 이 작업은 터미널 내에서 다음 명령 <https://wiki.termux.com/wiki/Termux-setup-storage>`__을 실행하여 수행할 수 있습니다: ``termux-setup-storage`

플러그인

GDExtension 플러그인은 예상대로 작동하지만 플러그인 개발자가 네이티브 Android 바이너리를 제공해야 합니다.

제한 사항 및 알려진 문제

XR 편집기의 알려진 제한 사항과 문제점은 다음과 같습니다:

C#/Mono 지원이 없습니다.
외부 스크립트 편집기를 위한 지원이 없습니다.
Vulkan Forward+ 렌더러는 사용 가능하지만 심각한 성능 문제로 인해 권장되지 않습니다.