OpenXR跨平台关键在初始化与图形后端适配：需动态加载loader、严格校验扩展、正确设置formFactor及图形绑定结构，Vulkan渲染须用xrAcquire/xrWait/xrRelease管理swapchain图像。

OpenXR 本身是跨平台的，但 C++ 项目要真正“一次编写、多平台运行”，关键不在 OpenXR API 调用本身，而在于平台初始化、窗口/表面绑定、图形后端（Vulkan / D3D11 / D3D12 / OpenGL）适配和运行时加载——这些环节最容易卡住。

如何正确加载 OpenXR 运行时并获取 xrGetInstanceProcAddr

不能硬链接 libopenxr_loader 或直接 #include 后调用函数。OpenXR 要求先加载 loader，再通过它获取实例级函数指针。

• Windows 下优先尝试从 "openxr_loader.dll" 加载；Linux/macOS 查找 "libopenxr_loader.so" 或 "libopenxr_loader.dylib"
• 必须先调用 xrEnumerateInstanceExtensionProperties(nullptr, 0, &count, nullptr) 确认 loader 可用，否则后续全崩
• 不要自己实现 XrInstance 创建逻辑——所有平台都必须走 xrCreateInstance，且传入的 XrInstanceCreateInfo 中 enabledExtensionCount 必须与实际启用的扩展数严格一致，否则 Android 上会静默失败

为什么 xrCreateSession 在 Windows + SteamVR 下总返回 XR_ERROR_FORM_FACTOR_UNAVAILABLE

这不是 OpenXR 错误，而是会话创建前漏掉了最关键的一步：指定正确的 formFactor 和绑定对应图形 API 的 session 创建信息。

• Windows 上若用 D3D11，必须在 XrGraphicsBindingD3D11KHR 结构中填入有效的 d3dDevice 指针，并将该结构作为 next 链入 XrSessionCreateInfo
• SteamVR 默认只支持 XR_FORM_FACTOR_HEAD_MOUNTED_DISPLAY；如果误设为 XR_FORM_FACTOR_HANDHELD，就会触发该错误
• Android 上必须额外启用 XR_KHR_android_create_instance 扩展，并在 XrInstanceCreateInfoAndroidKHR 中传入 applicationVM 和 applicationActivity

如何让 Vulkan 渲染循环在不同平台复用同一套 vkQueueSubmit 逻辑

OpenXR 不接管渲染队列提交，但它强制要求你使用它提供的 XrSwapchainImageVulkanKHR 图像句柄，而不是自己创建 VkImage。

• 调用 xrEnumerateSwapchainImages 后拿到的 VkImage 句柄**不能**直接绑定 descriptor 或做 layout transition——必须先用 xrAcquireSwapchainImage 获取可用图像索引，再用 xrWaitSwapchainImage 等待就绪
• 每个平台对 swapchain 图像的初始 layout 要求不同：Quest 2 要求 VK_IMAGE_LAYOUT_UNDEFINED，而 Windows Mixed Reality 可能期望 VK_IMAGE_LAYOUT_GENERAL；必须查 XrSystemProperties.graphicsProperties 或运行时探测
• 提交命令前务必调用 xrReleaseSwapchainImage，否则下一帧 xrAcquireSwapchainImage 会阻塞或超时

XrSwapchainImageVulkanKHR* images = nullptr;
uint32_t imageCount = 0;
xrEnumerateSwapchainImages(swapchain, 0, &imageCount, nullptr);
images = new XrSwapchainImageVulkanKHR[imageCount];
for (uint32_t i = 0; i < imageCount; ++i) {
    images[i].type = XR_TYPE_SWAPCHAIN_IMAGE_VULKAN_KHR;
}
xrEnumerateSwapchainImages(swapchain, imageCount, &imageCount, (XrSwapchainImageBaseHeader*)images);
// 后续渲染中：
int64_t acquiredIndex;
xrAcquireSwapchainImage(swapchain, &acquiredIndex, nullptr);
xrWaitSwapchainImage(swapchain, nullptr);
// ... record command buffer using images[acquiredIndex].image ...
vkQueueSubmit(queue, 1, &submitInfo, fence);
xrReleaseSwapchainImage(swapchain, nullptr);

最常被忽略的是：xrWaitSwapchainImage 的 timeout 值在 Quest 上建议设为 XR_TIMEOUT_INFINITE，但在 PC 上设成无限等待可能掩盖同步 bug；实际部署时得按设备能力分级处理。