XRController3D
2026/4/14大约 1 分钟
最后同步日期：2026-04-15 | Godot 官方原文 — XRController3D
XRController3D
节点继承关系
继承自 Node3D
| 类型 | 名称 | 说明 |
|---|---|---|
| 属性 | Position | 本地位置（X / Y / Z） |
| 属性 | GlobalPosition | 全局位置 |
| 属性 | Rotation | 旋转角度（欧拉角，弧度） |
| 属性 | Scale | 缩放比例 |
| 属性 | TopLevel | 是否脱离父节点的变换 |
| 方法 | LookAt() | 朝向目标点 |
| 方法 | ToGlobal() | 本地坐标转全局坐标 |
| 方法 | ToLocal() | 全局坐标转本地坐标 |
| 方法 | RotateX/Y/Z() | 绕指定轴旋转 |
继承自 Node
| 类型 | 名称 | 说明 |
|---|---|---|
| 属性 | Name | 节点名称 |
| 属性 | ProcessMode | 处理模式（始终 / 暂停时 / 仅编辑器） |
| 属性 | ProcessPriority | 处理优先级，数字越小越先执行 |
| 信号 | ready | 节点进入场景树并准备就绪 |
| 信号 | tree_entered | 节点进入场景树 |
| 信号 | tree_exited | 节点完全离开场景树 |
| 方法 | GetNode<T>() | 按路径获取子节点 |
| 方法 | AddChild() | 添加子节点 |
| 方法 | RemoveChild() | 移除子节点 |
| 方法 | QueueFree() | 帧结束后释放节点 |
| 方法 | GetParent() | 获取父节点 |
定义
XR 控制器——代表 VR 手柄在 3D 空间中的位置和朝向。
打个比方：当你握住 VR 手柄时，XRController3D 就是手柄在虚拟世界中的"替身"。它能告诉你手柄在哪里、朝哪个方向，以及玩家按了哪些按钮。
使用频率：★ 基本用不到——仅在开发 VR/AR 应用时使用。
节点用途
- 跟踪 VR 手柄的位置和旋转
- 接收手柄的按钮和轴输入
- 实现手柄交互（抓取、指向等）