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 年，我们推出了 Godot XR 编辑器，这是专为 XR 设备原生运行而设计的 Godot 编辑器版本，使你能够直接在设备上创建、开发和导出 2D、3D 以及 XR 应用和游戏。

该应用可以从 Meta Horizon Store 和 Godot 下载页面下载。

备注

XR 编辑器仍处于提前试用阶段，我们将继续完善使用体验。请参阅下面的《局限性与已知问题》。

XR 设备支持

目前 Godot XR 编辑器仅适用于运行 Meta Horizon OS v69 或更高版本的以下 Meta Quest 设备：

Meta Quest 3

Meta Quest 3s

Meta Quest Pro

备注

我们正在努力添加对更多 XR 设备的支持，包括 PCVR 设备。

运行时权限

`所有文件访问权限 <https://developer.android.com/training/data-storage/manage-all-files#all-files-access>`__：该权限允许编辑器从设备上的任何文件位置创建、导入和读取项目文件。没有该权限，编辑器仍可运行，但对设备文件和目录的访问受限。
`REQUEST_INSTALL_PACKAGES <https://developer.android.com/reference/android/Manifest.permission#REQUEST_INSTALL_PACKAGES>`__：允许编辑器安装导出的项目 APK。
`RECORD_AUDIO <https://developer.android.com/reference/android/Manifest.permission#RECORD_AUDIO>`__：当启用了 `audio/driver/enable_input <https://docs.godotengine.org/en/stable/classes/class_projectsettings.html#class-projectsettings-property-audio-driver-enable-input>`__项目设置时请求该权限。
`USE_SCENE <https://developers.meta.com/horizon/documentation/native/native-spatial-data-perm/>`__：在运行 XR 项目时，启用并访问场景 API 所需的权限。

提示与技巧

输入

为了获得最佳体验和高效工作效率，建议连接蓝牙键盘和鼠标来与 XR 编辑器进行交互。XR 编辑器支持所有 `常用快捷键和键位映射 <https://docs.godotengine.org/en/stable/tutorials/editor/default_key_mapping.html>`__。
在与追踪控制器或追踪手部交互时，你可以启用 `interface/touchscreen/enable_long_press_as_right_click <https://docs.godotengine.org/en/stable/classes/class_editorsettings.html#class-editorsettings-property-interface-touchscreen-enable-long-press-as-right-click>`__编辑器设置，以通过长按实现右键点击功能。
在与追踪控制器或追踪手部交互时，你可以通过 `interface/touchscreen/increase_scrollbar_touch_area <https://docs.godotengine.org/en/stable/classes/class_editorsettings.html#class-editorsettings-property-interface-touchscreen-increase-scrollbar-touch-area>`__ 编辑器设置来增加滚动条的触摸区域大小。

多任务

`Theater View <https://www.meta.com/blog/quest/meta-quest-v67-update-new-window-layout-creator-content-horizon-feed/>`__可用于将 编辑器窗口 全屏显示。
启用 `无缝多任务处理 <https://www.uploadvr.com/seamless-multitasking-experimental-quest/>`__（在 Quest 的 实验性设置 中可用），以便在运行的 XR 项目和 编辑器窗口 之间快速切换。
在开发非 XR 项目时，当 Play 窗口 处于活动状态时，Godot 编辑器应用图标将提供使用 Quest 的 App 菜单 功能在 编辑器窗口 和 Play 窗口 之间切换的能力。
在开发和运行 XR 项目时，你可以通过以下方式唤回 编辑器窗口 ：
- 按下 Meta 按钮以调用菜单栏
- 点击 Godot 编辑器应用图标以唤出 应用菜单 ，然后选择 编辑器窗口 图块。

项目同步

通过 Git 同步项目可以通过下载 Android Git 客户端来完成。我们推荐使用 `Termux 终端 <https://termux.dev/cn/>`__，这是一个 Android 终端模拟器，提供了对常见终端工具（如 Git 和 SSH）的访问。
- 注意：要在 Termux 终端中使用 Git，你需要授予终端写权限。这可以通过在终端中运行以下命令来实现：termux-setup-storage

插件

GDExtension 插件按预期工作，但需要插件开发者提供原生的 Android 二进制文件。

局限性与已知问题

以下是 XR 编辑器的已知局限性和问题：

由于设备内存限制，不支持 Meta Quest 2。不过，高级用户可以从下载页面获取 XR 编辑器 APK，并自行安装到设备上（如果他们希望这样做的话）。
不支持 gradle 构建。
不支持 Android 插件，因为需要 gradle 构建支持。支持 GDExtension 插件。
不支持 C#/Mono。
不支持外部脚本编辑器。
Vulkan Forward+ 渲染器虽然可用，但是由于存在严重的性能问题，所以不推荐使用。