企业官网建设流程全解析

做XR项目，手柄交互是我个人觉得最值得花时间啃的一关。很多人一开始用Unity XR Interaction Toolkit（下面简称XRI）搭Demo，觉得“手柄不就是发出一根射线嘛”，但真正把抓取、传送、UI点击、震动反馈串起来以后，才会发现这套系统的逻辑比你想象得深得多。这篇是XRI系列的第二篇，单独把“手柄交互”拎出来拆一遍，从最基础的模型接入、射线可视化，到抓取、传送、UI交互和震动反馈，全部按我实际项目里的调试顺序来讲，尽量让没有接触过XRI的人也能照着重现一遍，已经写过项目的也能找到值得对标的细节。

这篇内容适合两类人：一类是刚接触XR开发、准备用Unity做PICO或Quest项目的初学者，另一类是已经能跑通简单手势交互，但一直被手柄模型不显示、抓取抖动、UI点不中这种问题折磨的开发者。手柄交互是整个XR项目里最贴近“手感”的模块，它不只是一个组件挂在场景里就完事，里面牵扯到输入系统、射线检测、物理刚体、UI射线命中、动画控制等多个环节。我尽量把每个环节的“为什么”也讲清楚，而不只是告诉你“点哪里、拖哪个组件”。

1. 动手之前先搞懂XRI手柄交互的几个基本概念

1.1 手柄交互在XR项目里到底负责什么

我先把这个模块的职责范围说清楚。手柄交互听起来只是“两只手柄的操作”，但在实际项目里，它往往同时承担四件事：第一，把用户在真实世界里的手部动作映射到虚拟场景中的手柄模型上，也就是姿态跟随；第二，通过按键输入产生交互意图，比如按下扳机表示“我想抓取”，拨动摇杆表示“我想移动或者传送”；第三，生成可视化反馈，让用户看到自己当前瞄准的是什么、能不能抓、能不能点；第四，触发虚拟物体的响应，比如物体被抓起来、UI按钮被按下、传送点被激活。

这四件事在XRI里并不是一个组件干完的，而是拆成了Input System（输入映射）、XR Controller（控制器基础）、XR Ray Interactor（射线交互器）、XR Interactable（可交互物体）四个层次。很多新手第一次打开XRI的示例场景，看到一堆组件叠在一起会懵，其实只要把“输入→控制器→交互器→可交互物体”这条链路在脑子里建立起来，后面所有配置都有迹可循。

1.2 XRI里Interactor和Interactable是怎么回事

XRI的核心模型就两个词：Interactor和Interactable。可以把它理解成真实世界里的“手”和“物体”。手发出动作，物体响应动作，两者之间通过“交互层掩码（Interaction Layer Mask）”配对。如果手和物体不在同一个层，就算实际距离再近也交互不了。

Interactor有几种主要形态：手柄射线（XR Ray Interactor）、直接触摸（XR Direct Interactor）、以及用于Socket插槽的XR Socket Interactor。手柄交互最常用的是射线形态，因为XR的虚拟空间通常比较大，用户不可能走到每个物体面前再用手去摸，射线能帮你抓取几米外的物体、点击墙上的UI面板、指向远处传送点，这些都是射线交互器的典型场景。

Interactable则是指能被交互的物体组件，比如XR Grab Interactable负责被抓取，Teleportation Area负责被指向后触发传送，XR Simple Interactable负责响应点击。在配置的时候，最让人容易忽略的其实是“层掩码”这一项。默认情况下，所有Interactor和Interactable都在Default层，所以示例场景能跑通；一旦你为了性能或者逻辑给物体分了层，却没同步修改Interactor的Interaction Layer Mask，就会出现射线明明照到物体上、却永远无法抓取或点击的诡异问题。这个点我会在第4章里再展开。

2. 从零搭一套能跑的手柄交互Demo

2.1 环境准备与版本选型

在开始配置之前，先确认一下你的Unity版本和XRI版本。当前主流方案是Unity 2021 LTS或2022 LTS搭配XRI 2.5.x，以及Unity 6配套的XRI 3.0。我个人建议如果是新项目，直接看Unity 6加XRI 3.0；如果是维护老项目，继续用2.5.x也没有问题，核心交互逻辑差别不是特别大，但组件名称和Inspector布局会有一定差异，网上的教程很多是基于2.x的，看的时候要留个心眼。

所需Packages一般是这几个：XR Plugin Management、OpenXR Plugin、XR Interaction Toolkit、Input System。在Package Manager里全部装上以后，去Project Settings里的XR Plug-in Management把OpenXR勾上，再根据你的目标设备启用对应的Interaction Profiles。比如做PICO 4就启用PICO Controller，做Quest就用Oculus Touch Controller Profile，不然手柄的按键映射会有一部分失效。

接下来要确认输入系统模式。XRI 2.x以上基本依赖Input System Package，Project Settings里Active Input Handling要选“Input System Package (New)”或者两者并用的选项。这一步很容易被忽略，但如果不设置，XRI的输入绑定会完全无法工作，手柄上按什么都没反应。

2.2 手柄模型接入：OpenXR Controller Model与常见坑

手柄模型接入是很多人的第一道坎。XRI本身不带任何厂商的手柄模型，它只负责控制器的位置和旋转跟踪。想在虚拟场景里看到手柄，目前最省事的方式是用OpenXR的Controller Model组件。

操作上，在场景里找到XR Origin（或者XR Rig）下的Camera Offset子物体，里面通常已经有一对LeftHand Controller和RightHand Controller的空节点。给每个节点挂上XR Controller组件，然后再挂一个OpenXR Controller Model组件，把Controller Node分别设为Left和Right，把Model Prefab指定为你导入的厂商手柄模型文件。这样手柄模型就会自动跟随真实手柄的位姿。

这里有几个坑值得单独提醒。第一，手柄模型的FBX网格导入后，很多朋友直接拖进去用，结果发现手柄在头显里比真实手大一圈或者角度扭了。这是因为模型的单位比例和Unity默认单位不一致，导入时需要在Model选项卡里调整Scale Factor，并检查模型朝向是否沿Z轴正向。第二，手柄模型最好单独放到一个自定义Layer上，比如HandLayer，然后把这个Layer从XRRayInteractor的Raycast Mask里去掉，不然手柄自身的手部追踪射线或者抓取射线可能会被自己的模型挡住，导致瞄准线在眼前就断掉了。第三，在PICO设备上如果手柄完全不显示，很可能是OpenXR的PICO Controller Profile没启用，或者在设备上使用的是旧版接口，需要升级设备端SDK。

2.3 射线可视化：Line Visual与手柄控制器配置

手柄要发出一根可视化的射线，需要三个组件互相配合：XR Ray Interactor负责真正的检测与交互，XR Interactor Line Visual负责把射线画出来，XR Controller则提供扳机、摇杆等输入值。很多初学者以为“看得见的那根线”就是检测用的，其实Line Visual只是渲染表现，真正的命中判定是由XR Ray Interactor的Raycast逻辑完成的。这也解释了为什么有时候射线看起来已经穿过物体，但物体却没有任何反应——因为Line Visual的渲染效果和Raycast命中的结果并不总是一一对应，尤其是当Line Visual使用了比较复杂的贝塞尔曲线效果时，视觉终点和实际命中点会有偏差。

在XR Ray Interactor的Inspector里，有几个参数直接影响手感。Max Raycast Distance控制最远检测距离，我一般设成10米左右，太远了不仅难以瞄准，而且每帧的物理射线检测也会增加开销。Line Type建议直接用Straight Line，手感最直接；曲线模式虽然好看，但在实际操作里会让用户很难判断自己到底瞄准了哪里，尤其是新手。只有当目标物体可能在遮挡物后面、需要展示“抓取弧线”这种特殊效果时，我才会换用Projectile Curve或者Bezier Curve。

当手柄射线的可视化配置好以后，下一步就是绑定输入动作。XRI提供了一套预设的XRI Default Input Actions资产，你可以在Project窗口右键Create → XR → XRI Default Input Actions生成。里面已经定义好了左右手柄的Teleport、Grab、UI Click、Rotate等常用动作，配合XR Controller上的Select Action、Activate Action、UI Press Action等字段完成映射。

3. 核心交互功能实操与参数调优

3.1 抓取：距离拾取、跟随模式与稳定性

抓取是手柄交互里最有“手感”的一个功能。理论上，你只需要给物体挂一个XR Grab Interactable组件，再加一个Collider和Rigidbody，手柄射线对准物体、按下扳机，物体就会被吸过来。但实际做下来，你会发现“能抓起来”和“抓起来像那么回事”完全是两码事。

最关键的设置是Movement Type。XRI提供三种选择：Instantaneous、Velocity Tracking和Kinematic。Instantaneous是用插值直接让物体瞬移到抓取点，反应最快但惯性感较弱；Velocity Tracking是基于速度跟随的方式，会让物体有轻微延迟和惯性，更适合模拟真实物体的重量感；Kinematic则把物体交给刚体的运动学模式去驱动，适合需要和其他物理交互的场景。我常用的是Velocity Tracking，但它对参数的敏感度很高，调不好就会出现“抓在手里还一直抖”的问题。

抓取点的设置也是细节中的细节。XR Grab Interactable默认抓取位置是物体的中心点，但这往往不符合直觉——你抓一个水杯，总不希望手伸到杯子中心去握。解决方案是给物体创建一个子物体作为Attach Transform，比如放在杯子的手柄位置，然后把XR Grab Interactable上的Attach Transform指定给这个子物体。这样抓取时手柄会移动到Attach Transform的位置，杯子的手柄正好握在手里。

这里还要补充一个我踩过的坑：给被抓物体添加Rigidbody后，Mass不要调太小，不然抓取后碰撞检测会变得很“飘”。另外，如果物体抓取后需要在手里保持稳定，可以考虑把物体的Collider设为不参与射线检测，或者把Interactable的Layer设成独立层，否则抓住物体后，手柄的射线会被手里的物体挡住，导致你没法同时用同一只手去点击其他UI。

3.2 传送交互：Teleportation Area的前后端逻辑

传送是VR里避免晕动症的常用移动方式。XRI里实现传送很简单，在地面上放一个平面，挂上Teleportation Area组件，再把Locomotion System拖到场景里，指定给XR Origin或XR Rig，手柄射线照到传送区域时，把手柄的Activate Action设为Teleport Mode Select，按下摇杆就会显示目标指示器，松开后人物传送到指定位置。

但传送功能真正用起来，有几个容易被忽视的点。第一，传送区域必须能被射线检测到，也就是说它所在的Layer必须在XR Ray Interactor的Raycast Mask范围里，否则射线只是“穿透”地面，永远不显示可传送标记。第二，Teleportation Area本身也有一个Interaction Layer Mask，默认是Teleport，而XR Ray Interactor的Interaction Layer Mask也要包含Teleport，两边才能配对。很多朋友把传送区域建好了，但射线就是不变绿，其实多半是层掩码不匹配。第三，是选择Teleportation Area还是Teleportation Anchor：Area是整个表面任意位置都能传，适合开阔地面；Anchor则绑定一个固定位置，适合传送到某个精确的点位。

还有一个小技巧是传送有效/无效状态的视觉反馈。XRI内置了指尖圆圈颜色的切换，绿色表示可传送，红色表示不可传送。但前提是XR Interactor Line Visual里开启了Teleport Marker Visual，并且你正确配置了传送区域。我第一次做的时候发现，无论如何都显示红色，排查了很久才发现是场景里同时存在两套Teleportation Area，一套在有效层，一套在无效层，射线同时命中了两者，系统判定为不可传送。所以大型场景里，多个传送区域的重叠区域一定要处理干净，要么用逻辑层分开，要么在代码层面控制某些区域在特定时机不可用。

3.3 UI交互：让射线既能照墙又能点按钮

手柄射线点击UI按钮和平时的鼠标点击UI是两套体系。普通UI用的是GraphicRaycaster，而XRI里要用Tracked Device Graphic Raycaster，这样才能接受来自XR交互器的点击事件。同时，EventSystem上也要把默认的Standalone Input Module替换成XR UI Input Module。

具体配置步骤是：在你的Canvas上添加Tracked Device Graphic Raycaster组件，把原来的GraphicRaycaster删掉或禁用；然后把World Space Canvas的Event Camera指定为XRRig下Camera Offset里的主摄像机，再把Canvas的Plane Distance设成一个合适的值。手柄的XR Ray Interactor上也要勾选UI相关的选项，比如当射线命中UI时，物体抓取和传送功能要能自动让位，这就需要在XR Ray Interactor上设置Block UI On Interactable Select、Block UI On Hover等开关。

实际运行里最让人头疼的问题是“射线能照到UI但死活点不了按钮”。这种情况绝大多数是EventSystem配置出了问题。尤其在Unity里如果场景存在多个EventSystem，或者旧版本遗留的Standalone Input Module没删干净，XR UI Input Module的输入就会被抢掉。还有一个容易被忽略的点：Canvas的Render Mode如果还是Overlay，XR的射线是无法参与UI检测的，必须改成World Space模式。

3.4 震动反馈与操作手感提升

手柄交互如果缺了震动反馈，整个操作会显得很“死”。XRI里做震动很简单，在需要反馈的时机调用XR Controller的Send Haptic Impulse方法即可。比如抓取物体的瞬间，可以写这样一段逻辑：

public void OnSelectEntered(SelectEnterEventArgs args) { var controller = args.interactorObject.transform.GetComponent<XRBaseController>(); if (controller != null) { controller.SendHapticImpulse(0.3f, 0.1f); } }

需要注意的是，OpenXR的震动需要设备支持对应的Haptic扩展。在PICO和Quest上一般没问题，但某些PC VR设备或模拟器上可能没有反馈。另外，SendHapticImpulse有一个很隐蔽的特性：同一时间内连续多次调用会造成震动信号重叠甚至失效，频率太高的时候设备会忽略后发的脉冲，所以针对高频事件（比如连续扣扳机）要做节流，一般每50毫秒最多触发一次震动就够了。

除了震动，手感的提升还可以靠射线宽度、抓取范围、交互特效声音来配合。比如射线命中物体时，把Line Visual端点的小圆点从灰色变成高亮色，同时播放一个“嘀”的提示音，用户的命中感就会强很多。这些细节单独看都不复杂，但加在一起，整个手柄交互的完成度会明显不一样。

4. 实战踩坑记录：常见问题与排查

4.1 手柄模型在头显里不显示或只显示骨骼

这个问题在PICO和Quest设备上都很常见，原因通常是这几类里的一种。第一，OpenXR Interaction Profile没启用，PICO要勾PICO Controller，Quest要勾Oculus Touch，检查Plug-in Management里的OpenXR Feature列表。第二，手柄模型的网格和材质文件没有正确导入，或者导入后被项目设置里的Strip Engine Code裁剪掉了，发布前最好在Player Settings里把Managed Stripping Level调低一点。第三，手柄模型挂在了错误节点上，比如挂在XR Origin根节点下而没挂在Camera Offset下面，导致位置跟随错误。

如果模型显示的是骨骼而不是皮肤，优先检查模型导入设置里的Animation Type，确认是不是被识别成了Humanoid并在运行时被动画系统驱动，必要时改成Generic模式。

4.2 射线穿墙、显示错乱或时断时续

射线穿墙本质上是Line Visual只画了线，而实际命中点被墙壁之外的东西拦截了。优先检查XR Ray Interactor的Raycast Mask，确认是否包含了所有需要命中的层，同时确认没有把手柄模型自带的碰撞体算进去。射线时断时续则大多是因为命中的物体有多个Collider，而XRI的Raycast只取第一个命中点，当物体的Collider在手指和物体之间不断切换时，视觉上就会表现为射线闪烁。

另外，如果你的场景里有较多UI Canvas，并且Canvas上没有挂Tracked Device Graphic Raycaster，射线会被UI挡住导致穿不过去。这个问题的诡异之处在于你根本看不见那个UI，但它依然参与了射线检测，所以一旦发现射线“穿透”得莫名其妙，先检查场景里有没有隐藏的不可见UI充当了拦路虎。

4.3 抓取物体抖动、弹飞或穿模

抓取后的抖动原因很多，我按概率排一下：一是Movement Type用了Velocity Tracking，但Rigidbody的Solver Iterations太低，可以在Project Settings的Physics里把默认Solver Iterations调高到8、Solver Velocity Iterations调到4；二是抓取点的Attach Transform和手柄模型中心偏差过大，导致物体一直在“追”手柄的位置；三是物体的Collider和手柄的Collider在抓取后产生互斥推力，建议抓取时临时禁用被抓住物体的碰撞，或者用Layer来隔离碰撞；四是Rigidbody的Interpolate设为None时物体跟随会显得很生硬，配合Velocity Tracking可以改成Interpolate，能让画面顺滑很多。

穿模问题多半不是XRI本身造成的，而是手柄模型的Collider太大，抓取后物体被推开。我给手柄模型挂Collider时，一般只用很小的球形碰撞体，并且把它的Layer设成Ignore Raycast，既保留物理碰撞又不干扰逻辑。

4.4 手柄射线点不中UI按钮

按钮永远点不中的排查顺序依次是：Canvas是否为World Space且Event Camera是否正确指定；EventSystem上是否用的是XR UI Input Module；Canvas上是否挂了Tracked Device Graphic Raycaster；XR Ray Interactor的UI Press Action是否绑定到了扳机键；以及Interaction Layer Mask是否包含UI层。此外还有一个经常被忽略的细节：World Space Canvas的缩放比例不能太夸张。如果你把Canvas的Scale设成0.01，射线命中的判定区域会变得极其敏感，按钮位置稍微偏一点就点不到。我通常把Canvas的Scale保持在0.001到0.002这个量级，再配合Plane Distance来调节面板距离，命中会稳定很多。

4.5 不同XRI版本差异速查与迁移建议

网上教程大多基于XRI 2.x，但Unity 6默认使用XRI 3.0，组件变化不小。最直观的变化是XR Controller被拆分成了XR Input Modality Manager和XR Controller组件，旧版Inspector里那一堆输入绑定字段被移到了Input Modality Manager里统一配置；XR Origin的Prefab结构也简化了，少了一层嵌套；XR Grab Interactable的交互事件从固定的OnSelectEntered等改成了更灵活的XR Interactable Event，可以通过UI拖拽配置。

如果你是老项目升级，最稳妥的做法不是直接替换Package，而是先在分支上把XRI升到3.0，跑一遍示例场景，再把你自己写的交互代码逐个接入新事件系统。直接大版本跳跃很容易遇到“编译过了但交互全失灵”的情况，原因是XR Controller的输入地址变了，动作绑定其实丢失了。

5. 把Demo做成产品级交互之前，值得想清楚的事

5.1 交互架构设计：层、身份与状态机

当你不再满足于Demo，想把手柄交互做成一个可以交付的产品时，你会发现最花时间的其实不是“让手抓一个杯子”，而是“让手里拿着的道具在不同场景有不同的行为”。这时候，单一的手柄交互脚本会变得非常臃肿。我的个人实践是：把一个交互对象拆成三层来管理，第一层是“可交互身份”，决定这个物体能被哪种Interactor识别、属于哪个Layer、优先级是多少；第二层是“交互状态机”，记录当前物体是闲置、被悬停、被抓取还是被放进了Socket；第三层是“交互规则”，比如杯子被抓住时可以倒水，但只有在靠近水壶时按下扳机才有效。

这套结构在一开始就规划好，比后面所有物体都堆一起再重构要省太多时间。具体到代码上，可以用接口加状态机的方式，比如定义IInteractableItem接口暴露CanInteract、OnGrab、OnRelease等方法，抓取时通过组件查找来决定调用哪套逻辑。

5.2 性能与手感调优方向

手柄交互性能优化的核心是减少每帧不必要的射线检测和刚体跟随。场景里交互物体不多的时候感觉不出来，但一旦到了有几十个可抓取物件的生产级场景，每帧让所有Interactor都执行物理检测，CPU开销很快就上来了。我的建议是射线的Max Raycast Distance不要贪大，并且尽量少开多个XR Ray Interactor同时工作；那些不太重要的交互物体可以放到单独的Layer里，用较低的轮询频率做检测。

手感调优则更偏主观，每个项目的手感目标都不一样，没有一套万能参数。常见手段包括：抓取时略微缩小射线命中半径（防止用户还没对准就把东西吸过来）、抓取后给物体加一定的阻尼和惯性、松开手时给物体施加一个小的向上速度补偿，让物体不被手带飞。这些都要靠真机反复测试，不要只在编辑器里调，头显里感受到的延迟和手柄手感，和编辑器里完全是两个世界。

我在实际项目里的体会是：手柄交互做到“能用”很容易，做到“顺手”则要来回打磨很久，但只要把Interactor、Interactable、Layer这三件套的机制彻底吃透，绝大多数问题都能定位到具体环节，不再靠瞎试碰运气。希望这篇能把你在手柄交互上卡壳的地方都疏通一遍，后面玩得更顺一些。