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.33.0_x86_for_emulator.apk をダウンロードします。

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

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

    adb install -r Google_Play_Services_for_AR_1.33.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 を解放すると、エミュレータのインタラクティブ モードに戻ります。

拡張コントロールVirtual Sensors タブを使用すると、デバイスをより正確に位置決めできます。

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

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

Extended controlsCamera タブを使用して、Scene images を追加または変更します。画像の設置場所は、壁とテーブルにある 2 か所です。

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

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

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

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

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