macOS下如何正确导出SceneKit场景 解决dae/obj导出异常问题

导出的DAE/OBJ在第三方软件中显示错乱，和格式本身对基础网格的支持度无关，核心是两个实现问题：

• 代码中5个球体复用了同一个SCNSphere几何体实例，SceneKit默认导出逻辑只会存储一份网格数据，其余4个节点以实例引用的方式关联该网格，Cheetah3D等第三方软件对Collada标准下的实例节点位置变换解析存在兼容缺陷，无法识别每个实例的独立坐标，最终出现网格重叠、变形的问题。
• 导出时传入options: nil调用了默认导出配置，该配置是为SceneKit内部场景复用设计的，不会烘焙节点变换、也不会做坐标系适配：SceneKit默认采用Z轴向上的坐标系，而绝大多数通用3D软件采用Y轴向上的坐标系，坐标系不匹配会进一步加剧位置错乱。

第一步：避免几何体共享引用 #

创建节点时为每个节点分配独立的几何体实例，不要让多个节点复用同一个几何体对象，修改场景创建代码如下：

var x: CGFloat = 0
for i in 0...4 {
    // 为每个球体创建独立的几何体副本，避免导出时生成跨节点实例引用
    guard let sphereGeometry = SCNSphere(radius: 1).copy() as? SCNGeometry else { continue }
    let sphere = SCNNode(geometry: sphereGeometry)
    sphere.name = "sphere\(i+1)"
    sphere.position = SCNVector3(x: x, y: 0, z: 0)
    exportScene.rootNode.addChildNode(sphere)
    x += 2
}

第二步：配置兼容性导出参数 #

不要使用默认nil配置导出，传入符合通用3D格式标准的导出选项，修改导出代码如下：

let url = URL(fileURLWithPath: pathName)
// 导出选项配置，优先适配第三方软件的解析规则
let exportOptions: [SCNSceneExportOptionKey: Any] = [
    .flattenScene: true, // 烘焙所有节点的位置、旋转、缩放变换到网格数据，避免实例变换解析失败
    .convertToYUp: true, // 转换为Y轴向上的通用3D坐标系，解决坐标系不匹配的偏移问题
    .strictConformance: true // 严格遵循对应文件格式的官方标准，不写入SceneKit私有扩展字段
]
exportScene.write(to: url, options: exportOptions, delegate: nil) { totalProgress, error, stop in
    if let error = error {
        print("导出失败：\(error.localizedDescription)")
        stop.pointee = true
        return
    }
    print("导出进度：\(totalProgress * 100.0)%")
}

兜底方案：预扁平化场景 #

如果上述操作后仍有兼容问题，可以在导出前先将整个场景烘焙为单层级静态网格，彻底消除实例引用、层级变换带来的解析问题：

// 将原场景根节点做扁平化克隆，所有变换会直接烘焙到网格数据
let flattenedRoot = exportScene.rootNode.flattenedClone()
let exportReadyScene = SCNScene()
exportReadyScene.rootNode.addChildNode(flattenedRoot)
// 用exportReadyScene替换原来的exportScene执行导出操作即可

笼统的“DAE不支持SceneKit所有特性”的说法没有实际参考价值，导出时明确不支持的内容如下：

• 非几何类数据完全不会被导出：包括物理体、碰撞体、粒子系统、行为约束、自定义着色器（SCNProgram、Shader Modifier）、灯光/相机的SceneKit专有参数
• OBJ格式本身不支持场景层级、骨骼动画、材质多通道纹理以外的复杂参数，需要导出动画、节点层级时不要选择OBJ格式
• 未正确填充索引缓冲的自定义程序化几何体、未烘焙权重的蒙皮网格，导出后会出现变形、丢失问题

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