GZUCM_VRVideo 交互系统

交互系统是 GZUCM_VRVideo 项目的用户输入处理核心，基于 Unity XR Interaction Toolkit 实现抓取、悬停、选择等 VR 交互功能。

系统组成

1. GrabAttachReturn（抓取返回系统）

文件: GrabAttachReturn.cs

核心功能:

记录物体原始位置和旋转
抓取时取消动画
释放时平滑返回原位

工作流程:

物体初始化 → 记录原始位置/旋转
     ↓
抓取事件 → transform.DOKill() → 取消进行中的动画
     ↓
释放事件 → DOMove() + DORotateQuaternion() → 平滑返回原位

关键特性:

DOTween 动画: 使用 DOTween 实现平滑动画
防抖处理: 检查 args.isCanceled 防止误触
内存管理: 在 OnDestroy 中移除事件监听

2. ButtonInteraction（按钮交互系统）

文件: ButtonInteraction.cs

核心功能:

实现 IPointerEnterHandler/IPointerExitHandler 接口
控制按钮 Image 显示/隐藏
管理二级菜单显示

交互逻辑:

指针进入 → 显示按钮 Image → 显示二级菜单
     ↓
指针离开 → 隐藏按钮 Image → 隐藏二级菜单

状态管理:

检查按钮 interactable 状态
根据状态设置颜色
控制二级菜单显隐

3. CanvasController（Canvas 控制器）

文件: CanvasController.cs

核心功能:

处理 XR 选择和悬停事件
控制媒体显示
管理材质切换

XR 事件:

OnSelectEnter(): 选择物体时触发媒体显示
OnHoverEntered(): 悬停时切换到 Hover 材质
OnHoverExited(): 离开时恢复 Trigger 材质
OnSelectExited(): 选择结束时的处理

交互事件流

抓取交互

XRGrabInteractable → selectEntered → HandleGrab()
     ↓
XRGrabInteractable → selectExited → HandleRelease()
     ↓
DOTween 动画 → 平滑返回原位

悬停交互

XR Interactable → hoverEntered → OnHoverEntered()
     ↓
切换材质 → Hover_Mat → 视觉反馈
     ↓
XR Interactable → hoverExited → OnHoverExited()
     ↓
恢复材质 → Trigger_Mat → 恢复默认状态

选择交互

XR Interactable → selectEntered → OnSelectEnter()
     ↓
获取 InteractableData → 查询数据 → 显示媒体
     ↓
XR Interactable → selectExited → OnSelectExited()

关键算法

1. 抓取返回动画

private void HandleRelease(SelectExitEventArgs args)
{
    // 防抖处理
    if (args.isCanceled) return;
    
    // 平滑返回原位
    transform.DOMove(originalPosition, 1f).SetEase(Ease.OutSine);
    transform.DORotateQuaternion(originalRotation, 1f).SetEase(Ease.OutSine);
}

2. 材质切换

public void OnHoverEntered(HoverEnterEventArgs args)
{
    GameObject hoverObject = args.interactableObject.transform.gameObject;
    MeshRenderer outline = hoverObject.GetComponent<MeshRenderer>();
    outline.material = Hover_Mat;
}

public void OnHoverExited(HoverExitEventArgs args)
{
    GameObject hoverObject = args.interactableObject.transform.gameObject;
    MeshRenderer outline = hoverObject.GetComponent<MeshRenderer>();
    outline.material = Trigger_Mat;
}

3. 按钮状态管理

public void OnPointerEnter(PointerEventData eventData)
{
    if (!buttonToControl.interactable) return;
    
    if (buttonImage != null)
    {
        buttonImage.enabled = true;
    }
    
    if (secondMenuButtons != null)
    {
        secondMenuButtons.SetActive(true);
    }
}