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 > Device Manager をクリックしてデバイス マネージャーを開きます。
[デバイス マネージャー] パネルの上部にある [Create 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）を更新する
エミュレータの Google Play 開発者サービス（AR）のバージョンが古い可能性があります。次の手順で更新してください。
GitHub のリリースページから最新の Google_Play_Services_for_AR_1.38.0_x86_for_emulator.apk をダウンロードします。
使用する APK を、使用する各 AVD にインストールします。
必要な AVD を起動し、ダウンロードした APK をシステム フォルダからドラッグします（つまり、Downloads など）を実行中のエミュレータにインストールすることも、仮想デバイスの実行中に
adbを使用してインストールすることもできます。adb install -r Google_Play_Services_for_AR_1.38.0_x86_for_emulator.apk
追加の AVD を使用する場合は、上記の手順を繰り返します。
仮想シーンを操作する
アプリが ARCore に接続すると、カメラを制御する方法を示すオーバーレイと、エミュレータ ウィンドウの下にステータスバーが表示されます。
仮想カメラを移動
カメラの移動コントロールにアクセスするには、Shift を長押しします。カメラを移動するには、次のコントロールを使用します。
| アクション | 必要なご対応 |
|---|---|
| 左または右に移動 | Shift キーを押しながら A または D キーを押す |
| 上下に移動 | Shift キーを押しながら Q または E キーを押す |
| 前後に移動 | Shift キーを押しながら W または S キーを押す |
| デバイスの向きを変更する | Shift キーを押しながらマウスを動かす |
Shift を解放して、エミュレータのインタラクティブ モードに戻ります。
より正確なデバイス配置を得るには、拡張コントロールの Virtual Sensors タブを使用します。
シーンに拡張画像を追加する
エミュレータのシミュレーション環境に画像を読み込んで、拡張画像をテストします。
Scene images を追加または変更するには、Extended controls の Camera タブを使用します。画像の場所は 2 つあり、1 つは壁、もう 1 つはテーブルです。
撮影場所の画像を表示するには、エミュレータを起動し、カメラの開始位置の背後のドアからダイニング エリアにカメラを移動します。
トラブルシューティングのヒント
ARCore アプリが起動し、「このデバイスは AR に対応していません」というメッセージが表示される場合は、システム イメージのリビジョンを確認します。API レベル 27 リビジョン 4 以降を使用していることを確認します。
ARCore アプリが起動時にカメラを開くことができない場合は、上記の構成手順で説明されているように、Camera Back が VirtualScene に設定されていることを確認します。
ARCore アプリが「Failed to create AR Session」というエラー メッセージで開いた場合は、アプリのログを確認します。
/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)を含むメッセージ付きのjava.lang.UnsatisfiedLinkErrorが見つかった場合、誤ったバージョンの Google Play 開発者サービス（AR） APK をインストールしている可能性があります。新しい仮想デバイスを作成し、x86 バージョンをインストールします。