适用于 iOS 的增强人脸快速入门

本指南将介绍如何执行以下操作:

  • 设置开发环境以使用 Augmented Faces
  • 应用 2D 纹理并将 3D 对象附加到检测到的面

前提条件

  • Xcode 13.0 或更高版本
  • CocoaPods 1.4.0 或更高版本(如果使用 Cocoapods)
  • 一部搭载 iOS 12.0 或更高版本且与 ARKit 兼容的 Apple 设备(部署目标必须为 iOS 12.0 或更高版本)

使用增强人脸

以下步骤使用 Augmented Faces 示例应用来向您展示使用 Augmented Faces 功能配置和构建应用的关键任务。

获取 Augmented Faces 示例应用

  1. 从 GitHub 克隆或下载最新的 ARCore SDK for iOS,获取示例应用代码。
  2. 打开终端或 Finder 窗口,并导航到您克隆或下载 SDK 的文件夹。
  3. 您可以在 /Examples/AugmentedFacesExample 中找到示例应用代码。

运行 pod install

AugmentedFacesSample 应用附带了一个 Podfile,其中已预先配置了您需要的 ARCore SDK 和 iOS 版本。如需安装这些依赖项,请执行以下操作:

  1. 打开一个终端窗口,然后从 Xcode 项目所在的文件夹运行 pod install。这将生成一个 *.xcworkspace 文件,您稍后会使用此文件构建和运行应用。

构建并运行应用

  1. 在 Xcode 中打开项目的 .xcworkspace(而非 .xcodeproj)文件。
  2. 打开目标的常规设置,然后更改软件包标识符。
  3. 按 Cmd+R 或点击“运行”。请使用实体设备(而非模拟器)处理增强现实人脸。设备应通过 USB 连接到您的开发机器。

试用示例应用

  1. .xcworkspace 文件构建并运行示例应用,以在您的设备上启动此应用。
  2. 如果出现提示,请向应用授予相机权限。然后,ARCore 会开始检测摄像头中可见的面部。目前,一次只能检测到 1 张人脸。
  3. 确保摄像头朝向用户。

后续步骤