Android Emulator を使用して、実機なしで AR シナリオをテストします。Android Emulator を使用すると、エミュレートしたデバイスを制御して、仮想環境で ARCore アプリを実行できます。
開発環境を設定する
ソフトウェア要件:
Android Studio 3.1 以降。
Android Emulator、27.2.9 以降。
ARCore 用の Android Studio と SDK ツールを入手する
Android Studio 3.1 以降をインストールします。
Android Studio で Preferences > Appearance and Behavior > System Settings > Android SDK に移動します。
[SDK Platforms] タブを選択し、[Show Package Details] をオンにします。
適切な Android バージョンの下で、以下を選択します。
Google API Intel x86 Atom System Image API レベル 27 以降。[SDK Tools] タブを選択し、Android Emulator 27.2.9 以降を追加します。
OK をクリックして、選択したパッケージとツールをインストールします。
もう一度 [OK] をクリックして変更を確定します。
Accept: コンポーネント インストーラのライセンス契約
Finish をクリックします。
AR をサポートする仮想デバイスを作成する
詳細については、仮想デバイスを作成するための Android Studio の手順をご覧ください。
新しい Android Virtual Device（AVD）を作成する
Android Studio で Tools > AVD Manager をクリックして AVD Manager を開きます。
[AVD Manager] ダイアログの下部にある Create Virtual Device をクリックします。
[Phone] ハードウェア プロファイルを選択または作成し、Next を選択します。
API レベル 27 以降を搭載した
x86またはx86_64のシステム イメージを選択し、Next を選択します。物理 ARCore デバイスは API レベル 24 以降でサポートされていますが、Android Emulator のサポートには API レベル 27 以降が必要です。
x86 ベースの Android Emulator アーキテクチャのみがサポートされています。
arm64-v8a、armeabi-v7などの他のアーキテクチャは現在サポートされていません。
仮想デバイスが正しく構成されていることを確認します。
Show Advanced Settings をクリックします。
Camera Back が VirtualScene に設定されていることを確認します。
Finish をクリックして AVD を作成します。
アプリを実行する
エミュレータで AR 対応仮想デバイスで ARCore アプリをテストします。これを行うには、Android Studio の手順に沿って Android Emulator でアプリを実行する必要があります。
Google Play 開発者サービス（AR）を更新する
エミュレータ上の AR 用 Google Play 開発者サービスのバージョンが古い可能性があります。次の手順に沿って更新してください。
GitHub のリリース ページから、最新の Google_Play_Services_for_AR_1.33.0_x86_for_emulator.apk をダウンロードします。
ダウンロードした各 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 controls の Camera タブを使用して、Scene images を追加または変更します。画像の設置場所は、壁とテーブルにある 2 か所です。
これらの画像の位置をシーン内で表示するには、エミュレータを起動し、カメラの開始位置のドアを通してカメラをダイニング エリアに移動します。
トラブルシューティングのヒント
ARCore アプリが起動したときに「このデバイスは AR に対応していません」というメッセージが表示される場合は、システム イメージのリビジョンを確認してください。API レベル 27 リビジョン 4 以降を使用していることを確認します。
ARCore アプリが起動時にカメラを開くことができない場合は、上記の構成手順で説明されているように、Camera Back が VirtualScene に設定されていることを確認します。
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 バージョンをインストールします。