SceneKit报错'AuthoringPass is not linked...'解决攻略

2025-02-27 22:35:26

SceneKit 报错 "Pass AuthoringPass is not linked..." 怎么破？

碰到烦人的 [SceneKit] Error: Pass AuthoringPass is not linked to the rendering graph and will be ignored check it's input/output 报错了？别慌，咱们来捋捋。

这个错误，看着挺吓人，实际上一般跟你用的 Xcode 版本、iOS 版本和 SceneKit 的某些调试选项有关。尤其是在使用 ARSCNDebugOptions.showBoundingBoxes 的时候容易出现。

一、为什么会这样？

简单说，就是 SceneKit 渲染流程里，AuthoringPass 这个环节没接上。

更具体点呢，AuthoringPass 通常和 SceneKit 编辑器（或者说某些特殊的渲染通道）相关联。当你在调试时，启用了某些调试选项 (比如 showBoundingBoxes)，SceneKit 会尝试去做一些额外的渲染处理，把 bounding box 画出来。但如果当前的渲染管线（rendering graph）没配置好，让 AuthoringPass 能正常工作，那就会报这个错。

Xcode beta 版本，或者 iOS beta 版本，常常会有一些渲染方面的新特性、Bug，导致这种不兼容问题发生。

二、几种搞定办法

1. 换个姿势，别用 `showBoundingBoxes`

这是最直接的办法。既然这个选项会报错，咱们就不用它嘛！

原理： 避开有问题的选项，就不会触发那个错误的渲染路径。

操作：
把 sceneView.debugOptions = [ARSCNDebugOptions.showBoundingBoxes] 这行代码注释掉，或者改成别的选项，比如：

//sceneView.debugOptions = [ARSCNDebugOptions.showBoundingBoxes] // 注释掉
 sceneView.debugOptions = [ARSCNDebugOptions.showFeaturePoints] //显示特征点
//sceneView.debugOptions = [] // 或者啥也不显示

2. 更新 Xcode/iOS (如果可以的话)

要是你用的是测试版的 Xcode 或 iOS, 很有可能新版本已经修复了这个 Bug。

原理： 苹果的工程师们也在不停地修 bug，新版本一般会更稳定。
操作：
- 检查一下有没有 Xcode 的更新。
- 要是你的设备能升级到更新的 iOS beta 版本，也可以试试。

3. 自定义 Shader (难度系数较高)

如果你对 Shader 比较熟，可以自己写一个 shader, 实现类似 bounding box 的效果。

原理: 不再依赖 SceneKit 内置的那个有问题的 AuthoringPass，而是通过自定义的 shader，去绘制 bounding box.
操作：

这个有点复杂，我大致说个思路:

1.  **获取 Node 的 Bounding Box:** 
    ```swift
    let boundingBox = node.boundingBox
    let min = boundingBox.min
    let max = boundingBox.max
    ```

2.  **创建 Bounding Box 的几何体:** 

    你可以用 `SCNBox` 创建一个立方体，大小和位置跟 bounding box 一致。

3.  **给 Bounding Box 的几何体应用 Shader:** 

你可以写一个简单的 Shader, 让它以线框模式显示，或者以你想要的颜色显示。

```swift
// 伪代码示例，你需要根据你的需求来写具体的shader代码
let material = SCNMaterial()
    material.shaderModifiers = [
        .geometry: """
        // 在这里修改顶点坐标，画线框等等...
         _geometry.position =  ... ;

    """,
        .fragment: """
         // 在这里控制颜色
          _output.color = float4(1.0, 0.0, 0.0, 1.0); // 红色
    """
    ]
 boundingBoxNode.geometry?.materials = [material]
```

添加 Bounding Box 的Node

 把刚刚做出来的 bounding box 对应的 node，加到 SceneKit 的场景里去。可以把它作为目标 Node 的子 Node。

   let boundingBoxNode = SCNNode(geometry: boundingBoxGeometry) // boundingBoxGeometry 是 SCNBox
    node.addChildNode(boundingBoxNode)

进阶：你可以通过 SCNProgram 或是 metal 文件去完成你自己的Shader。

4. 使用 Instruments 进行更深层次的调试

如果你觉得上面几种方法都不够，想要更深入地了解问题的原因，可以尝试使用 Xcode 自带的 Instruments 工具。

原理: Instruments 可以帮你分析渲染的性能、找出瓶颈，也许能提供更多关于这个错误的线索。
操作:
1. 在 Xcode 里，选择 "Product" -> "Profile"。
2. 选择 "SceneKit" 模板。
3. 运行你的应用，复现报错。
4. 观察 Instruments 收集的数据，看看能不能找到和 AuthoringPass 相关的有用信息。

5. 尝试降级 SceneKit Renderer

(这个有一定风险，谨慎使用!)
有时候，特定版本的 SceneKit Renderer 可能会出问题。如果你能确定是 Renderer 的问题，可以尝试降级。

原理： 有的时候新版本的Renderer 可能在特殊设备存在bug，你可以换回旧的Renderer版本
操作:
你可以去修改Metal API 版本的配置来改变渲染的方式。但这个属于较深度的操作，对你有较高技术水平的要求. 请详细查阅 Metal 相关的配置文档。

6. 在真机调试时关闭Metal API验证(如果允许的话)

原理: 某些时候Metal的严格的API验证机制, 可能会使渲染出现意外的情况。
操作：

在你的工程中，TARGETS -> Build Settings, 找到 "Metal API Validation"选项，把它设置为 Disabled.
如果你在使用 Scheme, 找到 Run-> Options-> Metal API Validation, 取消选中。
- 额外安全提示： 在最终发布的时候, 一定, 一定 ，要打开 Metal API Validation，以确保应用的稳定性和安全性。