Unity XR-XR Interaction Toolkit开发使用方法（十三）组件介绍（XR Grab Interactable）

目录

一、插件介绍

二、主要组件

XR Interaction Manager

XR Controller

XR Interactor

XR Direct Interactor

XR Ray Interactor

XR Socket Interactor

XR Gaze Interactor

XR Interaction Group

XR Interactable

XR Simple Interactable

三、XR Grab Interactable

1、组件介绍

2、核心功能与特点

物理驱动的抓取

投掷与惯性模拟

多交互器协同

抓取条件过滤

事件与反馈

3、组件配置详解

交互属性表

凝视交互属性表

运动控制属性表

跟踪参数表

抛出与附加属性表

高级配置表

4、事件系统与脚本交互

1. 抓取时播放音效

2. 抓取后锁定物体旋转

5、与其他组件的协作

与 Rigidbody 的集成

与 XR Interaction Group 的协同

与 XR Socket Interactor 的联动

6、实际应用场景

场景1：物理抓取与投掷

场景2：双手协同操作

场景3：可破坏物体

7、高级用法与优化

自定义抓取条件

动态调整抓取参数

抓取动画与特效

8、常见问题与解决

问题：抓取后物体抖动

问题：投掷力度不足

问题：多抓取时物体偏移

一、插件介绍

Unity XR-XR Interaction Toolkit开发使用方法（一）-CSDN博客

Unity XR-XR Interaction Toolkit开发使用方法（二）Hisense XR-V3 Pro SDK接入-CSDN博客

二、主要组件

XR Interaction Manager

XR Controller

XR Interactor

XR Direct Interactor

Unity XR-XR Interaction Toolkit开发使用方法（六）组件配置（XR Direct Interactor）-CSDN博客

XR Ray Interactor

XR Socket Interactor

Unity XR-XR Interaction Toolkit开发使用方法（八）组件介绍（XR Socket Interactor）-CSDN博客

XR Gaze Interactor

Unity XR-XR Interaction Toolkit开发使用方法（九）组件介绍（XR Gaze Interactor）-CSDN博客

XR Interaction Group

XR Interactable

Unity XR-XR Interaction Toolkit开发使用方法（十一）组件介绍（XR Interactable）-CSDN博客

XR Simple Interactable

Unity XR-XR Interaction Toolkit开发使用方法（十二）组件介绍（XR Simple Interactable）-CSDN博客

三、XR Grab Interactable

1、组件介绍

Unity XR Grab Interactable 是 XR Interaction Toolkit 中用于实现 物理抓取与投掷交互 的核心组件，专为需要模拟真实抓取、投掷、旋转等行为的场景设计（如抓取杯子、抛掷飞盘、双手操作物体）。它在 XR Interactable 的基础上扩展了物理交互能力，是构建沉浸式抓取体验的核心工具。

可交互组件，提供基础抓取功能。当该组件被交互器选中（抓取）时，将跟随其移动，并在释放时继承其速度。

2、核心功能与特点

物理驱动的抓取

1. 支持 运动学抓取（Kinematic） 和 物理力抓取（Velocity Tracking） 两种模式，适应不同物理模拟需求。
2. 抓取时自动将物体绑定到交互器的 Attach Transform，确保位置对齐。

投掷与惯性模拟

1. 释放物体时，根据交互器的运动速度施加线速度和角速度，模拟真实投掷效果。
2. 可配置速度缩放比例（Velocity Scale 和 Angular Velocity Scale）。

多交互器协同

1. 支持 双手抓取（需启用 Allow Multiple Selection），允许多个交互器共同控制同一物体（如双手调整物体旋转）。

抓取条件过滤

1. 通过 标签（Tag）、脚本接口（IXRSelectFilter） 或 自定义逻辑 限制可抓取的交互器类型。

事件与反馈

1. 提供 OnSelectEntered、OnSelectExited 等事件，支持抓取/释放时的音效、粒子特效等反馈。

3、组件配置详解

交互属性表

凝视交互属性表

运动控制属性表

跟踪参数表

抛出与附加属性表

高级配置表

4、事件系统与脚本交互

XR Grab Interactable 的事件可通过 Unity Event 或 脚本动态监听 实现。以下是典型用法：

1. 抓取时播放音效

using UnityEngine;
using UnityEngine.XR.Interaction.Toolkit;

public class GrabFeedback : MonoBehaviour
{
    public AudioClip grabSound;
    private XRGrabInteractable grabInteractable;

    void Start()
    {
        grabInteractable = GetComponent<XRGrabInteractable>();
        grabInteractable.onSelectEntered.AddListener(PlayGrabSound);
    }

    private void PlayGrabSound(XRBaseInteractor interactor)
    {
        AudioSource.PlayClipAtPoint(grabSound, transform.position);
    }
}

2. 抓取后锁定物体旋转

grabInteractable.onSelectEntered.AddListener(interactor => 
{
    Rigidbody rb = grabInteractable.GetComponent<Rigidbody>();
    rb.constraints = RigidbodyConstraints.FreezeRotation;
});

5、与其他组件的协作

与 Rigidbody 的集成

1. 若使用 Velocity Tracking 模式，物体必须附加 Rigidbody 组件。
2. 调整 Rigidbody 的 Mass、Drag 参数优化运动效果。

与 XR Interaction Group 的协同

1. 使用 XR Interaction Group 管理多个抓取交互器的优先级（如双手抓取时动态分配控制权重）。

与 XR Socket Interactor 的联动

1. 物体被抓取后，可插入 XR Socket Interactor 插槽（如钥匙归位）。

6、实际应用场景

场景1：物理抓取与投掷

1. 为物体添加 XRGrabInteractable 和 Rigidbody。
2. 设置 Movement Type 为 Velocity Tracking，调整 Velocity Scale 为 1.5（增强投掷力度）。
3. 监听 OnSelectExited 事件，根据手柄速度赋予物体动能。

场景2：双手协同操作

1. 启用 Allow Multiple Selection。
2. 双手抓取物体时，计算两交互器的平均位置和旋转，动态更新物体姿态：

void Update()
{
    if (grabInteractable.interactorsSelecting.Count == 2)
    {
        Vector3 avgPos = (interactor1.attachTransform.position + interactor2.attachTransform.position) / 2;
        Quaternion avgRot = Quaternion.Lerp(interactor1.attachTransform.rotation, interactor2.attachTransform.rotation, 0.5f);
        transform.position = avgPos;
        transform.rotation = avgRot;
    }
}

场景3：可破坏物体

1. 监听 OnSelectEntered 事件，检测抓取力度：

public float breakForce = 10.0f;

private void OnGrab(XRBaseInteractor interactor)
{
    float grabSpeed = interactor.GetVelocity().magnitude;
    if (grabSpeed > breakForce)
    {
        Destroy(gameObject); // 物体被抓碎
    }
}

7、高级用法与优化

自定义抓取条件

1. 继承 XRGrabInteractable，重写 IsSelectableBy 方法：

public class CustomGrab : XRGrabInteractable
{
    public string requiredTag = "PlayerHand";

    public override bool IsSelectableBy(IXRSelectInteractor interactor)
    {
        return interactor.CompareTag(requiredTag) && base.IsSelectableBy(interactor);
    }
}

动态调整抓取参数

1. 根据物体状态（如被浸泡在水中）修改物理属性：

void Update()
{
    if (isUnderwater)
    {
        GetComponent<Rigidbody>().drag = 5.0f; // 增加阻力
        velocityScale = 0.5f; // 降低投掷速度
    }
}

抓取动画与特效

1. 使用 OnSelectEntered 触发抓取动画（如手柄振动、物体高亮）。
2. 结合 Particle System 实现抓取/释放时的粒子特效。

8、常见问题与解决

问题：抓取后物体抖动

解决：

• 启用 Rigidbody 的插值（Interpolate）。
• 降低 Velocity Tracking 的平滑时间。

问题：投掷力度不足

调整：

• 增加 Velocity Scale 或检查手柄速度计算逻辑。

问题：多抓取时物体偏移

优化：

• 调整 Attach Ease In Time 或手动计算双手平均位置。