XRBodyModifier3D
2026/4/15大约 2 分钟
最后同步日期：2026-04-15 | Godot 官方原文 — XRBodyModifier3D
XRBodyModifier3D
节点继承关系
继承链：Node → Node3D → SkeletonModifier3D → XRBodyModifier3D
继承自 SkeletonModifier3D
| 类型 | 名称 | 说明 |
|---|---|---|
| 属性 | Active | 是否激活 |
| 属性 | Influence | 影响权重（0 ~ 1） |
继承自 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() | 获取父节点 |
定义
XRBodyModifier3D 是 XR 身体追踪修改器。
使用频率：★ 基本用不到。
节点用途
- 将 XR 身体追踪数据应用到骨骼上
常用节点搭配
| 搭配节点 | 搭配方式 | 用途 |
|---|---|---|
| TODO | TODO | TODO |
节点属性与信号
自有属性
| 属性 | 类型 | 默认值 | 继承自 | 说明 |
|---|---|---|---|---|
| TODO | TODO | TODO | — | TODO |
信号
| 信号 | 参数 | 说明 |
|---|---|---|
| TODO | TODO | TODO |
常用方法
| 方法 | 返回值 | 说明 |
|---|---|---|
| TODO | TODO | TODO |
代码示例
基础用法
C#
// TODO: XRBodyModifier3D 基础用法示例GDScript
# TODO: XRBodyModifier3D 基础用法示例