用途:在 Unity 中为 Meta VR / Horizon OS 场景添加交互。Core SDK 只提供头显相机装置、追踪与 OVRManager,交互层由 Interaction SDK(ISDK)负责,不应自行基于 OVRInput、射线或触发器碰撞体手写抓取,否则会偏离平台行为。
主要能力:通过 Quick Actions API 搭建交互装置并让对象可交互。OVRQuickActionsAPI.AddOVRInteractionRig() 创建完整交互装置(含手、控制器、各类交互器与视觉),必要时附带 OVRCameraRig;QuickActionsAPI 提供 AddGrabInteraction、AddDistanceGrabInteraction、AddRayGrabInteraction、AddGazeInteraction、AddTeleportInteraction、AddPokeCanvasInteraction 等,以及 AddHandInteractors、AddControllerInteractors 等交互器方法。触摸手抓、普通 poke、普通 ray 无 API,仅菜单项。
使用方式:先删除默认 Main Camera,再调用上述方法;所有方法接收 GameObject 而非组件,Canvas 调用需传 canvas.gameObject。两个 API 均为 Editor-only,可通过 unity-cli 的 run_script 运行 .cs 文件、Assets/Editor 下的 MenuItem 脚本或 Unity MCP 调用。安装 com.meta.xr.sdk.interaction.ovr(会引入 Essentials 与 Core SDK),先查 Packages/manifest.json,勿只装 com.meta.xr.sdk.interaction。安装后需重编译与域重载,不可同一脚本内安装并使用其 API。
适用场景与限制:默认 OVR 后端;跨平台仍用 ISDK 时改用 UnityXR 后端,不用 ISDK 则不适用。交互器调用仅用于手工搭建的装置,AddOVRInteractionRig() 已包含全部交互器。可交互对象无需场景中存在装置,但运行时装置须提供匹配交互器,否则静默失效。抓取调用会把 Rigidbody 设为运动学。需在 Play 模式验证,零错误零异常为准,再在真机测试。具体签名、枚举与文档查询见资料所列参考文件。