1. Configuration Settings

1.1. Download the ARGear Unity Plugin

In order to use the ARGear Unity plugin, you need to create an account from https://argear.io and download the plugin from "Download Free SDK" menu. You will first need to create an account on the website.

1.2. Android Configuration

1.2.1. Create and Import a Project

  • Create a new 3D project in Unity

  • Import the downloaded ARGear Unity plugin.

    • Select Assets > Import Package > Custom Package from the top menu

    • Select the downloaded argear_plugin_{version_name}.unitypackage file.

  • Import all packages from the Import Package dialog window.

1.2.2. Project Setting Configuration

  • Open build setting by selecting File > Build Settings from the top menu.

  • Select Android and click Switch Platform.

  • Click Player Settings in the Build Settings dialog window.

  • Configure values from Settings dialog window as below.

Settings

Value

Player Settings > Other Settings > Rendering

Uncheck Auto Graphics API

Set OpenGLES2 and OpenGLES3 (The current Vulkan API is not supported)

Player Settings > Other Settings > Multithreaded Rendering

disabled

Player Settings > Other Settings > Minimum API Level

Select Android 6.0 ‘Marshmallow’ (API Level 23)

Player Settings > Other Settings > Package Name

Write Project Overview > Information > Application Id of a created project from argear.io

Player Settings > Other Settings > Configuration > Scripting Backend

Mono

1.2.3. Placing of ARGearPlugin Object

  • Place an ARGearPlugin object in the Assets > Prefab folder in Project Explorer.

  • AR camera will properly work only if MainCamera and Directional Light objects are removed.

1.2.4. API Information Configuration

In order to run ARGear, API information must be set in a script in the ARGearPlugin object. API URL and key must be set, which can be found in Project Overview > Information in Console after creating a project in the ARGear Console (https://console.argear.io). The figure below depicts a sample ARGear Unity App configuration information.

<Fig. Sample App Configuration Information>

1.3. iOS Configuration

1.3.1. Import and Create a Project

  • Create a new 3D project in Unity

  • Import the downloaded ARGear Unity plugin.

    • Select Assets > Import Package > Custom Package from the top menu

    • Select the downloaded argear_plugin_{version_name}.unitypackage file.

  • Import all packages from the Import Package dialog window.

1.3.2. Project Setting Configuration

  • Open build setting by selecting File > Build Settings from the top menu.

  • Select iOS and click Switch Platform.

  • Click Player Settings in Build Settings dialog window.

  • Configure values from the Settings Dialog window as below.

Settings

Value

Player Settings > Other Settings > Rendering

Uncheck Auto Graphics API

Set Metal

Player Settings > Other Settings > Multithreaded Rendering

disabled

Player Settings > Other Settings > Target Device

Select iPhone only

Player Settings > Other Settings > Target minimum iOS Version

Set above 9.0

Player Settings > Other Settings > Bundle Identifier

Write Project Overview > Information > Application Id of a created project from argear.io.

Player Settings > Other Settings > Camera Usage Description

Write a brief description for camera access right

1.3.3. Placing of ARGearPlugin Object

  • Place an ARGearPlugin object in the Assets > Prefab folder in Project explorer.

  • AR camera will properly work only if MainCamera and Directional Light objects are removed.

1.3.4. API Information Configuration

In order to run ARGear, API information must be set in the script of the ARGearPlugin object. The API URL and authentication keys must be set, which can be found in Project Overview > Information in the ARGear Console after creating an ARGear project (https://console.argear.io). The figure below depicts a sample ARGear Unity App configuration information.

1.3.5. XCode Build Setting

Add frameworks in TARGETS > General > Frameworks, Libraries, and Embedded Content from the exported Unity project.

Name

Embed

ARGear.framework

Embed & Sign

Photos.framework

Do Not Embed

<Fig. An Example of Added Frameworks>

Set TARGETS > Build Settings > Build Options > Enable Bitcode = No of your project as below.

<Fig. Enable Bitcode in Build Settings>

Ensure TARGETS > Build Settings > Architectures > Architectures builds correct architectures.

<Fig. Set Build Architectures>