SuperAPI AI 工具集

hz-unity-meta-core-sdk

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:Meta XR Core SDK(包名 com.meta.xr.sdk.core)是开发面向 Meta VR 设备的 VR/MR 应用的 Unity 基础包,提供核心 XR 相机装置、设备管理、输入处理,以及透视、手部追踪、空间锚点、场景理解等平台功能。

主要能力:OVRCameraRig 是替代 Unity 主相机的 XR 装置预制体,提供双眼立体渲染、头部与位置追踪,以及眼部和手/手柄锚点;OVRManager 是挂在 OVRCameraRig 上的单例,管理目标设备、性能与画质、追踪原点、显示、Quest 特性(手部追踪、透视、键盘、焦点感知等)与混合现实捕捉;OVRInput 提供手柄按键、扳机、摇杆与追踪的统一 API;OVROverlay 通过合成器图层渲染更清晰的文字、UI 和视频;OVRPassthroughLayer 启用透视;OVRSpatialAnchor 提供世界锁定锚点;OVRBoundary 访问 Guardian 边界;OVRProjectSetup 是项目配置检查工具。

使用方式:可通过 unity-cli 驱动实时 Editor 运行 Editor-only C# 脚本,例如 unity status --format json 查看状态,unity command run_script --project-path <proj> --file AgentScripts/Setup.cs --entry Setup.Run --format json 执行脚本;脚本应放在 Assets/ 之外。修改 OVRProjectConfig 或 OVRManager 特性后必须调用 GenerateOrUpdateAndroidManifest() 并验证,不要直接编辑 AndroidManifest.xml。修改序列化字段应使用 SerializedObject + FindProperty + ApplyModifiedProperties,而非反射,随后 MarkSceneDirty、SaveScene、SaveAssets 并回读确认。

适用场景:搭建 VR/MR 项目、配置 OVRManager、添加 OVRCameraRig、启用透视/手部追踪/空间锚点/场景 API/无边界模式、使用合成器图层与手柄输入,以及通过 Project Setup Tool 检查并修复项目配置。

限制:资料未提供收费、价格、平台支持范围或效果数据;部分异步操作在脚本返回后才完成,需另起一次运行验证,且不应在主线程 Task.Wait()。具体 API 细节建议查阅官方 Meta 开发者文档。