用途:用于构建或审查基于 C/C++ 与 OpenXR 的原生 Meta Quest / Horizon OS 应用,聚焦应用与系统之间的接缝问题,如清单合规、loader 版本、焦点丢失后的帧循环等。
主要能力:说明开发与发布两套 Android 清单的差异;给出 SDK 级别建议(minSdk 32、targetSdk 34、compileSdk 不低于 targetSdk);说明使用 Khronos 的 openxr_loader_for_android,低于 1.0.34 会崩溃;涉及 XR_KHR_loader_init_android 与 XR_KHR_android_create_instance 扩展;给出通过评审的帧循环要点,如 xrPollEvent 驱动状态机、xrWaitFrame → xrBeginFrame → 渲染 → xrEndFrame 并在预测显示时间摆位、焦点感知、枚举交换链格式、显式色彩空间、仅 64 位、APK 与 OBB 大小限制;强调按能力而非设备型号判断。
使用方式:通过 metavr docs search 等命令核验 API 与清单元素,文档页有 Markdown 版本,先阅读 Khronos hello_xr 与 Meta OpenXR SDK 示例(如 XrPassthrough、XrSceneModel)再自行编写扩展。
适用场景与限制:面向原生 OpenXR 路线,不适用于 Unity、Unreal、Kotlin/Spatial SDK、WebXR 等;发布清单要求在评审时强制,开发清单可侧载但可能无法过审。具体版本与 API 事实需以官方文档为准。