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 应用和游戏。

该应用可以从 Google Play 商店、 Meta Horizon Store 或 Godot 下载页面下载。

备注

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

XR 设备支持

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

• Meta Quest 2

• Meta Quest 3

• Meta Quest 3s

• Meta Quest Pro

备注

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

运行时权限

• 所有文件访问权限：该权限允许编辑器从设备上的任何文件位置创建、导入和读取项目文件。没有该权限，编辑器仍可运行，但对设备文件和目录的访问受限。

• REQUEST_INSTALL_PACKAGES：允许编辑器安装导出的项目 APK。

• RECORD_AUDIO：当启用了 audio/driver/enable_input 项目设置时请求该权限。

• USE_SCENE：在运行 XR 项目时，启用并访问场景 API 所需的权限。

提示与技巧

输入

• 为了获得最佳体验和高效工作效率，建议连接蓝牙键盘和鼠标来与 XR 编辑器进行交互。XR 编辑器支持所有常用快捷键和键位映射。

• 在与追踪控制器或追踪手部交互时，你可以启用 interface/touchscreen/enable_long_press_as_right_click 编辑器设置，以通过长按实现右键点击功能。

• 在与追踪控制器或追踪手部交互时，你可以通过 interface/touchscreen/increase_scrollbar_touch_area 编辑器设置来增加滚动条的触摸区域大小。

Quest 上的多任务

• Theater View可用于将编辑器窗口全屏显示。

• 启用无缝多任务处理（在 Quest 的实验性设置中可用），以便在运行的 XR 项目和编辑器窗口之间快速切换。

• 在开发非 XR 项目时，当后者处于活动状态时，通过 Quest 的 App 菜单功能，Godot 编辑器应用图标提供在编辑器窗口和 Play 窗口之间切换的能力。

• 在开发和运行 XR 项目时，你可以通过以下方式唤回编辑器窗口：

  • 按下 Meta 按钮以调用菜单栏

  • 点击 Godot 编辑器应用图标以唤出应用菜单，然后选择编辑器窗口图块。

项目同步

• 通过 Git 同步项目可以通过下载 Android Git 客户端来完成。我们推荐使用 Termux 终端https://termux.dev/cn/，这是一个 Android 终端模拟器，提供了对常见终端工具（如 Git 和 SSH）的访问。

  • 注意：要在 Termux 终端中使用 Git，你需要授予终端写入权限。这可以通过在终端中运行以下命令来实现：termux-setup-storage

插件

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

局限性与已知问题

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

• 不支持 C#/Mono。

• 不支持外部脚本编辑器。

• Vulkan Forward+ 渲染器虽然可用，但是由于存在严重的性能问题，所以不推荐使用。