1. 从零搭建一个能走能抓的VR房间：先搞清楚UE4里哪些轮子已经造好了
很多人第一次打开UE4准备做VR室内交互，第一反应是去网上找一套模板工程，拖进来改改就完事。我早期也这么干过，结果项目做到一半发现移动逻辑和碰撞打架、抓取物体穿墙、UI射线对不准，回头拆模板比自己从头搭还费劲。所以这篇内容我打算换个思路讲——不依赖任何现成VR模板，从UE4自带的基础组件出发，把室内VR交互最核心的几件事一件件搭出来。
所谓“室内VR交互基本功能”，拆开来看其实就四件事：能在房间里自由移动、能用手柄抓住和放下物体、能跟场景里的UI或按钮产生交互、能触发一些简单的反馈（比如高亮、音效、震动）。这四件事覆盖了绝大多数室内VR Demo和展示类项目的需求，比如虚拟样板间、工业培训模拟、教育类场景漫游。适合的读者是已经会打开UE4编辑器、知道Actor和蓝图是什么、但还没系统做过VR交互的开发者。如果你连蓝图节点都没连过，建议先花半天把官方的基础蓝图教程过一遍再回来。
UE4做VR有一个天然优势：它内置了MotionController组件和VR追踪相关的底层支持，你不需要自己写驱动层的东西。但劣势也很明显——默认的移动组件（CharacterMovementComponent）是为键鼠和手柄设计的，直接搬到VR里会有眩晕和碰撞问题。所以整篇文章的核心逻辑就是：哪些用引擎自带的，哪些必须自己改，改的时候为什么这么改。
我下面所有的操作都基于UE4.27版本，这是目前VR项目里稳定性最好的一版。UE5的VR模板改动比较大，但核心思路是通的，我会在关键位置标注UE5的差异。
2. 移动方案的选择：传送还是平滑移动，这不是一个随便选的选择题
2.1 两种移动方式的本质差异与眩晕根源
室内VR的移动，绕不开一个根本矛盾：你在虚拟世界里移动了，但你的前庭系统（内耳平衡器官）告诉你没动。这个矛盾就是VR眩晕的主要来源。平滑移动（Smooth Locomotion）是左摇杆推着角色连续位移，视觉上像滑冰；传送移动（Teleport）是按住摇杆瞄准一个落点，松手瞬间跳过去。
从生理角度讲，传送移动几乎不引起眩晕，因为视觉上的位移是瞬时的，前庭系统来不及产生冲突信号。平滑移动则因人而异，有的人完全无感，有的人三十秒就冒冷汗。我实测下来，室内场景优先用传送，原因是室内空间通常有墙壁和家具，平滑移动很容易把玩家推进几何体内部，而传送可以通过落点检测直接规避。
但传送有一个体验上的硬伤：空间连续感断裂。玩家在虚拟样板间里看房，每走一步都“闪”一下，沉浸感大打折扣。所以我的做法是混合方案：默认传送，但在小范围微调时允许平滑移动。具体实现上，传送用抛物线投射，平滑移动用摇杆输入直接驱动Actor位移。
2.2 用抛物线投射实现可靠的传送落点
传送的核心是落点检测。UE4里最直接的方式是用ProjectileMovement或者手动做抛物线投射。我推荐手动投射，因为可控性更强。
具体做法是在MotionController上挂一个Spline组件或者用Predict Projectile Path By TraceChannel节点。后者是UE4自带的异步节点，输入起始位置、发射速度、重力，它会返回一条抛物线路径和命中结果。你把这个路径用Spline Mesh画出来，玩家就能看到一条弧线。
关键参数是发射速度。速度太小，抛物线太平，远距离传送够不着；速度太大，弧线太陡，落点不好判断。我一般设800-1200 cm/s，重力用默认的-980。这个数值下，抛物线在3-5米距离内比较自然。
落点检测的TraceChannel要特别注意。默认的Visibility通道会打到所有可见物体，包括一些你不想让玩家传送上去的装饰物。我的做法是自定义一个Teleport通道，在项目设置里把地板、地毯、楼梯设为Block，把墙壁、家具设为Overlap或Ignore。这样抛物线只会在地板上生成有效落点，打到墙壁时显示红色禁止标记。
还有一个容易忽略的点：传送后的朝向。如果玩家传送过去之后面朝墙壁，体验会很差。我的处理是传送时将玩家的朝向对齐到抛物线发射方向，或者保留传送前的朝向。前者适合走廊场景，后者适合房间场景。代码上就是设置Actor的Rotation，注意要用Set Actor Rotation而不是Set Control Rotation，因为VR里控制旋转是HMD驱动的。
2.3 平滑移动的碰撞处理与防穿墙策略
如果你决定加平滑移动，碰撞是最大的坑。UE4默认的CharacterMovementComponent用胶囊体碰撞，在VR里这个胶囊体是看不见的，玩家很容易把头伸进墙里。我的做法是用SphereComponent做身体碰撞，半径设30-40cm，挂在Pawn的根节点上，跟随HMD的水平位置移动。
具体蓝图逻辑：每帧获取Camera的世界位置，取XY平面分量，把碰撞球的位置设过去。这样玩家低头、抬头不会影响碰撞球，只有水平移动才会。碰撞球用Block对所有静态几何体，这样玩家就穿不过墙了。
但这里有个细节：碰撞球不能完全跟随HMD，否则玩家快速转头时碰撞球会瞬移，可能卡进几何体。我的做法是加一个插值（Lerp），让碰撞球以一定速度跟随，速度设500-800 cm/s。这样既不会穿墙，也不会因为转头而抖动。
平滑移动的速度也要控制。室内场景我建议150-250 cm/s，大约是人正常步行速度的一半。太快容易晕，太慢又觉得拖沓。摇杆输入要做死区处理，UE4的InputAxis节点自带死区参数，设0.2左右比较合适，防止手柄漂移导致角色自己走。
注意：如果你的项目要上架某些对眩晕敏感的平台，平滑移动可能需要在设置里提供关闭选项。这不是技术问题，是产品决策。
3. 抓取交互：从射线检测到物理约束的完整链路
3.1 抓取检测：射线、球体扫描还是重叠事件
抓取的第一步是判断手柄碰到了什么。常见方案有三种：射线检测（Line Trace）、球体扫描（Sphere Trace）、重叠事件（Overlap）。射线检测最精确但要求玩家瞄准，球体扫描容错率高但可能抓到不想抓的东西，重叠事件适合手部附近有多个物体时自动选取最近的。
我的选择是球体扫描为主，射线为辅。具体是在MotionController的前方挂一个SphereComponent，半径8-10cm，每帧做一次Sphere Trace By Channel，检测距离设15-20cm。这个范围大约是一个拳头的大小，符合直觉。如果球体扫描没结果，再发一条短射线（5cm）做补充，防止手指尖碰到物体但球体没覆盖到。
检测通道同样要自定义。我建了一个Grabbable通道，只有可抓取的物体设为Block，其他一律Ignore。这样手柄不会因为碰到墙壁或地板而触发抓取提示。
检测到物体后，高亮反馈是必须的。UE4里最简单的做法是切换物体的Custom Depth Stencil，然后在后期材质里根据Stencil值描边。更简单的做法是直接改物体的材质参数，比如加一个自发光边缘。我一般用Set Render Custom Depth加一个描边后期材质，性能开销小，效果也够用。
3.2 抓取方式：附着、物理约束还是混合
抓到物体之后，物体怎么跟随手柄？这是抓取交互最核心的技术决策。
方案一：直接Attach。把物体Attach到MotionController上，关掉物理模拟。优点是稳定、不抖动、性能好。缺点是物体变成“死”的，不能跟其他物体碰撞，穿墙穿桌子。适合UI面板、工具类物体。
方案二：物理约束。物体保持物理模拟，用PhysicsConstraint把它和手柄连起来。优点是物体仍然是物理体，能跟环境碰撞。缺点是容易抖动、弹簧感明显、快速移动时物体可能飞出去。适合需要真实物理反馈的场景。
方案三：混合方案。抓取瞬间Attach，但保留一个物理约束的“软连接”，或者根据物体类型切换。这是我实际项目里用得最多的。
具体实现上，我推荐抓取时Attach，但每帧用Set World Location和Set World Rotation做插值跟随，而不是硬Attach。这样物体既稳定又有一定的物理感。插值速度设15-20（Lerp的Alpha），太快会抖，太慢会拖沓。
对于需要物理碰撞的物体，比如你要把杯子放到桌子上，我建议抓取时Attach，松手时切回物理模拟并给一个初速度。初速度根据手柄的移动速度计算，用Get Physics Linear Velocity或者手动记录前几帧的位置差。这样扔出去的物体有自然的抛物线。
3.3 抓取姿态与手部模型的匹配
物体抓在手里，姿态很重要。一个扳手横着抓和竖着抓，手感完全不同。UE4里可以用Grip Motion Controller插件（如果是VRExpansion插件的话）或者自己实现抓取点（Grip Point）。
我的做法是在可抓取物体上加一个SceneComponent作为抓取点，命名GripPoint。抓取时，把手柄的位置和旋转对齐到这个GripPoint的相对变换。具体计算是：GripPoint的世界变换乘以手柄的世界变换的逆，得到相对变换，然后每帧用这个相对变换驱动物体。
这样不同物体可以有不同的抓取姿态。比如手枪的GripPoint在握把上，杯子的GripPoint在杯壁一侧。你只需要在物体蓝图里调整GripPoint的位置和旋转就行，不用改抓取逻辑。
手部模型方面，如果用的是Oculus Quest这类一体机，手部追踪是另一套API。但如果是PC VR，手柄模型直接用MotionController自带的Set Display Model就行。我建议手部模型不要做碰撞，只做视觉，碰撞交给前面的球体扫描。
4. 室内场景的UI交互：从3D按钮到射线点击
4.1 3D UI与2D UI的选择逻辑
室内VR里的UI，我分成两类：世界空间UI（World Space Widget）和屏幕空间UI（Screen Space Widget）。前者是挂在场景里的3D面板，比如墙上的开关、桌上的说明书；后者是跟随HMD的HUD，比如菜单、提示。
室内场景我强烈建议全部用世界空间UI。原因很简单：VR里屏幕空间UI会一直挡在眼前，破坏沉浸感。世界空间UI放在场景里，玩家想看就转头看，不想看就忽略，符合直觉。
UE4里创建世界空间Widget很简单：新建一个Widget Blueprint，在细节面板里把Space设为World，然后拖到场景里。关键是尺寸。默认的Widget尺寸在VR里可能太大或太小。我的经验是：1米距离上，Widget的宽度大约30-50cm比较合适。你可以用一个WidgetComponent挂在Actor上，调整Draw Size参数。
4.2 射线交互与手柄震动反馈
世界空间UI的交互，最自然的方式是手柄射线。从MotionController发一条射线，打到Widget上，用Widget Interaction组件处理点击。
具体做法：在Pawn里加一个WidgetInteraction组件，把它Attach到MotionController上。设置Interaction Distance为100-200cm，Interaction Source设为Custom，然后每帧把射线的起点和方向传给WidgetInteraction。WidgetInteraction会自动处理悬停和点击事件。
点击的触发方式有两种：扳机键和触摸板。我一般用扳机键，因为反馈明确。在Input里绑定MotionController Trigger，按下时调用WidgetInteraction的Press Pointer Key，松开时调用Release Pointer Key。
震动反馈是提升交互质感的关键。UE4里用Play Haptic Effect节点，在悬停和点击时分别播放不同的震动效果。悬停用短促的低频震动（频率0.5，幅度0.3，时长0.05秒），点击用稍强的震动（频率0.8，幅度0.6，时长0.1秒）。注意震动强度不要太大，否则长时间使用会手麻。
4.3 按钮的视觉反馈与状态管理
一个3D按钮，玩家怎么知道它被按下了？视觉反馈至少要有三种状态：默认、悬停、按下。
在Widget蓝图里，用Button控件的Hovered和Pressed事件切换颜色或缩放。我一般用颜色变化：默认灰色，悬停浅蓝，按下深蓝。缩放也可以，悬停时放大1.05倍，按下时缩小0.95倍。但缩放要注意锚点，否则按钮会跑偏。
状态管理上，我建议用一个枚举变量记录当前状态，而不是靠多个布尔值。比如EButtonState枚举：Default、Hovered、Pressed、Disabled。每次状态切换时更新视觉表现，逻辑清晰，不容易出bug。
还有一个细节：按钮的碰撞。WidgetComponent默认的碰撞是Box，但有时候玩家从侧面点不到。我的做法是把WidgetComponent的碰撞设为Box，尺寸比Widget本身大一圈（比如大10%），这样容错率更高。
5. 那些文档里不会写的坑：碰撞、性能与调试
5.1 碰撞通道的优先级冲突
UE4的碰撞系统是VR项目里最容易出问题的地方。我踩过最深的坑是传送落点检测和抓取检测互相干扰。传送的抛物线打到了可抓取物体，结果落点显示在物体上，玩家传送过去之后站在了杯子上面。
解决办法是给传送和抓取用不同的TraceChannel。传送用Teleport通道，只检测地板和楼梯；抓取用Grabbable通道，只检测可抓取物体。两个通道互不干扰。在项目设置的Collision里，把Teleport通道对Grabbable物体设为Ignore，反之亦然。
另一个坑是手柄碰撞和场景碰撞。MotionController默认没有碰撞，但如果你加了球体扫描，这个球体可能会跟墙壁碰撞，导致手柄被“弹开”。我的做法是球体扫描只做检测，不做物理碰撞。在SphereComponent的碰撞设置里，把Collision Enabled设为Query Only，这样它只参与射线检测，不参与物理模拟。
5.2 VR项目的性能红线与优化手段
VR对帧率的要求是90fps起步，最好120fps。UE4默认的渲染管线在室内场景里跑90fps不难，但如果你加了大量动态光源、后期效果、高面数模型，帧率会掉得很快。
我的优化清单：
- 关闭动态阴影，用静态光照烘焙。室内场景的光照变化不大，烘焙完全够用。
- 限制半透明物体数量。玻璃、水、粒子效果都是半透明，每个半透明物体都会增加Overdraw。室内场景里玻璃窗用不透明材质加反射球代替。
- 用LOD。远处的家具用低面数模型，近处才用高模。
- 关闭不必要的后期效果。Bloom、DOF、Motion Blur在VR里要么效果不好，要么性能开销大。我一般只保留抗锯齿和色调映射。
- 用Instanced Static Mesh。场景里重复的物体，比如椅子、杯子，用ISM合并Draw Call。
还有一个隐藏的性能杀手：WidgetComponent。每个世界空间Widget都是一个独立的Draw Call，而且如果Widget里有动画，每帧都会重绘。我的做法是把不常用的Widget设为Hidden，需要时再显示。另外Widget的Tick能关就关，用事件驱动代替每帧更新。
5.3 调试VR交互的实用技巧
VR调试比普通游戏调试麻烦，因为你在编辑器里看不到头显里的画面。我的几个常用技巧：
第一，用VR Preview模式。在编辑器里点Play旁边的小三角，选VR Preview，画面会直接输出到头显。这是最基本的调试方式。
第二，加屏幕日志。在关键节点用Print String输出信息，比如抓取检测的结果、传送落点的坐标。VR Preview模式下，屏幕日志会显示在编辑器窗口里，你能一边看头显一边看日志。
第三，用Draw Debug系列节点。Draw Debug Line画射线，Draw Debug Sphere画检测球，Draw Debug Box画碰撞盒。这些在VR Preview里都能看到，非常直观。注意发布版本里要关掉，否则有性能开销。
第四，录屏回放。UE4的Sequence Recorder可以录制VR里的操作，回放时能逐帧检查。这个功能在排查偶发bug时特别有用。
提示：VR Preview模式下，编辑器的帧率会影响头显的帧率。如果你的编辑器卡，头显也会卡。调试时把编辑器窗口最小化，能提升不少。
6. 从Demo到可用：一些让交互更“跟手”的细节调校
6.1 手柄位置预测与延迟补偿
VR交互的“跟手”程度，很大程度上取决于手柄位置的延迟。从手柄移动，到头显里看到手部模型移动，中间有大约20-40ms的延迟。这个延迟来自追踪、渲染、显示多个环节。
UE4里有一个Motion Controller Late Update选项，在MotionController组件的细节面板里。开启后，手柄的位置更新会放在渲染线程的最后，能减少几毫秒的延迟。我实测下来，开启后手感有明显提升。
另一个技巧是位置预测。根据手柄前一帧的速度，预测下一帧的位置，提前渲染。UE4没有内置这个功能，但你可以手动实现：记录手柄前两帧的位置，算速度，然后Set Relative Location时加上速度乘以预测时间。预测时间设10-15ms比较合适，太长会过冲。
6.2 抓取物体的质量感与阻尼设置
抓取一个铁球和抓取一个纸杯，手感应该不一样。UE4里通过物理材质（Physical Material）和质量（Mass）来区分。
铁球的质量设5-10kg，纸杯设0.1-0.5kg。抓取时，如果物体质量大，手柄的跟随速度要慢一点，模拟“重”的感觉。具体做法是在插值跟随的Lerp节点里，根据物体质量动态调整Alpha。质量越大，Alpha越小，跟随越慢。
阻尼（Damping）也很重要。物理约束的Linear Damping和Angular Damping设0.5-2.0之间，能减少抖动。但阻尼太大会让物体变得“粘滞”，失去物理感。我一般从1.0开始调，根据物体类型微调。
6.3 交互提示的克制使用
最后说一个设计层面的经验：交互提示要克制。很多VR项目喜欢在可抓取物体上一直显示高亮或图标，结果整个场景都是发光的东西，玩家反而不知道看哪里。
我的做法是只在手柄靠近时才显示提示。具体是球体扫描检测到物体后，才开启物体的Custom Depth描边。手柄离开，描边消失。这样场景平时是干净的，玩家探索时才有反馈。
UI提示也一样。不要一进场景就弹一堆文字说明，让玩家自己摸索。实在需要引导，用环境叙事代替文字——比如把可交互的物体放在显眼位置，用灯光引导视线，比弹窗有效得多。
室内VR交互这个方向，技术门槛其实不高，难的是细节的打磨。同样的抓取功能，插值速度差5，手感就差很多；同样的传送，抛物线速度差200，体验就完全不同。这些参数没有标准答案，只能根据你的场景和用户反馈慢慢调。我上面给的数值都是起点，不是终点。多戴头显，多让不同的人试，比看任何教程都管用。
