https://www.xrstudy.net/tags/pdc/Recent content in PDC on XR技术研习社Hugozh-cnTue, 15 Sep 2026 10:00:00 +0800https://www.xrstudy.net/posts/pico-pdc-renderpassindex-error/Tue, 15 Sep 2026 10:00:00 +0800https://www.xrstudy.net/posts/pico-pdc-renderpassindex-error/<p>在使用 PDC（PICO Developer Center）进行串流测试，是测试 PICO 项目的一种快捷手段。但是用过几次的开发者都知道，PICO 目前的方案依然不太稳定，时常会遇到各种意想不到的问题。其中一种高频报错会导致串流测试无法正常进行：测试时，Console 窗口会连续输出 <code>IndexOutOfRangeException:renderPassIndex</code> 报错，其堆栈指向 <code>UnityEngine.XR.XRDisplaySubsystem:GetRenderPass</code>，其症状如下图所示：</p> <p><img src="https://www.xrstudy.net/images/posts/pico-pdc-renderpassindex/01-console-error.png" alt="Console 连续输出 IndexOutOfRangeException:renderPassIndex，堆栈指向 XRDisplaySubsystem:GetRenderPass"></p> <p>此时不妨试试以下两种解决方法：</p> <h2 id="方法一测试之前确保不选中任何游戏对象尤其是-camera">方法一：测试之前确保不选中任何游戏对象（尤其是 Camera）</h2> <p><img src="https://www.xrstudy.net/images/posts/pico-pdc-renderpassindex/02-object-selected.png" alt="测试前选中了某个游戏对象"></p> <p>以上是易报错情况——测试前选中了某个游戏对象，尤其是包含了 Camera 的游戏对象。</p> <p><img src="https://www.xrstudy.net/images/posts/pico-pdc-renderpassindex/03-nothing-selected.png" alt="测试前点击 Hierarchy 窗口空白处，不选中任何对象"></p> <p>以上是不易报错情况：测试前点击 Hierarchy 窗口空白处，确保没有选中任何游戏对象，然后再进行串流测试，此时报错大概率会消失并能正常进行串流测试。</p> <p>如果执行以上操作后仍然报错，可尝试第二种方法。</p> <h2 id="方法二确保-scene-窗口和-game-窗口不同时出现">方法二：确保 Scene 窗口和 Game 窗口不同时出现</h2> <p>如果窗口布局如下图所示，Scene 和 Game 窗口同时呈现在 Unity 编辑器中，也可能引发此类报错。</p> <p><img src="https://www.xrstudy.net/images/posts/pico-pdc-renderpassindex/04-scene-game-split.png" alt="Scene 和 Game 窗口同时呈现"></p> <p>此时可尝试调整界面布局，确保 Scene 和 Game 窗口不同时呈现在编辑器中，如下图所示，将 Scene 和 Game 窗口叠放，或者选择一种不会同时出现以上两个窗口的 Layout，比如 Default 布局。</p> <p><img src="https://www.xrstudy.net/images/posts/pico-pdc-renderpassindex/05-scene-game-stacked.png" alt="Scene 和 Game 窗口叠放（Tab 方式）"></p> <p>调整以后再进行串流测试，报错随即消失，从而能够正常测试。</p> <h2 id="并不仅限于-pico-和-xr">并不仅限于 PICO 和 XR</h2> <p>从报错堆栈可以看出，异常发生在 Unity XR 显示子系统获取 Render Pass 的环节。目前更合理的推测是：当 Unity 的多个渲染视图或预览状态同时活跃时——比如 Scene 与 Game 窗口并存、选中了带预览的对象，又叠加了 PDC 串流的渲染流程——就可能触发 Unity 编辑器或 XR 显示子系统的状态同步问题，从而导致请求的 <code>renderPassIndex</code> 与当前可用的 Render Pass 数量不一致。</p>