Unity XR-XR Interaction Toolkit开发使用方法（十四）组件介绍（XR Origin）

Unity XR Origin 是 XR Interaction Toolkit 中用于管理 XR 玩家视角与设备追踪 的核心组件，充当玩家在虚拟空间中的“锚点”。它定义了用户的头部（摄像机）、手部（控制器）的位置追踪逻辑，并协调与 XR 设备的空间映射，是构建 XR 应用的基石。

XR Origin 的作用是将对象和可追踪特征转换到它们在 Unity 场景中的最终位置、方向和缩放比例。

2、核心功能与作用

空间坐标系管理

定义玩家在虚拟世界中的 原点位置，将物理设备的运动（如头显、手柄）映射到虚拟空间。
支持 Tracking Origin Mode（追踪原点模式），适配不同设备的空间定位需求。

设备追踪整合

管理头戴显示器（HMD）、左右手控制器的追踪数据。
自动绑定 XR Controller 和 XR Interactor，实现手柄输入与交互逻辑的关联。

摄像机与视角控制

包含主摄像机（Camera），代表玩家的第一人称视角。
处理 地面高度校准、房间规模（Room-Scale） 或 坐姿（Seated） 体验的配置。

跨设备兼容性

抽象不同 XR 设备的底层差异（如 Oculus、OpenXR、Windows MR），提供统一的配置接口。

3、组件结构与层级

XR Origin 层级结构

XR Origin 组件需要特定的 GameObject 层级结构才能正常工作。推荐的 XR 场景配置如下：

GameObject	组件
XR Origin	XROrigin
Camera Offset	无
Main Camera	Camera, TrackedPoseDriver, ARCameraManager (AR), ARCameraBackground (AR)
LeftHand Controller	XRController, XRRayInteractor, LineRenderer, 交互可视化组件
RightHand Controller	XRController, XRRayInteractor, LineRenderer, 交互可视化组件

典型的 XR Origin 层级结构如下：

XR Origin (根对象)
├── Camera Offset (可选，用于高度偏移)
│    ├── Main Camera (玩家视角)
│    ├── LeftHand Controller (左手控制器)
│    └── RightHand Controller (右手控制器)
└── Other Tracked Devices (如追踪器)

Camera Offset：允许动态调整摄像机的位置偏移（如角色身高修正）。
Main Camera：必须附加 Camera 组件和 Tracked Pose Driver（用于头显追踪）。
Left/RightHand Controller：绑定 XR Controller 和交互器（如 XR Direct Interactor）。

4、关键配置参数

XR Origin 组件属性

属性	描述
Origin Base GameObject	该 GameObject 的 Transform 作为场景中可追踪元素或设备相关元素的基准坐标系。
Camera Floor Offset GameObject	用于偏移 XR Origin 摄像机位置的 GameObject。XR Origin 组件会根据所选跟踪原点模式控制该 GameObject 的 Transform 的 Y 坐标： ● Device 模式：根据 Camera Offset 的值初始化，用户重置视图时会重置。 ● Floor 模式：初始化为零。
Camera	XR Origin 的主摄像机。该摄像机所在的 GameObject 必须是 Origin Base GameObject 的子对象，且应为 Camera Floor Offset GameObject 的子级。此摄像机用于渲染 XR 场景。
Tracking Origin Mode	指定 XR Origin 与 XR 设备之间的空间关系（具体模式见下方表格）。
Camera Y Offset	当使用 Device 跟踪原点模式时，摄像机与 XR Origin 的 Y 轴偏移距离。仅在模式为 Not Specified 或 Device 时显示。

跟踪原点模式

跟踪原点模式	描述
Not Specified	使用设备的默认跟踪模式（Device 或 Floor）。
Device	此模式下需手动设置用户高度（VR）或手持设备高度（AR），通过 Camera Y Offset 调整。此模式下，XR Input Subsystem 返回的位姿不包含高度信息，需通过修改 `XROrigin.CameraYOffset` 属性手动调整。
Floor	与 Device 模式不同，此模式通过 XR 设备检测的"地面"或其他表面自动推算高度。XR Input Subsystem 返回的位姿包含用户（VR）或设备（AR）的高度信息。

5、实际应用场景

场景1：基础玩家设置

创建空对象，添加 XR Origin 组件。
在子对象中创建 Camera Offset，附加 Main Camera 和 Tracked Pose Driver。
添加左右手控制器对象，绑定 XR Controller 和 XR Direct Interactor。

场景2：地面高度校准

// 脚本动态校准地面高度
public XROrigin xrOrigin;
public float manualHeight = 1.75f;

void Start()
{
    xrOrigin.RequestTrackingOriginMode(TrackingOriginMode.Floor);
    xrOrigin.CameraYOffset = manualHeight; // 若自动校准失败，手动设置
}

场景3：传送后更新原点

// 传送后调整XR Origin位置
public TeleportationProvider teleportationProvider;
public XROrigin xrOrigin;

void Teleport(Vector3 newPosition)
{
    xrOrigin.MoveCameraToWorldLocation(newPosition);
}