Unity Meta Quest 一体机开发（六）：HandGrabInteractor 和 HandGrabInteractable 知识点

此教程相关的详细教案，文档，思维导图和工程文件会放入 Seed XR 社区。这是一个高质量知识星球 XR 社区，博主目前在内担任 XR 开发的讲师。此外，该社区提供教程答疑、及时交流、进阶教程、外包、行业动态等服务。

知识星球链接：Seed XR 高级社区

---

教程说明

这篇教程将会详细介绍 Meta XR SDK 中 HandGrabInteractor 和 HandGrabInteractable 的相关知识点。

系列教程专栏：https://blog.csdn.net/qq_46044366/category_12118293.html

配套的视频链接：
【2023 VR+MR全硬件开发教程】六、HandGrab-HandGrabInteractor知识点（主讲：YY）

【2023 VR+MR全硬件开发教程】六-2、HandGrabInteractable知识点（主讲：YY）

​电脑操作系统：Windows 11

使用的 VR 设备：Meta Quest 3（Quest 系列都适用）

使用的 Unity 版本：2021.3.5 LTS (这里推荐使用 2021 及以上的 LTS 版本)

Meta XR SDK 版本：v57

官方文档：https://developer.oculus.com/documentation/unity/unity-gs-overview/

HandGrab：https://developer.oculus.com/documentation/unity/unity-isdk-hand-grab-interaction/

---

HandGrabInteractor

我们可以找到 Oculus Integration 官方提供的 Hand Grab 示例场景，在 Assets/Oculus/Interaction/Samples/Scenes/Examples 文件夹下的 Hand Grab Examples 场景：

找到 OVRCameraRig 玩家物体，左右手的 HandGrabInteractor 物体在如下图所示的位置：

HandGrabInteractor 物体上挂载了 HandGrabInteractor 脚本：

然后我们展开 HandGrabInteractor 物体，接下来我会讲解它身上这些子物体的作用：

⭐HandGrabAPI

检测 Hand Grab 是否选中或者取消选中可抓取物体，也就是检测抓取动作是否发生。

⭐HandWristPoint

控制在抓取的时候虚拟手部和现实手部在位置和旋转角度上的偏移。

⭐GripPoint

Palm Grab 的探测范围（下图中手掌处的球形范围）,调整 GripPoint 上的 HandWristOffset 脚本参数可以修改探测范围的位置和旋转角度。物体进入探测范围后触发抓取，就会被吸到手上。

探测范围为 GripPoint 子物体 Collider 的碰撞体范围。

⭐PinchPoint

Pinch Grab 的探测范围，范围大小取决于 PinchPoint 子物体的 Collider 的碰撞体大小。

⭐PinchArea

PinchPoint 的 HandPinchOffset 脚本默认引用了 PinchArea 的碰撞体，PinchArea 碰撞体的位置会影响 PinchPoint 探测范围的位置。

PinchArea 碰撞体范围如下图所示。

注：是否能激活 Pinch Grab 实际上看的是物体是否进入到 PinchPoint 的球形检测范围内，而不是看物体是否进入到 PinchArea 范围内。

⭐HandGrabVisual

连接 SyntheticHand，在手部呈现出完整的抓取手势后固定手部姿态，让抓取手势不与物体穿模。

⭐HandGrabGlow

控制抓取时手部的特效。

Glow Type
Outline：手指轮廓高亮。

Fill：手指颜色填充。

Both：结合了 Outline 和 Fill

---

HandGrabInteractable

在 Hand Grab Examples 场景中找到可抓取的物体，每一个物体上有一到多个 HandGrabInteractable 子物体。

每一个 HandGrabInteractable 物体上挂载了一个 Hand Grab Interactable 脚本：

接下来，我来介绍一下脚本上的一些重要参数。

⭐Support Grab Type

用 Hand Grab 当中的哪一种方式去抓取。

⭐Pinch Grab Rules 和 Palm Grab Rules

定义了Pinch Grab 和 Palm Grab 的触发需要用到哪几根手指。每一根手指有三个选项可以选择：Required，Optional，Ignored

被标记了 Required 的手指必须参与到抓取的触发过程中，也就是说如果我想要抓起一个物体，必须要用到标记了 Required 的手指。比如说五根手指中食指被标记了 Required，那么抓取的时候必须要用到食指，如果只用大拇指和中指是抓不起来的。

如果没有手指被标记了 Required，那么想要抓起一个物体，至少要用到一个标记了 Optional 的手指。

标记了 Ignored 的手指不会被考虑到抓取的触发过程中。

⭐Unselect Mode

决定了抓取了一个物体后什么时候会视为取消抓取。

如果选了All Released，当所有标记了 Required 或者 Optional 的手指松开后，视为取消抓取。

如果选了Any Released，只要有一个标记了 Required 的手指松开后，就会视为取消抓取。

⭐Hand Alignment

决定了在抓取的过程中，虚拟的手是如何变化到对应的抓取手势的。

Align On Grab：在抓取的时候会自动调整手部的姿态。

Attract On Hover：手在靠近物体，进入到 Hover 状态后，仿佛会卡住，然后做出抓取的动作，虚拟手就会变化到对应的抓取手势。

Align Fingers On Hover：在进入到 Hover 状态后开始抓取，手指就会逐渐变化到对应的抓取姿态。这个方式需要和 Align On Grab 进行比较会比较直观，如果选了 Align On Grab，虚拟手指在一开始会跟随现实的手进行弯曲，这个时候可能会与物体穿模，然后过一段时间后手指才会变化到抓取手势的姿态。如果选择了 Align Fingers On Hover，在手指弯曲的过程中如果接近了抓取姿态，手指就会直接被卡住，变化到对应的抓取手势，一般情况下手指是不会与物体穿模。

⭐Scaled Hand Grab Poses

因为我们每个人的手部大小可能是不同的，设置Scaled Hand Grab Poses就可以为不同大小的手配备相应大小的抓取手势。

⭐Movement Provider

在 HandGrabInteractable 脚本的 Optionals 下，有一个 Movement Provider 参数，如果没有赋值，在程序运行后会在改该物体上自动添加上一个 MoveTowardsTargetProvider 脚本，然后给 Movement Provider 参数赋值。

注：如果我们手动添加了 Movement Provider 类型的脚本，要手动给 Movement Provider 参数赋值。

这里介绍一下常用的几种的 Movement Provider：

MoveTowardsTargetProvider

控制物体吸向手部的速度。

Travel Speed 越大，物体吸向手部所花的时间越多。

MoveFromTargetProvider

抓取物体的时候，手部主动吸向物体，而不是物体吸向手部。

FollowTargetProvider

让物体被抓取的时候吸向手部，但是带有阻尼衰减运动。也就是物体吸到手上时还会不停地晃，然后慢慢恢复正常状态。Speed 越小，阻尼效果越明显。