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

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

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

前提条件

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

拡張フェイスの使用

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

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

  1. GitHub から最新の ARCore SDK for iOS のクローンを作成するか、この SDK をダウンロードして、サンプルアプリコードを取得します。
  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. カメラがユーザーの方に向いていることを確認します。

次のステップ