使用 XR 编辑器

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

备注

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

插件

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