UE 4.27中XR_FB_passthrough OpenXR扩展的安装及实现问题

核心问题拆解与解决步骤 #

你遇到的问题本质是对OpenXR扩展函数调用机制的误解，加上插件/SDK版本匹配可能存在问题，下面是具体的解决方法：

• 动态获取扩展函数指针，而非依赖静态链接
  OpenXR的扩展函数（包括xrCreatePassthroughFB）默认不会提供静态链接的实现——哪怕openxr.h里有函数原型，也必须通过xrGetInstanceProcAddr动态获取地址才能调用，这和XR_EXTENSION_PROTOTYPES是否定义无关。操作步骤：

  1. 创建OpenXR Instance时，务必将XR_FB_passthrough添加到启用的扩展列表中；
  2. 实例创建成功后，执行以下代码获取函数指针：

     PFN_xrCreatePassthroughFB xrCreatePassthroughFB = NULL;
     XrResult result = xrGetInstanceProcAddr(your_instance_handle, "xrCreatePassthroughFB", (PFN_xrVoidFunction*)&xrCreatePassthroughFB);
     if (XR_FAILED(result) || !xrCreatePassthroughFB) {
         // 此处处理函数获取失败的逻辑，比如提示设备不支持该扩展
     }
     

  之后通过这个指针调用函数即可。

• 不存在独立的无依赖头文件
  Meta OpenXR SDK没有单独提供无需XR_EXTENSION_PROTOTYPES就能直接使用的扩展头文件，这是OpenXR的设计规范——强制用动态获取的方式避免静态链接带来的兼容性问题。如果不想定义XR_EXTENSION_PROTOTYPES，要么自己声明函数指针类型，要么就用上面的动态获取方式。

• 检查插件与SDK版本匹配度
  确认你使用的Oculus OpenXR插件和Meta OpenXR SDK版本是对应的，旧版本可能未完整支持XR_FB_passthrough扩展。建议升级到v1.0.20及以上版本的Meta OpenXR SDK，同时将对应的引擎插件（Unity/Unreal）也更新到最新版。

• 先验证扩展是否被设备支持
  在创建Instance前，先枚举设备支持的扩展，确认XR_FB_passthrough是否可用：

  uint32_t ext_count = 0;
  xrEnumerateInstanceExtensionProperties(NULL, 0, &ext_count, NULL);
  XrExtensionProperties* exts = malloc(ext_count * sizeof(XrExtensionProperties));
  xrEnumerateInstanceExtensionProperties(NULL, ext_count, &ext_count, exts);
  
  bool is_passthrough_supported = false;
  for (uint32_t i = 0; i < ext_count; i++) {
      if (strcmp(exts[i].extensionName, XR_FB_passthrough_EXTENSION_NAME) == 0) {
          is_passthrough_supported = true;
          break;
      }
  }
  free(exts);
  

内容的提问来源于stack exchange，提问作者Louie