Run AR Apps in Android Emulator

Use the Android Emulator to test AR scenarios without a physical device. The Android Emulator lets you run ARCore apps in a simulated environment with a simulated device that you control.

Requirements

See the Android Emulator requirements to determine if your system supports the emulator.

You'll also need Android Studio 3.1 or later.

Get Android Studio and SDK tools for ARCore

Install Android Studio 3.1 or later.
In Android Studio, go to Tools > Android > SDK Manager.

By default, the System Settings > Android SDK menu opens.
In the Android SDK menu, select SDK Platforms and click Show Package Details.

Under Android 8.1 (Oreo), select:
Google APIs Intel x86 Atom System Image (Level 27, Version 4 or later).
In the Android SDK menu, select SDK Tools and add Android Emulator (Version 27.1.10 or later).
Click OK to install the tools.

Create a virtual device with AR support

AR is supported by default in new virtual devices created in Android Studio 3.1, or later with the API Level 27 Revision 4 or later system image.

You can follow the Android Studio instructions to Create a Virtual Device with AR support.

Configure the virtual device

Select the Pixel or Pixel 2 hardware profile.
Select the Oreo: API Level 27: x86: Android 8.1 (Google APIs) system image.
Confirm that your virtual device is configured correctly:
- Go to Verify Configuration > Show Advanced Settings.
- Make sure that Camera Back is set to VirtualScene.
  
  If it is not, go back and make sure that you are running Android Studio 3.1 or later and have Android Emulator 27.1.10 or later installed.

Run your app

Test an ARCore app on an AR-supported virtual device in the emulator. To do this, you can follow the Android Studio instructions to Run an app in the Android Emulator.

There are additional requirements to run Sceneform apps in the emulator:

You need Android Emulator version 27.2.9 or later.
OpenGL ES 3.1 must be supported and enabled in the Android Emulator.
- Make sure your emulator is configured to use the latest version. In the menu, select Settings > Advanced > Renderer maximum (up to OpenGL ES 3.1).
- Run the emulator and check whether OpenGL ES 3.1 is being used:
```
adb logcat | grep eglMakeCurrent
```
  If you see ver 3 1, then you can run Sceneform apps. If you see a lower version, then your desktop GPU does not support OpenGL ES 3.1 and you must use a supported device to run Sceneform apps.

Update ARCore

The version of ARCore on the emulator is likely out-of-date. Follow these instructions to update it:

Download ARCore x86 for emulator APK from github.
Drag the downloaded apk onto the running emulator (or run adb install -r ARCore_1_1_x86_for_emulator.apk to install from the terminal).

Control the AR Simulation

When your app connects to ARCore, you’ll see an overlay describing how to control the camera and a status bar below the emulator window.

Move the simulated device

Press and hold Option (OSX) or Alt (Linux or Windows) to access camera movement controls. Use the following controls to move the camera:

Platform	Action	What to do
OSX	Move left or right	Hold Option + press A or D
	Move down or up	Hold Option + press Q or E
	Move forward or back	Hold Option + press W or S
	Change device orientation	Hold Option + move mouse
Linux or Windows	Move left or right	Hold Alt + press A or D
	Move down or up	Hold Alt + press Q or E
	Move forward or back	Hold Alt + press W or S
	Change device orientation	Hold Alt + move mouse

Release Option or Alt to return to interactive mode in the emulator.

Use the Virtual Sensors tab in Extended controls for more precise device positioning.

Add Augmented Images to the scene

Load images into the emulator’s simulated environment to test Augmented Images.

Use the Camera tab in Extended controls to add or modify Scene images. There are two image locations, one on the wall and one on the table.

To view these image locations in the scene, launch your emulator, then move the camera to the dining room area through the door behind the camera’s starting position.

Troubleshooting tips

If your ARCore app launches and you see an "AR Core not supported" message, check the revision on your system image. Make sure you are using API Level 27 Revision 4.
If your ARCore app fails to open the camera when it launches, make sure that Camera Back is set to VirtualScene, as described in the configuration steps above.