SwiftUI中编程修改SCNScene光照模型不生效的解决方案

修改光照模型不生效的核心逻辑错误：SCNScene的rootNode本身默认不挂载任何几何体，USDZ模型的所有网格、材质资源都分布在rootNode的多层嵌套子节点上。你直接修改scene?.rootNode.geometry?.firstMaterial?.lightingModel时，rootNode.geometry为nil，赋值操作不会作用到任何实际渲染的模型材质上。在SceneKit编辑器中如果没有选中挂载几何体的实际子节点，直接改根节点属性同样不会生效。

递归遍历全节点修改材质 #

替换原有直接修改根节点材质的逻辑，通过递归遍历根节点下所有子节点，给所有几何体的全部材质设置目标光照模型：

var scene: SCNScene? {
    guard let scene = SCNScene(named: "model.usdz") else { return nil }
    
    func applyLightingModel(to node: SCNNode) {
        // 处理当前节点的几何体材质
        if let geometry = node.geometry {
            for material in geometry.materials {
                material.lightingModel = .lambert // 可按需替换为.phong
                // 重置PBR相关参数，避免干扰传统光照模型渲染效果
                material.metalness.contents = 0.0
                material.roughness.contents = 1.0
                // 清空自定义shader修饰符，避免覆盖光照配置
                material.shaderModifiers = nil
            }
        }
        // 递归处理所有子节点
        node.childNodes.forEach { applyLightingModel(to: $0) }
    }
    
    applyLightingModel(to: scene.rootNode)
    scene.rootNode.scale = SCNVector3(scale, scale, scale)
    return scene
}

额外注意事项 #

• 不要只修改firstMaterial：单个几何体可能绑定多个材质对应不同网格区域，必须遍历geometry.materials数组下的所有材质才能全量生效。
• 自动灯光适配问题：.autoenablesDefaultLighting选项默认生成的是适配PBR光照的灯光组，使用lambert/phong传统光照模型时，建议删除该选项，手动添加环境光、方向光组合，光影表现会更符合预期。
• 导出模型预置配置问题：部分Reality Composer、第三方工具导出的USDZ会自带材质覆盖逻辑，修改材质后如果仍不生效，可以检查节点的particleSystems、constraints是否有影响渲染的配置，必要时可重新导出不带预置渲染设置的模型版本。

内容的提问来源于stack exchange，提问作者Mc.Lover