SceneKit中SCNFloor随机不可见、阴影偶发消失问题求解

• 光照配置冲突：同时开启automaticallyUpdatesLighting、autoenablesDefaultLighting又手动添加自定义平行光，系统自动注入的动态光照节点会干扰自定义灯光的阴影投影计算，相机移动后自动光照的视锥体更新与自定义灯光的自动阴影投影调整产生时序冲突，导致阴影被意外裁剪。
• 阴影模式兼容性问题：deferred阴影模式在ARSession 30fps渲染帧率下，偶发出现深度缓冲区与实时屏幕帧缓冲的同步异常；离线快照渲染走完整渲染管线不受该同步问题影响，因此快照中阴影显示正常、实时视图不可见。
• 节点与参数配置缺陷：SCNFloor与AR对象同属一个容器子节点，未显式设置阴影投射/接收类别位，SceneKit视锥体裁剪机制在相机远离后返回时，会误判阴影投射范围不在可见区域，跳过阴影绘制；同时灯光位置过远、正交投影范围过小、阴影参数设置不合理，进一步提升了问题出现概率。

按以下步骤调整配置即可解决高概率偶现的阴影消失问题：

1. 关闭系统自动光照逻辑，仅保留自定义定向光，消除多光源冲突
2. 将阴影模式从.deferred替换为.forward，解决实时渲染的缓冲区同步问题
3. 显式设置所有节点的阴影投射/接收属性、类别位掩码，显式指定灯光的裁剪范围、级联阴影参数，避免视锥体误裁剪
4. 调整SCNFloor渲染顺序，保证深度缓冲优先写入；调整灯光位置与正交范围，提升阴影计算稳定性
5. 场景导出时增加一致性校验选项，避免节点属性在导出过程中丢失

修正后的代码 #

AR场景基础配置 #

sceneView.preferredFramesPerSecond = 60
sceneView.automaticallyUpdatesLighting = false
sceneView.autoenablesDefaultLighting = false
let configuration = ARWorldTrackingConfiguration()
configuration.isLightEstimationEnabled = false
configuration.planeDetection = .horizontal
configuration.providesAudioData = false
configuration.isAutoFocusEnabled = true
sceneView.session.run(configuration)

自定义光照配置 #

let light = SCNLight()
light.type = .directional
light.shadowColor = UIColor(white: 0, alpha: 0.6)
light.color = UIColor.white
light.castsShadow = true
light.automaticallyAdjustsShadowProjection = true
light.shadowMode = .forward
light.shadowRadius = 4
light.shadowSampleCount = 8
light.shadowCascadeCount = 2
light.orthographicScale = 10
light.zNear = 1
light.zFar = 2000
light.categoryBitMask = 1

let sunLightNode = SCNNode()
sunLightNode.position = SCNVector3(x: 10, y: 20, z: 5)
sunLightNode.look(at: SCNVector3Zero)
sunLightNode.light = light
sceneView.scene.rootNode.addChildNode(sunLightNode)

场景合并与SCNFloor配置 #

let mergedScene = SCNScene()
let nodeContainer = SCNNode()

let floor = SCNNode()
let scnFloor = SCNFloor()
scnFloor.length = 4
scnFloor.width = 4
floor.geometry = scnFloor
floor.renderingOrder = -1
floor.castsShadow = false
floor.geometry?.firstMaterial!.colorBufferWriteMask = []
floor.geometry?.firstMaterial!.readsFromDepthBuffer = true
floor.geometry?.firstMaterial!.writesToDepthBuffer = true
floor.geometry?.firstMaterial!.lightingModel = .constant
floor.categoryBitMask = 1
nodeContainer.addChildNode(floor)

for node in scene.rootNode.childNodes {
    node.castsShadow = true
    node.categoryBitMask = 1
    nodeContainer.addChildNode(node)
}

nodeContainer.position = SCNVector3Zero
nodeContainer.rotation = SCNVector4Zero
nodeContainer.scale = SCNVector3One
mergedScene.rootNode.addChildNode(nodeContainer)

if mergedScene.write(to: url, options: [.convertToYUp: true, .checkConsistency: true], delegate: nil, progressHandler: { float, error, pointer in
    if let error = error {
        completion(.error(error))
    }
})

兜底优化 #

如果极端场景下仍偶现阴影消失，可在SCNSceneRendererDelegate的renderer(_:updateAtTime:)回调中添加代码，每帧强制刷新灯光阴影视锥体：

func renderer(_ renderer: SCNSceneRenderer, updateAtTime time: TimeInterval) {
    sunLightNode.light?.orthographicScale = max(10, sunLightNode.light!.orthographicScale)
}

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