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...

XROrigin3D

继承： Node3D < Node < Object

AR/VR 的原点。

描述

这是 AR/VR 系统中的一个特殊节点，会将我们跟踪空间中心的物理位置映射到游戏世界中的虚拟位置。

场景树中可以添加多个原点，但一次只能使用一个。所有 XRCamera3D、XRController3D 和 XRAnchor3D 节点都应该是该节点的直接子节点，以便空间跟踪正常工作。

当你的角色需要在游戏世界中移动而不在现实世界中移动时，就要更新此节点的位置。现实世界中的运动始终是相对于这个原点的。

例如，如果你的角色正在驾驶汽车，则 XROrigin3D 节点应该是这辆车的子节点。或者，如果要实现通过传送系统来移动角色，则应该更改此节点的位置。

教程

属性

bool

current

false

float

world_scale

1.0

属性说明

bool current = false 🔗

  • void set_current(value: bool)

  • bool is_current()

如果为 true，则该原点节点目前正被 XRServer 使用。一次只能使用一个原点。

float world_scale = 1.0 🔗

  • void set_world_scale(value: float)

  • float get_world_scale()

游戏世界相对于现实世界的缩放。与 XRServer.world_scale 相同。默认情况下，大多数 AR/VR 平台假定 1 个游戏世界单位等于现实世界的 1 米。