iOS Object Capture API集成问题：代码拆分与实现指引

一、基础配置先行 #

• 确保项目目标版本为iOS 16.0+/macOS 13.0+，Object Capture仅支持该版本以上
• 在Info.plist添加权限：iOS需配置NSCameraUsageDescription和NSPhotoLibraryUsageDescription；macOS需配置Camera和Photos权限
• 导入必需框架：

  import ARKit
  import RealityKit
  import ObjectCapture
  import SwiftUI
  

二、逐个修复报错 #

1. ObjectCaptureSession不在作用域 #

该类是Object Capture框架核心，需确认已正确导入框架，并将其封装在ViewModel中管理（避免直接在View层写逻辑）。

2. getDocumentsDir()未定义 #

这是自定义的沙盒Documents目录获取方法，自行实现：

func getDocumentsDir() -> URL {
    FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
}

3. ReconstructionProgressView找不到 #

这是WWDC教程中的自定义SwiftUI视图，自行创建进度展示组件：

struct ReconstructionProgressView: View {
    let progress: Double
    let status: String
    
    var body: some View {
        VStack(spacing: 16) {
            Text(status)
                .font(.headline)
            ProgressView(value: progress)
                .progressViewStyle(.linear)
                .padding()
        }
        .background(.white)
        .cornerRadius(12)
        .shadow(radius: 8)
    }
}

三、代码拆分与类创建（MVVM结构） #

1. 核心逻辑层：ObjectCaptureViewModel #

负责管理会话、处理重建流程、进度回调：

class ObjectCaptureViewModel: ObservableObject {
    @Published var isReconstructing = false
    @Published var progress: Double = 0.0
    @Published var statusMessage: String = "准备重建"
    @Published var usdzFileURL: URL?
    
    private var captureSession: ObjectCaptureSession?
    
    // 启动重建（传入从相机/相册获取的图片数组）
    func startReconstruction(with images: [UIImage]) async {
        isReconstructing = true
        progress = 0.0
        statusMessage = "初始化会话..."
        
        do {
            // 初始化会话
            captureSession = try ObjectCaptureSession()
            captureSession?.delegate = self
            
            // 将UIImage转为ObjectCapture可识别的输入格式
            let inputImages = try await images.map { image in
                let tempURL = getDocumentsDir().appendingPathComponent("\(UUID().uuidString).jpg")
                try image.jpegData(compressionQuality: 0.8)?.write(to: tempURL)
                return ObjectCaptureInput.image(tempURL)
            }
            
            // 设置USDZ输出路径
            let outputURL = getDocumentsDir().appendingPathComponent("captured_object.usdz")
            
            // 开始重建
            statusMessage = "正在生成3D模型..."
            try await captureSession?.reconstruct(
                input: .images(inputImages),
                outputURL: outputURL,
                configuration: ObjectCaptureSession.Configuration()
            )
            
            usdzFileURL = outputURL
            statusMessage = "重建完成！"
        } catch {
            statusMessage = "重建失败：\(error.localizedDescription)"
        }
        
        isReconstructing = false
    }
}

// 实现代理监听进度与状态变化
extension ObjectCaptureViewModel: ObjectCaptureSessionDelegate {
    func objectCaptureSession(_ session: ObjectCaptureSession, didUpdateProgress progress: Double) {
        DispatchQueue.main.async {
            self.progress = progress
        }
    }
    
    func objectCaptureSession(_ session: ObjectCaptureSession, didChangeState state: ObjectCaptureSession.State) {
        DispatchQueue.main.async {
            switch state {
            case .preparing: self.statusMessage = "准备中..."
            case .processing: self.statusMessage = "处理中..."
            case .complete: self.statusMessage = "完成！"
            case .failed: self.statusMessage = "重建失败"
            default: break
            }
        }
    }
}

2. UI展示层：ObjectCaptureView #

负责交互触发、进度展示、结果预览：

struct ObjectCaptureView: View {
    @StateObject private var viewModel = ObjectCaptureViewModel()
    @State private var selectedImages: [UIImage] = []
    
    var body: some View {
        NavigationStack {
            VStack(spacing: 24) {
                // 选择图片按钮（需自行集成图片选择器逻辑）
                Button("选择拍摄的物体图片") {
                    // 这里接入UIImagePickerController或相册选择器，将选中图片存入selectedImages
                }
                .buttonStyle(.borderedProminent)
                
                // 启动重建按钮
                Button("生成USDZ模型") {
                    guard !selectedImages.isEmpty else {
                        viewModel.statusMessage = "请先选择图片"
                        return
                    }
                    Task {
                        await viewModel.startReconstruction(with: selectedImages)
                    }
                }
                .buttonStyle(.borderedProminent)
                .disabled(viewModel.isReconstructing)
                
                // 进度弹窗
                if viewModel.isReconstructing {
                    ReconstructionProgressView(
                        progress: viewModel.progress,
                        status: viewModel.statusMessage
                    )
                }
                
                // 结果展示
                if let usdzURL = viewModel.usdzFileURL {
                    Text("USDZ已保存：\(usdzURL.lastPathComponent)")
                        .font(.subheadline)
                        .foregroundColor(.green)
                    
                    // 可选：预览3D模型
                    Model3D(url: usdzURL)
                        .frame(height: 300)
                }
            }
            .padding()
            .navigationTitle("Object Capture 工具")
        }
    }
}

四、关键实现细节 #

• 图片要求：需围绕物体拍摄20-30张多角度清晰照片，光照均匀，避免反光、模糊或遮挡
• 配置调整：可通过ObjectCaptureSession.Configuration开启isObjectMaskingEnabled自动去除背景
• 错误处理：需覆盖图片写入失败、会话初始化失败、重建中断等场景
• 权限校验：确保用户授权相机和相册访问权限，否则无法获取重建所需图片

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