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

Unity XR Gaze Interactor 是 XR Interaction Toolkit 中用于实现 基于视线（凝视）交互 的核心组件，允许用户通过头戴设备的注视方向与虚拟对象或 UI 元素交互。它无需手柄输入，仅依赖头部追踪数据，适用于轻量化交互场景（如医疗培训、无障碍应用）或作为辅助交互方式。

用于通过凝视与可交互对象交互的交互器。该组件通过实时更新的射线投射确定当前有效目标范围，仅与启用了"允许凝视交互"的XR基础可交互对象（XRI实现的XR简单可交互和XR抓取可交互）进行交互。本交互器支持在可交互对象上启用的注视辅助功能，且可交互对象具有附加属性，允许您单独为每个对象配置凝视功能的具体作用方式。

2、核心功能与特点

视线检测

从用户视角（摄像机）发射一条 不可见射线，检测视线路径上的 XR Interactable 对象或 UI 元素。
支持 注视时长阈值（Gaze Duration），防止误触（如持续注视 2 秒后触发选择）。

跨平台兼容

兼容主流 XR 设备的头部追踪（Oculus Quest、HTC Vive Focus、Windows MR 等）。
支持与手柄、手势追踪协同工作（如混合交互模式）。

事件驱动逻辑

提供 OnHoverEntered、OnSelectEntered 等事件，支持注视开始、持续、结束的回调。

无障碍设计

为运动受限用户提供无需手柄的交互方案。
可通过视线选择菜单、按钮等 UI 元素。

3、组件配置详解

属性	描述
Gaze Assistance Snap Volume	（可选）此交互器用于定位有效注视辅助目标的 `XRInteractableSnapVolume`。若未指定，将自动创建一个。
Gaze Assistance Calculation	定义此交互器如何调整注视辅助吸附区域的尺寸和比例。
Fixed Size	为注视辅助吸附区域使用固定尺寸。
Collider Size	根据命中的可交互对象的碰撞体尺寸调整注视辅助吸附区域。
Gaze Assistance Fixed Size	当计算方式为“固定尺寸”时，注视辅助吸附区域使用的固定尺寸值。
Gaze Assistance Collider Scale	应用于注视辅助吸附区域的缩放比例。
Gaze Assistance Distance Scaling	启用后，注视辅助碰撞体会根据交互器与目标可交互对象的距离动态调整缩放比例。
Clamp Distance Scaling	将注视辅助碰撞体的缩放比例限制在“距离缩放钳制值”范围内。
Distance Scaling Clamp Value	注视辅助碰撞体缩放比例的最大限制值。

4、工作原理

射线生成

每帧从摄像机位置沿注视方向发射射线。

碰撞检测

检测射线路径上的 Interactable 对象或 UI 元素。

计时验证

若用户持续注视目标超过 Gaze Time，触发 Select 事件。

事件分发

通过 XR Interaction Manager 通知目标对象执行交互逻辑。

5、事件系统与脚本交互

XR Gaze Interactor 提供以下关键事件：

事件	触发时机	典型应用
`OnHoverEntered`	视线首次落在目标上时	显示高亮、播放提示音
`OnHoverExited`	视线离开目标时	隐藏高亮、重置提示
`OnSelectEntered`	注视时间达到阈值后触发	确认选择、打开菜单
`OnSelectExited`	视线移出目标或中断注视时	取消操作、关闭弹窗

示例脚本：注视计时进度条

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

public class GazeProgress : MonoBehaviour
{
    public XRGazeInteractor gazeInteractor;
    public Image progressBar;
    private float gazeTimer;

    void Update()
    {
        if (gazeInteractor.TryGetCurrentUIRaycastResult(out RaycastResult result))
        {
            gazeTimer += Time.deltaTime;
            progressBar.fillAmount = gazeTimer / gazeInteractor.gazeTime;
            
            if (gazeTimer >= gazeInteractor.gazeTime)
            {
                // 触发选择逻辑
                gazeTimer = 0;
            }
        }
        else
        {
            gazeTimer = 0;
            progressBar.fillAmount = 0;
        }
    }
}