iOS 向け拡張顔機能のクイックスタート

このガイドでは、以下の方法について説明します。

  • 拡張フェイスを扱うための開発環境を設定する
  • 2D テクスチャを適用し、検出された顔に 3D オブジェクトを適用する

前提条件

  • Xcode バージョン 13.0 以降
  • Cocoapods 1.4.0 以降（Cocoapods を使用している場合）
  • iOS 12.0 以降を搭載した ARKit 対応の Apple デバイス （デプロイ ターゲットが iOS 12.0 以降であることが必要です）

拡張顔の使用

次の手順では、拡張現実の顔のサンプルアプリを使用して、拡張現実の顔機能を備えたアプリを構成してビルドするための重要なタスクについて説明します。

拡張フェイスのサンプルアプリを入手する

  1. GitHub から最新の ARCore SDK for iOS のクローンを作成するかダウンロードして、サンプルアプリのコードを取得します。
  2. ターミナルまたは Finder ウィンドウを開き、SDK のクローンを作成またはダウンロードしたフォルダに移動します。
  3. サンプルアプリのコードは /Examples/AugmentedFacesExample にあります。

実行 pod install

AugmentedFacesSample アプリには、必要な ARCore SDK と iOS のバージョンが事前構成された Podfile が付属しています。これらの依存関係をインストールするには:

  1. ターミナル ウィンドウを開き、Xcode プロジェクトが存在するフォルダから pod install を実行します。これにより、後でアプリのビルドと実行に使用する *.xcworkspace ファイルが生成されます。

アプリをビルドして実行する

  1. Xcode でプロジェクトの .xcworkspace（.xcodeproj ではない）ファイルを開きます。
  2. ターゲットの全般設定を開き、バンドル ID を変更します。
  3. Cmd+R キーを押すか、[実行] をクリックします。拡張フェイスを使用する場合は、シミュレータではなく物理デバイスを使用してください。デバイスは USB 経由で開発マシンに接続されている必要があります。

サンプルアプリを試す

  1. .xcworkspace ファイルからサンプルアプリをビルドして実行し、デバイスで起動します。
  2. メッセージが表示されたら、アプリにカメラの権限を付与します。ARCore は、カメラに映っている顔の検出を開始します。現在のところ、一度に検出される顔は 1 つだけです。
  3. カメラがユーザーのほうを向いていることを確認します。

次のステップ