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 キーを押すか、[Run] をクリックします。拡張顔は、シミュレーターではなく実機を使用して操作できます。デバイスは USB 経由で開発マシンに接続する必要があります。

サンプルアプリを試してみる

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

次のステップ