iOS 向け拡張現実のクイックスタート

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

  • 拡張顔に対応する開発環境をセットアップする
  • 2D テクスチャを適用し、検出された顔に 3D オブジェクトを取り付ける

要件

顔の拡張機能を利用するには、以下が必要です。

  • Xcode バージョン 10.3 以降

  • Cocoapods

  • iOS 11.0 以降を搭載した Apple デバイス(iOS 10.0 以降のデプロイ ターゲットが必要)

拡張顔の使用

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

顔の拡張アプリのサンプルアプリを入手する

  1. GitHub から最新の iOS 用 ARCore 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. カメラが向いていることを確認します。

次のステップ