1. 项目概述：为什么这个免费的XR示例项目值得你花时间？

如果你正在用Unity开发VR或AR应用，并且对官方那个庞大又有点让人摸不着头脑的XR Interaction Toolkit感到头疼，那你来对地方了。我最近花了整整一周时间，把官方的XR Interaction Toolkit示例项目从头到尾啃了一遍，不是走马观花，而是带着“这东西到底怎么用在实际项目里”的问题去实操、去踩坑、去优化。最终，我把这个过程整理成了一个可以直接“抄作业”的免费教程。

这个教程的核心价值在于，它不是一个简单的功能罗列。市面上很多教程只告诉你“点这里，拖那里”，但当你真正想做一个自定义的交互，比如让玩家用手柄捏住一个物体然后旋转缩放时，立马就卡壳了。官方的示例项目（Starter Assets和Example Assets）其实是一个宝藏，里面包含了从基础移动、基础交互到高级UI、远程抓取等几乎所有核心交互模式的实现。但问题在于，它缺乏一个“导游”，告诉你每个场景是干嘛的，关键脚本在哪里，以及如何把这些“积木”拼成你自己的应用。

我的目标就是当这个“导游”。通过这个教程，你将不仅知道如何导入和运行示例，更能理解其背后的设计哲学、组件的工作流，以及如何避免那些我亲自踩过的坑。无论你是刚接触XR的开发者，还是已经用过旧版VRTK或Unity XR Legacy Input Helpers，想平滑迁移到新体系，这篇内容都能给你提供一条清晰的路径。

2. 环境准备与项目导入：避开版本兼容的“天坑”

在开始任何炫酷的交互之前，一个稳定、兼容的开发环境是基石。这一步如果没做好，后面所有的“神奇效果”都可能变成“灵异现象”。

2.1 Unity版本与XR插件的精准匹配

这是最重要的一步，也是新手最容易翻车的地方。XR Interaction Toolkit (XRI) 的版本与Unity Editor版本、目标平台（如Oculus、OpenXR）的兼容性要求非常严格。

我的推荐配置（经过亲测稳定）：

• Unity版本：2021.3 LTS 或 2022.3 LTS。长期支持版（LTS）是工业标准，bug少，第三方插件兼容性好。强烈不建议使用最新的Tech Stream版本，你可能成为官方的小白鼠。
• XR Interaction Toolkit版本：通过Package Manager安装，选择2.5.x版本。这是当前最成熟、文档最全的版本。避免使用3.0.0-preview等预览版，除非你想体验前沿特性并忍受潜在的不稳定。
• XR Plugin Management：这是Unity管理不同XR平台（如Oculus、OpenXR、Windows MR）的枢纽。在Package Manager中搜索并安装它。
• 目标平台插件：根据你的设备安装。例如，开发Meta Quest应用，就安装“Oculus XR Plugin”；开发PC VR（如HTC Vive、Valve Index）并希望有最好的跨平台兼容性，则选择“OpenXR Plugin”。

注意：安装Oculus或OpenXR插件后，务必前往Edit > Project Settings > XR Plug-in Management，在对应的平台标签页下（如Android、PC），勾选你安装的插件提供商。忘记启用是导致“头盔里一片黑”的最常见原因。

实操步骤：

1. 打开Unity Hub，使用推荐的LTS版本创建一个新的3D项目（项目模板选Core即可）。
2. 进入项目后，打开Window > Package Manager。
3. 点击左上角“+”号，选择“Add package by name...”。
4. 输入com.unity.xr.interaction.toolkit并安装。Package Manager会自动解析并安装其依赖项，如Input System。
5. 同样方式，安装com.unity.xr.management(XR Plugin Management)。
6. 根据你的设备，搜索并安装对应的XR插件（如com.unity.xr.oculus）。
7. 前往Project Settings启用插件，如上所述。

2.2 示例项目的两种导入方式与优劣分析

官方示例主要分为两部分：Starter Assets（启动资源，包含基础预设）和Example Assets（示例资源，包含大量演示场景）。导入它们有两种主流方式。

方式一：通过Package Manager直接导入（推荐给大多数开发者）

1. 在Package Manager中找到已安装的“XR Interaction Toolkit”。
2. 点击它，在右侧详情窗口中，你会看到“Samples”选项卡。
3. 在这里，你可以看到“Starter Assets”和“Example Assets”。分别点击它们旁边的“Import”按钮。
4. 导入后，在项目的Assets/Samples/XR Interaction Toolkit/[版本号]/路径下，就能找到所有示例资源。

优点：官方维护，版本与XRI包严格绑定，最不容易出错。资源结构清晰。缺点：示例代码是只读的，如果你想修改并保存学习，需要先复制到项目其他目录。

方式二：从GitHub仓库克隆或下载（适合深度研究或特定版本）你可以访问Unity的GitHub仓库，找到XR Interaction Toolkit项目，里面有一个Assets文件夹包含了所有示例。你可以下载整个Assets文件夹，或只复制你需要的场景和脚本。

优点：可以获取到最新的开发中特性，甚至查看提交历史和Issue讨论。缺点：可能需要手动解决依赖和版本冲突，适合更有经验的开发者。

我的心得：对于学习和绝大多数项目，强烈建议使用方式一。它能保证你运行的环境和我教程中描述的环境完全一致。导入后，我建议你立即在Project窗口的根目录创建一个名为“_MyXRWork”或“Learning”的文件夹，把你想修改和实验的示例资源复制一份到这里来操作，保持原始示例的纯净，方便随时对照。

2.3 初始场景搭建：5分钟创建一个可运行的VR场景

很多教程会直接让你打开复杂的示例场景，但我觉得从零开始构建一个最小可运行场景，是理解XRI架构最好的方式。

1. 清空场景：新建一个场景，删除默认的Main Camera和Directional Light。
2. 添加XR Origin：这是XRI的核心，代表玩家在XR空间中的存在。在Hierarchy窗口右键XR > XR Origin (Action-based)。它会自动添加一个包含Camera Offset（处理身高）和Camera（左/右眼）的层级结构。
3. 添加交互管理器：在Hierarchy窗口右键XR > Interaction Manager。这个组件是所有交互事件（如抓取、悬停）的调度中心，一个场景一个就够了。
4. 添加输入动作管理器：同样右键XR > Input Action Manager。它负责将你在Project Settings中定义的Input Actions（如“Grip”、“Trigger”）绑定到具体的控制器输入上。
5. 配置简单的控制器：
   • 在XR Origin下找到LeftHand Controller和RightHand Controller子物体。
   • 检查它们身上的XR Controller组件，确保“Controller Node”设置为“Left Hand”和“Right Hand”。
   • 给它们添加XR Ray Interactor组件。这样运行后，你就能看到从手柄射出的射线了。
6. 创建一个可交互的物体：
   • 在场景中创建一个Cube。
   • 给它添加XR Grab Interactable组件。这个组件让物体变得“可抓取”。
   • 运行场景。现在你应该可以通过手柄射线指向Cube，按下抓取键（默认通常是Trigger或Grip）来抓取和移动它了！

这个简单的场景包含了XRI最核心的几大件：Origin（你）、Manager（大脑）、Interactor（你的手）、Interactable（物体）。理解了这个基础框架，再去看复杂的示例，就会觉得它们只是在上面添加了更多的“装饰”和“技能”。

3. 核心交互模式深度解析：从“能用”到“好用”

示例项目里塞满了各种交互场景，但如果不加梳理，很容易看花眼。我把它们归纳为几个核心模式，并拆解其中的关键实现。

3.1 直接与远程交互：手与“魔法射线”的抉择

这是最基础的两种交互方式，决定了玩家的操作手感。

直接交互（Direct Interactor）：

• 是什么：模拟真实的手部碰撞交互。当虚拟手（一个碰撞体）与物体发生物理接触时，才能触发抓取、按压等操作。
• 如何实现：在Controller物体上，使用XR Direct Interactor组件，并为其配置一个Sphere Collider或Capsule Collider来定义手的交互范围。
• 优点：沉浸感强，符合直觉。适合抓取近处的、形状不规则的物体。
• 缺点：对物理碰撞和手部追踪精度要求高，远处物体无法交互。
• 示例场景参考：ExampleAssets/Scenes/DirectInteractor。注意观察场景中控制器上的碰撞体（以绿色线框显示）。

远程交互（Ray Interactor）：

• 是什么：从手柄发射一条射线，指哪打哪。通过射线命中目标来触发交互，是VR UI和远距离操作的标配。
• 如何实现：使用XR Ray Interactor组件。你可以调整射线的视觉表现（直线、曲线抛物线）、最大距离、命中反馈等。
• 优点：交互距离远，精度高，非常适合菜单操作、远距离抓取轻量物体。
• 缺点：缺乏物理接触的真实感。
• 示例场景参考：ExampleAssets/Scenes/DeviceBasedRayInteractor或ActionBasedRayInteractor。

我的心得与混合方案：在实际项目中，我几乎从不单独使用一种。最佳实践是同时挂载XR Direct Interactor和XR Ray Interactor在同一个控制器上，并设置它们的Interaction Layer Mask。XRI的交互管理器会自动处理优先级：当手部碰撞体接触到物体时，优先使用直接交互；当没有接触时，则启用射线进行远程交互。这种“智能切换”能提供最流畅的体验。在Starter Assets的预制件中，官方已经采用了这种混合模式，你可以直接研究Assets/Samples/.../StarterAssets/Prefabs/下的控制器预制体。

3.2 抓取（Grab）的进阶技巧：让物体“听话”

基础的抓取很简单，但如何让抓取感觉更自然、功能更强大？

抓取附着点（Attach Transform）：

• 每个XR Grab Interactable物体都有一个“Attach Transform”属性。它决定了物体被抓取时，会对齐到控制器的哪个位置。
• 默认情况：如果不指定，XRI会在物体中心创建一个临时的附着点，抓取时物体中心会对齐到控制器。
• 优化做法：为你的物体（尤其像刀、枪、杯子这种有明确握把的模型）创建一个子空物体，命名为“AttachPoint”，并把它放在你觉得自然的手握位置（如刀柄处）。然后将这个空物体拖拽到Attach Transform属性上。这样抓取时，握把处就会精准地对齐到玩家手心，沉浸感大增。

抓取模式（Grab Type）：

• Velocity Tracked：（默认）物体在抓取瞬间会获得一个速度，模拟“抓取”的动量，感觉更物理，但可能有点“滑”。
• Kinematic：物体被抓取后，直接设置为运动学（Kinematic）状态，完全跟随控制器运动，没有任何物理延迟，非常稳定。适合UI控件、精密操作。
• Instantaneous：类似Kinematic，但处理方式略有不同。根据我的测试，对于绝大多数需要稳定抓取的物体，Kinematic模式是体验最好的选择。

双手交互与可操纵物体（Manipulable）：示例项目中有一个强大的功能叫“Manipulable”。它允许物体被单手握持、双手握持并进行缩放、旋转。

1. 给物体添加XR Grab Interactable组件。
2. 再添加XR Scale/Translate/Rotate Manipulator等组件（在Example Assets的Prefabs里有现成的组合）。
3. 运行后，用一只手抓取物体，另一只手去触碰物体的边缘或特定控制点，就能进行双人配合式的变形操作。
4. 关键点：这些Manipulator组件内部使用了IXRManipulator接口，并通过XRBaseInteractable的事件（如OnSelectEntered、OnSelectExited）来协调多只手之间的操作逻辑。研究TwoHandedManipulatable这样的预制体，是学习复杂交互状态管理的绝佳案例。

3.3 UI交互：在3D空间中构建可操作的界面

XR中的UI与传统2D Canvas UI截然不同，它需要响应3D射线或直接触碰。

Canvas的世界空间渲染：

1. 创建一个Canvas，将其Render Mode设置为“World Space”。
2. 调整Rect Transform的宽度、高度和位置，把它放在虚拟世界中你希望的位置（如玩家面前1.5米处）。
3. 在Canvas上添加普通的UI组件，如Button、Slider。

让UI可交互：这是关键步骤。普通的UI Button不会响应XR射线。

1. 你需要为Canvas添加一个XR UI Input Module组件（或确保EventSystem对象上挂载了它）。
2. 更重要的是，为Canvas添加一个Tracked Device Graphic Raycaster组件。这个组件负责将XR控制器的射线与UI元素进行命中检测。
3. 确保你的XR控制器（带有XR Ray Interactor）的“Raycast Mask”包含了UI所在的Layer。

优化UI交互体验：

• 触觉反馈：在XR Ray Interactor组件中，可以配置“Haptic Intensity”（震动强度）和“Haptic Duration”（震动时长），当射线悬停在UI按钮上或按下时触发，提供物理反馈。
• 视觉反馈：利用XR Interactor Line Visual组件自定义射线的颜色和样式。通常设置为，默认是白色，悬停在可交互物体上时变为绿色，选中时变为蓝色。这种状态反馈对用户至关重要。
• 直接触摸UI：对于带手部追踪的设备（如Quest），你可以使用XR Direct Interactor（配置为手部模型）直接去“按”世界空间中的UI按钮，这需要更精细的碰撞体设置和UI事件响应。

示例学习路径：重点研究ExampleAssets/Scenes/UI下的场景。观察Canvas的组件配置，以及控制器射线与UI的交互事件是如何串联起来的。

4. 输入系统配置详解：告别混乱的按键映射

输入管理是XRI新手最大的拦路虎之一。新版Unity强烈推荐使用Input System包，它功能强大但学习曲线陡峭。

4.1 Action-Based与Device-Based输入模式

XRI支持两种输入配置模式，你必须理解它们的区别。

Device-Based（基于设备）：

• 原理：直接在XR Controller组件上绑定具体的物理输入，如“Trigger”、“Grip”。你需要手动选择“Select Action”为“Axis1D (Trigger)”等。
• 优点：配置简单直观，适合快速原型开发。
• 缺点：与硬件绑定过紧。如果你换一个品牌的手柄，可能需要重新配置所有按键映射。不利于跨平台。

Action-Based（基于动作）：（强烈推荐）

• 原理：引入一个抽象层。你先定义一些逻辑“动作”（Action），如“Grab”、“Teleport”。然后创建一个Input Action Asset文件，在这个文件里，你将“Grab”动作映射到不同设备的具体按键上（如Oculus Touch的Grip键，Index控制器的Grip力感应）。
• 优点：输入逻辑与设备解耦。更换设备时，只需在同一个Input Action Asset中修改映射，所有引用该动作的脚本都无需改动。这是面向未来的架构。
• 缺点：初期配置稍复杂。

我的选择：无脑选择Action-Based。Starter Assets提供的预制件也默认采用此模式。它带来的可维护性和扩展性优势，在项目后期会体现得淋漓尽致。

4.2 创建与配置Input Action Asset

这是Action-Based输入的核心配置文件。

1. 在Project窗口中右键Create > Input Actions，命名为XRI Default Input Actions。

2. 双击打开该文件，你会看到一个类似动画状态机的编辑器窗口。

3. 理解结构：

   • Action Maps：动作地图，用于分组。例如，你可以创建“Gameplay”、“UI”、“Menu”等地图，在不同游戏模式下启用不同的输入集。
   • Actions：具体的动作，如“Grab”、“Teleport”、“Turn”。每个动作有“Action Type”：
     • Button：用于抓取、确认等瞬时动作。
     • Value：用于扳机键按压程度、摇杆坐标等连续值。
     • Pass-Through：较少用。
   • Bindings：绑定，即把这个动作关联到哪个设备的哪个物理控件上。

4. 配置常用动作（以右手为例）：

   • 在“XRI RightHand” Action Map下，创建以下Actions:
     • Select(Type: Button)：绑定到<XRController>{RightHand}/triggerPressed。
     • Activate(Type: Button)：绑定到<XRController>{RightHand}/gripPressed。（注意：Select常用于UI点击和抓取开始，Activate常用于持续激活，如开枪）
     • UI Press(Type: Button)：通常也绑定到triggerPressed，用于UI交互。
     • Rotate Anchor(Type: Value)：绑定到<XRController>{RightHand}/thumbstick，用于转身。
     • Move(Type: Value)：绑定到<XRController>{RightHand}/thumbstick，用于移动（通常与左手区分）。

5. 应用到控制器：

   • 在场景中选中你的右手控制器物体。
   • 找到XR Controller (Action-based)组件。
   • 将Model Prefab设置为你的手柄模型（Starter Assets里有提供）。
   • 在Input Action Configuration下方，将我们创建的XRI Default Input Actions资源拖入。
   • 然后为每个属性（如Select Action）选择对应的Action，例如Select Action选择“XRI RightHand/Select”。

避坑指南：最常见的错误是Input Action Manager组件没有正确引用你的Input Action Asset，或者Action Map没有启用。确保场景中唯一的Input Action Manager组件引用了你的asset，并且在脚本中或通过事件在合适的时间调用EnableInputActionMapping()和DisableInputActionMapping()来切换不同的Action Map。

4.3 通过代码监听输入事件

配置好输入后，如何在脚本中响应呢？不再使用传统的Input.GetKeyDown，而是订阅Input System的事件。

using UnityEngine; using UnityEngine.InputSystem; // 引入InputSystem命名空间 using UnityEngine.XR.Interaction.Toolkit; public class MyWeapon : MonoBehaviour { [SerializeField] private InputActionReference _shootActionReference; // 在Inspector中拖入配置好的Shoot动作 [SerializeField] private ParticleSystem _muzzleFlash; private void OnEnable() { // 启用动作，并绑定回调函数 _shootActionReference.action.Enable(); _shootActionReference.action.performed += OnShootPerformed; _shootActionReference.action.canceled += OnShootCanceled; // 对于Value类型动作，可能需要canceled事件 } private void OnDisable() { // 禁用动作，解除绑定，防止内存泄漏 _shootActionReference.action.Disable(); _shootActionReference.action.performed -= OnShootPerformed; _shootActionReference.action.canceled -= OnShootCanceled; } private void OnShootPerformed(InputAction.CallbackContext context) { // context.ReadValue<float>() 可以读取Value类型动作的值（如扳机力度） // 对于Button，通常只需检查 performed 状态 Debug.Log("Shoot!"); _muzzleFlash.Play(); // ... 发射子弹的逻辑 } private void OnShootCanceled(InputAction.CallbackContext context) { Debug.Log("Shoot Released."); // ... 停止连发等逻辑 } }

这种方式非常清晰和模块化，输入逻辑与游戏逻辑完全分离。

5. 高级特性与性能优化实战

掌握了基础交互和输入后，要让你的XR应用脱颖而出，还需要一些高级技巧和对性能的敏锐把握。

5.1 传送（Teleportation）与场景导航

瞬移是VR中防止眩晕的核心移动方式。XRI提供了完善的传送方案。

配置传送区域：

1. 创建传送锚点：在场景中创建一个空物体，添加Teleportation Anchor组件。这定义了一个玩家可以传送到的具体位置。
2. 配置传送区域：通常是一个平面（如地板）。给它添加Teleportation Area组件。玩家可以传送到这个平面上的任何位置。
3. 连接控制器：确保你的XR Ray Interactor组件上，Allow Select是关闭的（因为我们用射线选择传送点，而不是抓取），并且Ray Interactor的Select Action Trigger设置为“State”（状态），这样按住按键时持续显示射线，松开时触发传送。
4. 添加视觉反馈：使用XR Interactor Line Visual来显示射线，并可以附加一个XR Teleport Reticle（传送瞄准圈）预制体到射线的终点，让玩家明确知道将要传送到哪里。

进阶：抛物线传送与区域过滤

• 抛物线：在XR Ray Interactor上启用“Enable Curve”或“Enable Straight Line”，可以切换射线为抛物线，更适合远距离瞄准和越过障碍物查看落点。
• 区域过滤：通过Interaction Layer Mask，你可以控制哪些射线可以与哪些传送区域交互。例如，你可以设置只有左手控制器的射线可以触发传送，而右手射线用于交互。

我的优化心得：传送的瞬间如果处理不好，很容易造成帧率下降或卡顿。确保传送目标点附近没有需要即时加载的高面数模型或复杂特效。可以在玩家确认传送目标后、实际传送前，加入一个短暂的淡入淡出（Fade）效果，这个视觉过渡期可以用来预加载必要的资源。

5.2 交互事件体系与自定义响应

XRI的强大之处在于其基于事件的、高度可扩展的交互体系。几乎所有的交互行为都通过C#事件暴露出来。

核心事件（以XRGrabInteractable为例）：

• OnFirstHoverEntered/OnLastHoverExited：第一个交互器开始/结束悬停时触发。
• OnSelectEntered/OnSelectExited：被抓取时/释放时触发。
• OnActivated/OnDeactivated：激活时/取消激活时触发（常与Activate按钮绑定）。
• OnFocusEntered/OnFocusExited：与UI聚焦相关。

自定义响应示例：让物体被抓取时发光

1. 创建一个脚本HighlightOnGrab。
2. 在脚本中获取物体的Renderer组件和原始材质。
3. 订阅XRGrabInteractable的事件：

using UnityEngine; using UnityEngine.XR.Interaction.Toolkit; public class HighlightOnGrab : MonoBehaviour { private XRGrabInteractable _grabInteractable; private Material _originalMaterial; [SerializeField] private Material _highlightMaterial; private Renderer _objectRenderer; void Start() { _grabInteractable = GetComponent<XRGrabInteractable>(); _objectRenderer = GetComponent<Renderer>(); _originalMaterial = _objectRenderer.material; if (_grabInteractable != null) { // 订阅事件 _grabInteractable.selectEntered.AddListener(OnGrabbed); _grabInteractable.selectExited.AddListener(OnReleased); } } private void OnGrabbed(SelectEnterEventArgs args) { _objectRenderer.material = _highlightMaterial; // 还可以在这里播放音效、触发动画等 } private void OnReleased(SelectExitEventArgs args) { _objectRenderer.material = _originalMaterial; } void OnDestroy() { // 重要：取消订阅，防止对象销毁后事件回调导致错误 if (_grabInteractable != null) { _grabInteractable.selectEntered.RemoveListener(OnGrabbed); _grabInteractable.selectExited.RemoveListener(OnReleased); } } }

这种事件驱动模式使得功能模块之间高度解耦，你可以轻松地为任何可交互物体添加复杂的行为链。

5.3 性能监控与关键优化点

XR应用对性能极其敏感，必须稳定维持高帧率（如72Hz, 90Hz, 120Hz）以防止眩晕。

1. 绘制调用（Draw Calls）与合批：

• 问题：场景中大量的小物件（如散落的子弹、道具）会产生巨量的Draw Calls。
• 优化：
  • 静态合批：将不会移动的静态场景物体（如墙壁、地板）标记为Static（在Inspector右上角）。Unity会在构建时自动将它们合并。
  • 动态合批：Unity运行时会对小型、相同材质的网格进行合批。确保共享材质的物体使用相同的材质实例，而不是材质副本。
  • GPU Instancing：在材质的Inspector中启用“Enable GPU Instancing”，对于大量重复的物体（如树木、草丛）有奇效。

2. 光照与阴影：

• 实时阴影：是性能杀手。尽量减少Real-Time光源的数量和阴影分辨率。
• 烘焙光照：对于静态场景，务必使用Baked Global Illumination。将静态物体标记为Static，然后进行光照烘焙（Window > Rendering > Lighting）。这会将光照信息“烤”进贴图，运行时零开销。
• 反射探针：谨慎使用。尽量用烘焙的反射探针代替实时探针。

3. 物理开销：

• 刚体数量：每个Rigidbody和Collider都有CPU开销。避免成百上千的物理物体同时模拟。
• 碰撞体复杂度：使用简单的原始碰撞体（Box, Sphere, Capsule）代替Mesh Collider。如果必须用Mesh Collider，勾选“Convex”并尽量简化网格。
• 物理更新频率：在Project Settings > Time中，可以适当降低Fixed Timestep（如从0.02降到0.04），但会影响物理精度，需测试。

4. XR特定的性能工具：

• Unity Profiler：务必在真机（如Quest通过ADB连接）或VR Simulator中运行Profiler。关注CPU Usage、GPU Usage、Render Thread和Physics的耗时。
• XR Stats：在运行状态下，勾选Game视图菜单 > Stats，可以查看关键的XR性能指标，如GPU Time、CPU Time、Dropped Frames（掉帧数）。掉帧数是衡量舒适度的黄金指标，理想情况下应为0。
• 层次细节（LOD）：为复杂的模型设置LOD Group，距离玩家远时自动切换到低模。
• 遮挡剔除：对于大型复杂室内场景，使用Occlusion Culling来剔除视野外的物体。

我的性能检查清单：

• [ ] 静态物体是否标记为Static并完成了光照烘焙？
• [ ] 实时光源是否超过1个？阴影质量是否过高？
• [ ] 材质球数量是否过多？是否使用了GPU Instancing？
• [ ] 物理刚体数量是否可控？碰撞体是否足够简单？
• [ ] Profiler中是否有持续的GC Alloc（垃圾回收分配）？避免在Update中频繁new对象。
• [ ] 在目标设备上运行，Dropped Frames是否持续为0？

6. 从示例到实战：构建一个简单的交互demo

让我们把前面所有的知识点串联起来，创建一个包含基础移动、抓取、UI交互和传送的小场景。

目标：一个房间内，玩家可以移动、抓取桌上的立方体，与墙上的控制面板交互打开一扇门，并通过传送到达另一个区域。

步骤：

1. 场景搭建：创建两个房间（Room A, Room B），用一扇门隔开。在Room A放置一个桌子（Cube），桌上放一个可抓取的小立方体。在Room A的墙上创建一个World Space Canvas作为控制面板，上面有一个Button。
2. 配置XR基础设置：
   • 添加XR Origin (Action-based)、Interaction Manager、Input Action Manager。
   • 为左右手控制器配置好混合Interactor（Direct + Ray），并挂载从Starter Assets导入的输入配置。
3. 实现抓取：为桌上的小立方体添加XR Grab Interactable组件，设置Attach Transform到一个子空物体（模拟握把），Movement Type设为Kinematic。
4. 实现UI开门：
   • 确保墙上的Canvas有Tracked Device Graphic Raycaster。
   • 编写一个脚本DoorController，挂在门上，里面有public void OpenDoor()方法。
   • 将墙上的UI Button的OnClick()事件，拖拽绑定到DoorController.OpenDoor方法上。
   • 运行，用射线点击按钮，门应打开。
5. 实现传送：
   • 在Room B的地板上创建一个Plane，添加Teleportation Area组件。
   • 确保左手或右手控制器的XR Ray Interactor允许与Teleportation Area交互（通过Layer或Interaction Layer Mask）。
   • 配置XR Ray Interactor的Select Action为传送（通常绑定到手柄的摇杆下压或特定按钮），并设置好传送的视觉反馈（抛物线、瞄准圈）。
6. 集成移动（平滑移动/瞬移转向）：
   • 在XR Origin上添加ActionBased Continuous Move Provider（平滑移动）和ActionBased Snap Turn Provider（瞬移转向）组件。
   • 在你的Input Action Asset中，为左手摇杆创建“Move”动作（2D Vector），为右手摇杆创建“Turn”动作（1D Axis或2D Vector的X值）。
   • 将这些动作分别赋值给Continuous Move Provider的Move Action和Snap Turn Provider的Turn Action。
   • 调整移动速度、转向角度等参数以适应你的场景尺度。

完成以上步骤，你就拥有了一个功能完整的微型XR体验。这个过程强迫你理解了XRI各个模块是如何协同工作的。

7. 常见问题排查与调试技巧

即使按照教程操作，也难免会遇到问题。这里记录了我遇到的一些典型问题及解决方法。

调试技巧：

• 使用XR Interaction Debugger：菜单栏Window > Analysis > XR Interaction Debugger。这是一个神器！它可以实时可视化场景中所有的Interactor和Interactable，显示它们的交互状态（Idle, Hover, Select）、关联关系、输入值等。当交互行为不符合预期时，第一时间打开它。
• 善用Console日志：在关键的交互事件（如OnSelectEntered）中添加Debug.Log，打印出交互的对象和控制器，可以快速定位逻辑流程。
• 简化测试场景：当遇到复杂问题时，新建一个最简场景，只包含XR Origin、一个控制器和一个立方体，逐步添加功能，定位问题引入的步骤。