Android Emulator で AR アプリを実行する

Android Emulator を使用して、実機なしで AR シナリオをテストします。Android Emulator を使用すると、エミュレートしたデバイスを持ち、仮想環境で ARCore アプリを実行できます。

開発環境を設定する

ソフトウェア要件:

ARCore 用 Android Studio と SDK ツールを入手する

  1. Android Studio 3.1 以降をインストールします。

  2. Android Studio で、Preferences > Appearance and Behavior > System Settings > Android SDK に移動します。

  3. [SDK Platforms] タブを選択し、[Show Package Details] チェックボックスをオンにします。

    適切な Android バージョンを選択します。
    Google API Intel x86 Atom System Image API レベル 27 以降

  4. [SDK Tools] タブを選択し、Android Emulator 27.2.9 以降を追加します。

  5. OK をクリックして、選択したパッケージとツールをインストールします。

  6. もう一度 [OK] をクリックして変更を確認します。

  7. Accept はコンポーネント インストーラのライセンス契約です。

  8. Finish をクリックします。

AR をサポートする仮想デバイスを作成する

詳細については、Android Studio の仮想デバイスを作成するの手順をご覧ください。

新しい Android Virtual Device(AVD)を作成する

  1. Android Studio で Tools > AVD Manager をクリックして AVD Manager を開きます。

  2. [AVD Manager] ダイアログの下部にある Create Virtual Device をクリックします。

  3. ご希望の [Phone] ハードウェア プロファイルを選択または作成して、[Next] を選択します。

  4. API レベル 27 以降を実行している x86 または x86_64 システム イメージを選択し、Next を選択します。

    • 物理 ARCore デバイスは API レベル 24 以降でサポートされていますが、Android Emulator のサポートには API レベル 27 以上が必要です。

    • x86 ベースの Android Emulator アーキテクチャのみがサポートされています。現在のところ、arm64-v8aarmeabi-v7 などの他のアーキテクチャはサポートされていません。

  5. 仮想デバイスが正しく構成されていることを確認します。

    • Show Advanced Settings をクリックします。

    • Camera BackVirtualScene に設定されていることを確認します。

  6. Finish をクリックして、AVD を作成します。

アプリを実行する

エミュレータで AR 対応仮想デバイスで ARCore アプリをテストします。これを行うには、Android Studio の手順に沿って Android Emulator でアプリを実行する必要があります。

Google Play 開発者サービス(AR)の更新

エミュレータ上の AR 用 Google Play 開発者サービスのバージョンが古い可能性があります。次の手順に沿って更新してください。

  1. GitHub のリリースページから最新の Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk をダウンロードします。

  2. ダウンロードした APK を、使用する各 AVD にインストールします。

    目的の AVD を起動してから、ダウンロードした APK をシステム フォルダ(Downloads)を実行中のエミュレータにインストールするか、仮想デバイスの実行中に adb を使用してインストールします:

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

追加の AVD を使用する場合は、上記の手順を繰り返します。

仮想シーンを操作する

アプリが ARCore に接続すると、カメラを制御する方法を示すオーバーレイと、エミュレータ ウィンドウの下にステータスバーが表示されます。

仮想カメラを移動する

カメラの移動コントロールにアクセスするには、Option(macOS)または Alt(Linux または Windows)を長押しします。カメラを移動するには、次のコントロールを使用します。

プラットフォーム アクション 必要なご対応
macOS 左または右に移動 option を押しながら A または D
上下に移動 option を押しながら Q または E
前または後ろに移動 option を押しながら W または S
デバイスの向きを変更する option キーを押しながらマウスを移動する
Linux または Windows 左または右に移動 Alt キーを押しながら A または D キーを押します。
上下に移動 Alt キーを押したまま Q または E キーを押します。
前または後ろに移動 Alt キーを押しながら W または S キーを押します。
デバイスの向きを変更する Alt キーを押しながらマウスを移動する

Option または Alt を解放すると、エミュレータのインタラクティブ モードに戻ります。

デバイスをより正確に配置するには、[Extended controls] の [Virtual Sensors] タブを使用します。

拡張画像をシーンに追加する

エミュレータのシミュレート環境に画像を読み込み、拡張画像をテストします。

Extended controls の [Camera] タブを使用して、Scene images を追加または変更します。画像の場所は 2 か所あり、1 つは壁、もう 1 つはテーブルにあります。

これらの画像位置をシーン内で表示するには、エミュレータを起動し、カメラの開始位置の背後にあるダイニング エリアにカメラを移動します。

トラブルシューティングのヒント

  • ARCore アプリの起動時に「このデバイスは AR をサポートしていない」というメッセージが表示される場合は、システム イメージでリビジョンを確認してください。API レベル 27 リビジョン 4 以降を使用していることを確認します。

  • ARCore アプリが起動したときにカメラを起動できない場合は、上記の構成手順の説明に沿って、Camera BackVirtualScene に設定されていることを確認します。

  • ARCore アプリを起動できず、「AR セッションを作成できない」というエラー メッセージが表示される場合は、アプリのログをご確認ください。java.lang.UnsatisfiedLinkError/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) を含むメッセージが見つかった場合は、AR 用 Google Play 開発者サービス apk の正しいバージョンをインストールしていない可能性があります。新しい仮想デバイスを作成し、x86 バージョンをインストールします。