苹果3D物体捕捉Object Capture功能实现教程

测试电脑：2021 macbook air m1

测试日期：2021-08-15

1. 将MacOS升级为 macos Monterey beta 12.0及以上

2. 下载安装 XCode 13.0 及以上

3. 下载安装物体捕捉app 到手机，下载地址

Apple Developer Documentation

3.1 下载完成后使用XCode 13.0 或及以上打开TakingPicturesFor3DObjectCapture文件里的CaptureSample.xcodeproj 文件

3.2 编译运行安装app到你的iphone手机

4. 使用app对实物进行拍照捕捉

4.1 拍照模式可分为手动或自动，建议手动。

4.2 拍摄教程可参考苹果官网视频，拍摄质量会严重影响输出模型，建议参考官网拍摄教程。

Apple Developer Documentation

视频教程跳转到19:17 Create 3D models with Object Capture - WWDC21 - Videos - Apple Developer

4.3 拍摄结束后，所有文件（image，depth，gravity）都会集中保存在一个文件夹里，这个文件夹位于iPhone手机里的文件-我的iphone-CaptureSample里面，将这个文件夹隔空传送到你的mac桌面上，并为它重命名。（如果你没有在手机里找到CaptureSample文件夹，请看4.4，否则移步到步骤5）

4.4 更新于2022-03-13 根据部分论坛网友反映在 iphone-文件-我的iphone 找不到 “Capture Sample”文件夹，造成此问题的原因本人还在分析排查中，以下是解决办法：

4.4.1 连接你的iphone到mac，打开步骤3.1中CaptureSample.xcodeproj 工程文件，选择 “Window”- “Devices and Simulators"

4.4.2 选择已经安装到你手机的CaptureSample应用，点击下方红色框选的按钮，然后选择“Download Container"，等待下载完成，并保存到你想要的位置。

4.4.3 下载完成后，control+单击或触控板双指点击下载好的文件，选择“显示包内容”

4.4.4 选择 AppData - Documents - Captures 在这里就可以找到你捕获到的文件了

5. 下载Photogrammetry Command-Line App 到你的mac上，下载地址

Apple Developer Documentation

5.1 使用XCode 13.0 beta 打开CreatingAPhotogrammetryCommandLineApp文件下的HelloPhotogrammetry.xcodeproj

5.2 选择 Product >Scheme>Edit Scheme, 依次选择左边菜单栏的 Run，和中间菜单的Arguments

5.3 在 Arguments Passed On Launch里依次添加以下3行内容：

1. /Users/这里填你的用户名/Desktop/这里填写步骤4.3里重命名的文件名

2. /Users/这里填你的用户名/Desktop/这里填你想要输出的模型名字.usdz

3. -d full

注意：这里第一行指的是你拍了一堆照片文件夹的路径，第二行是你想要最终输出模型的路径和名字，第三行指的是输出模型的细节，可选reduced, medium, full, raw关于可选细节程度内容请观看步骤4.2里的视频教程

6. 关闭步骤5.3的对话框后，编译运行到本地mac

6.1 图片越多，此阶段耗时越长

6.2 编译运行开始后，console里会显示相关进度，像RealityFoundation.PhotogrammetrySession.Request.Detail.full, geometry: nil) = 0.062232641168当这串数字变为1.0, 并且显示[HelloPhotogrammetry]Processing is Complete! 时，模型会生成并保存在指定路径。

6.3 将生成的模型传送到手机后，打开模型文件即可体验AR

注意：如果运行完成后，且进度为1，但指定路径下没有生成模型文件，很有可能是拍摄照片数量不够，或质量太差，具体原因看console里的报错，具体拍摄技巧看步骤4