Creating an empty project

Please use Unity 6 or newer.

Create project

  1. Create an empty Unity project. When asked for the template choose 3D (URP).
    Create an empty Unity project

  2. In the top menu click File -> Build Settings. In the window select Android (iOS) and click “Switch platform”.

Setup player settings (Android)

  1. In the build settings window click on “Player Settings” in the left bottom corner.

  2. Fill in the company name and product name.

  3. Set Auto Graphics API to false

  4. Remove Vulkan from the list and only keep OpenGLES3.

  5. Disable multithreaded rendering.

  6. Set Minimum API Level to at least 24

  7. Make sure the scripting backend (under Configuration) is set to IL2CPP.

Setup player settings (iOS)

  1. In the build settings window click on “Player Settings” in the left bottom corner.

  2. Fill in the company name and product name.

  3. Disable multithreaded rendering.

  4. Set bundle identifier

  5. Set Target minimum iOS version to 14.0

  6. Set Requires ARKit Support to ‘true’

  7. Fill in Camera Usage Description if not already filled in

Installing packages

  1. In the top menu click on Windows -> Package Manager

  2. Change packages shown to Unity Registry. image4.png

  3. Install Universal RP

  4. Install AR Foundation

  5. Install Google ARCore XR Plugin

  6. Install Apple ARKit XR Plugin

  7. Click the + button in the top right corner and select install package from tarball.

  8. Install ARCoreExtensions by following the tutorial by Google.

  9. Click the + button again and find the path to augg.io SDK tarball (tar.gz file extensions) and install into the project.

Important: If you installed an older version of ARCoreExtensions (e.g. 1.39 which is shipped with some earlier versions of augg.io) you may have a problem with building the application to iOS 18. To resolve this issue, upgrade to a newer version of ARCoreExtensions by following this tutorial Upgrading ARCoreExtensions in the project.

Setting up URP

  1. Open Settings folder

  2. Select URP-HighFidelity-Renderer and add ARBackgroundRendererFeature.

Setting up XR

  1. In Project Settings go to XR Plug-in Management

  2. Set ARCore to true and confirm restart.

  3. In the top menu click Edit -> Project Settings

  4. Select Project Validation

  5. If there are any issue click on Fix

Prepare scene

  1. Create empty scene (or remove everything from the sample scene)

  2. Right click in the Hierarchy window. XR -> AR Session

  3. Right click in the Hierarchy window. XR -> XR Origin (Mobile AR)

  4. Select XR Origin. Click add component and add ARAnchorManager (the field can be empty).

Setup ARCoreExtension

  1. Right click in the hierarchy window. Select XR -> ARCore Extensions

  2. Fill in the first three fields. Just click and select the only option available

  3. Go to the Settings folder.

  4. Create ARCoreExtensionsConfig and CameraConfigFilter

  5. Select the ARCoreExtensionConfig you just created. And set Cloud Anchors Mode to enabled.

  6. Select ARCoreExtension in the scene and set the two remaining fields.

Setting up scene

  1. Open your AR scene (Main in the example project).

  2. Create an empty GameObject in the scene root named AuggioTrackingManager.

  3. Add AuggioTrackingManager script to the game object.

  4. Add InitializeOnSessionTracking and set the reference to AuggioTrackingManager. Do this if you are not using custom initializing logic.

Congratulations, you’ve made it to the end! The next part of the guide awaits you here: 01 - Setting up augg.io in a project