Swift AR应用中如何将生成的Mesh替换为.obj格式的自定义3D对象？

1. 准备OBJ资源并导入项目 #

• 将你的.obj模型文件和对应的.mtl材质文件（如果有）拖入Xcode项目
• 在弹出的导入窗口中，确保勾选Add to targets（对应你的AR应用target），并选择Copy items if needed

2. 加载OBJ模型到SCNNode #

方法1：使用SCNScene直接加载 #

func loadOBJModel(named name: String) -> SCNNode? {
    guard let sceneURL = Bundle.main.url(forResource: name, withExtension: "obj") else {
        print("无法找到OBJ文件")
        return nil
    }
    
    do {
        let scene = try SCNScene(url: sceneURL, options: [.checkConsistency: true])
        let modelNode = SCNNode()
        // 将场景中所有子节点添加到新节点（OBJ场景可能包含多个节点）
        scene.rootNode.childNodes.forEach { modelNode.addChildNode($0) }
        return modelNode
    } catch {
        print("加载OBJ失败：\(error.localizedDescription)")
        return nil
    }
}

方法2：使用ModelIO加载（更稳定，支持复杂模型） #

如果直接用SCNScene加载出现材质丢失或模型异常，推荐用ModelIO：

import ModelIO

func loadOBJWithModelIO(named name: String) -> SCNNode? {
    guard let url = Bundle.main.url(forResource: name, withExtension: "obj") else {
        print("OBJ文件不存在")
        return nil
    }
    
    let asset = MDLAsset(url: url)
    asset.loadTextures() // 加载关联的材质纹理
    
    guard let object = asset.object(at: 0) as? MDLMesh else {
        print("无法解析OBJ为网格")
        return nil
    }
    
    let scnGeometry = SCNGeometry(mdlMesh: object)
    let modelNode = SCNNode(geometry: scnGeometry)
    return modelNode
}

3. 替换原矩形创建代码 #

找到你原来生成矩形的代码块（通常是在处理AR锚点或触摸交互的位置），替换为加载OBJ模型的逻辑：

// 原来的矩形创建代码（示例）
// let plane = SCNPlane(width: 0.5, height: 0.5)
// let planeNode = SCNNode(geometry: plane)
// planeNode.position = desiredPosition // AR场景中的目标位置

// 替换为OBJ模型加载
if let modelNode = loadOBJModel(named: "你的模型文件名（不带.obj后缀）") {
    // 调整模型尺寸（根据你的模型实际大小，比如缩放到0.5米宽）
    modelNode.scale = SCNVector3(0.05, 0.05, 0.05) // 按需调整
    // 设置模型位置（和原来矩形的位置一致）
    modelNode.position = desiredPosition
    // 调整旋转（如果模型方向不对，比如默认是朝上，AR中可能需要绕X轴转-90度）
    modelNode.eulerAngles.x = -.pi / 2
    // 添加到AR场景
    arView.scene.rootNode.addChildNode(modelNode)
}

4. 常见问题排查 #

• 模型不显示：检查文件路径是否正确，是否勾选了target；打印模型节点的boundingBox，确认尺寸不是0
• 材质丢失/显示黑色：确保.mtl文件和纹理图片（如果有）都导入了项目，且路径正确；用ModelIO加载时记得调用loadTextures()
• 模型尺寸异常：通过modelNode.scale调整缩放比例，或者在3D建模软件中先调整模型单位为米（AR场景单位是米）
• 方向不对：通过调整eulerAngles或rotation修正模型朝向，比如AR中地面放置的模型通常需要绕X轴旋转-90度（将Z轴朝上转为Y轴朝上）

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