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。
立即学习“C++免费学习笔记（深入）”；
- 调用
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；实际部署时得按设备能力分级处理。
