OpenXR 插件

欢迎来到 Godot OpenXR 文档!

前言

This is the documentation for the Godot OpenXR plugin.

本插件支持 Godot 3.4 及后续版本。但是不支持即将到来的 Godot 4.0 版本。

入门

要开始一个支持 OpenXR 的全新项目,请首先打开 Godot 编辑器,新建一个项目。

使用操作系统文件管理器将插件的 addons/godot_openxr/ 子目录复制进这个新项目。请务必将插件放置在你的项目中的这个确切位置。

回到 Godot 中,新建一个 3D 场景,点击场景树面板中的实例化子场景按钮(由链条图标表示)。选择 addons/godot_openxr/scenes/first_person_controller_vr.tscn 子场景,将其加入你的场景。右键点击加入的节点,选择子节点可编辑,这样就能够访问这个子场景中的一些节点了:

../../../_images/editable_children.png

这就是最低限度的需求了。不过除此之外,我们还建议添加一个 DirectionalLight 节点和一些 MeshInstance 节点,这样你就可以有东西看。如果你把它们添加到手部节点下,就可以显示出你的控制器所跟踪的位置了。

你的场景现在应该看上去类似这样:

../../../_images/default_scene.png

现在你可以点击编辑器右上角的运行按钮,启动项目,然后就应该能够环顾四周了。

下一步

要把这个简单的场景变成正经的游戏,是没有上限的。下面还有一些针对这个插件的更多话题。不过,通过以下资源继续下去也是不错的:

  • 官方文档中的 VR 入门教程可能是围绕 OpenVR 的,但几乎所有内容都同样适用于 OpenXR。

  • Godot XR tools is a plugin that contains a set of handy sub scene to quickly implement locomotion, object interaction and UI elements in your XR experience.

要寻求其他 Godot 开发者的帮助,请查看 Godot 引擎社区页面。Godot Discord 的 #xr 频道已经是一个非常活跃的 Godot XR 社区。

插件特性