Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

XRAnchor3D

继承： XRNode3D < Node3D < Node < Object

AR 空间中的锚点。

描述

XRAnchor3D 点是一个空间节点，它将由 AR 平台识别的真实世界位置映射到游戏世界中的某个位置。例如，只要 ARKit 中的平面检测处于开启状态，ARKit 就会识别和更新平面（桌子、地板等）的位置，并为它们创建锚点。

该节点通过其唯一 ID 映射到其中一个锚点。当收到新锚点可用的信号时，应该将该节点添加到该锚点的场景中。可以预定义节点并设置ID；节点将简单地保持在 0,0,0 上，直到识别出一个平面。

请记住，只要启用了平面检测，锚点的大小、位置和方向都会随着检测逻辑了解更多关于真实世界的信息而更新，尤其是在只有部分表面在视野内时。

教程

方法

Plane

get_plane ( ) const

Vector3

get_size ( ) const

方法说明

Plane get_plane ( ) const

返回一个与我们的锚点对齐的平面；方便进行交集测试。

Vector3 get_size ( ) const

返回检测到的平面的估计尺寸。比如当锚点与现实世界中的一张桌子有关时，这就是该桌子表面的估计尺寸。