Quickstart for Unity

Setting up your development environment

Prepare your device

To prepare your supported device, enable developer options and USB debugging.

Create a new project

In Unity, select File > New Project.

Name your project HelloAR, leave 3D mode selected, and click Create Project.

Configure the build settings

Open the Build Settings window by clicking File > Build settings.

Then, change the following settings:

  1. Change the target platform to Android and click Switch Platform.
  2. Click Player Settings to open the Android Player Settings. Then change the following settings:
    • Other Settings > Multithreaded Rendering: Off
    • Other Settings > Package Name: a unique app ID that looks like a Java package name, such as com.example.helloAR
    • Other Settings > Minimum API Level: Android 7.0 or higher
    • Other Settings > Target API Level: Android 7.0 or higher
    • XR Settings > ARCore Supported: On
  3. The Scenes in Build lists the scenes from your project that will be included in your build. Add the scene from the HelloAR sample app to the build as follows:
    1. Locate the scene in the Project window under Assets > GoogleARCore > Examples > HelloAR > Scenes.
    2. Click the scene and drop it on Scenes in Build.

Import the SDK

Import the arcore-unity-sdk-v1.1.0.unitypackage by clicking the menu Assets > Import package > Custom Package and import everything in the Unity package.

In the Unity's Project window, you can see the both the SDK files and the HelloAR sample app in Assets/GoogleARCore/Examples/HelloAR.

Build and run the sample app

Make sure your device is connected to your machine and then click Build and Run. Unity builds your project into an Android APK, installs it on the device, and launches 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.

You can use Android Logcat to view log messages or Android Device Monitor to analyze the device more comprehensively.

Next Steps

Send feedback about...