Oculus Quest 2 Passthrough录制黑屏问题排查求助

针对Unity 2022.3.8f1内置渲染管线、Meta XR Integration 57.0版本下Android平台Passthrough录制黑屏的问题，可按以下步骤排查：

• 确认运行时权限与初始化

  1. 检查AndroidManifest中是否包含com.meta.permission.PASSTHROUGH权限，可在Project Settings > Player > Publishing Settings > Custom Main Manifest中核对，若缺失需手动添加。
  2. 在代码中主动请求Passthrough权限并等待回调后启用功能，示例代码：

     void Start()
     {
         OVRPassthrough.RequestPermissions(OnPassthroughPermissionGranted);
     }
     
     void OnPassthroughPermissionGranted(bool granted)
     {
         if (granted)
         {
             OVRPassthrough.instance.EnablePassthrough();
         }
     }
     

• 核对OVR Camera Rig核心设置
  从你提供的设置截图来看，需补充检查：

  1. CenterEyeAnchor上OVRCamera组件的Clear Flags需设为Depth Only，内置管线中Passthrough依赖此设置避免画面被纯色覆盖。
  2. 确认OVR Camera Rig的Tracking Origin Mode与设备设置一致（推荐Floor或Eye Level），避免渲染偏移导致黑屏。

• 排查模拟器录制限制
  Meta XR Simulator的虚拟Passthrough在录制时存在兼容性问题，尤其是Unity内置录制或模拟器自带录制功能无法捕获Passthrough画面。建议直接在真实Android设备上测试：

  • 若设备上Passthrough正常显示，说明问题仅存在于模拟器录制环节，可使用设备自带录屏工具或第三方录屏APP捕获画面。
  • 若设备上也黑屏，继续排查后续项。

• 内置渲染管线专属配置

  1. 检查OVRPassthroughLayer组件的Render Layer设为Default，确保未被其他相机的Culling Mask排除。
  2. 在Project Settings > XR Plug-in Management > Meta > Passthrough中，确认Enable Passthrough已勾选，且Passthrough Render Mode设为Underlay（底层渲染是录制时的最优选择）。

• 版本兼容性验证
  尝试更新Meta XR Integration包至最新稳定版（如60.x系列），或回退至56.x版本，排查是否为57.0版本的特定bug导致录制异常。

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