Setting up your development environment
Build the Unreal Engine with the GoogleARCore plugin by following these steps:
Set up the Unreal editor for Android development by following the Android Quick Start.
Make sure you install Android SDK Platform version 7.0 (API level 24) or higher.
You will need to get the Unreal HelloAR sample project. You can either:
Download the sample project repository and extract it.
Clone the repository with the following command:
git clone https://github.com/google-ar/arcore-unreal-sdk.git
You will need a supported Android device.
Prepare your device
You must use a supported, physical device. ARCore does not support virtual devices such as the Android Emulator. To prepare your device:
- Enable developer options
- Enable USB debugging
- Install the ARCore Service on the device:
Open the sample project
In Unreal Editor open the HelloAR sample project.
Set up Android development settings
In the menu bar, click Edit > Project Settings.
In Project Settings, under the Android SDK platform, make sure all the paths are set correctly to your Android SDK and Android NDK installations. Set the SDK API Level to 'matchndk'. Then set the NDK API Level to android-24 or higher.
Build and run the sample app
Package the HelloAR project. In the menu bar, select File > Package Project > Android > Android (ASTC).
A dialog box will appear. In that box, create a new folder called Builds and click Select.
Unreal begins packaging the project and displays the progress in the status window (lower right-hand corner). For details on the packaging process, see the Output Log window.
Once the project has been packaged, make sure your device is connected to your machine. Open the Builds folder and double-click the file
Install_HelloARUnreal_Development-armv7-es2.bat(if you are using Windows) or
Install_HelloARUnreal_Development-armv7-es2.command(if you are using Mac) file to install the project on your Android Smartphone.
After the install is completed, look for an app called HelloAR UE4 on your device and launch it.
As you move your device, the app automatically detects flat surfaces and draws a diamond grid. Tap the grid to place an Android robot on the surface.
Read the code in the sample app and ARCore for Unreal API reference.