# Setup Guide

## Requirements & Supports

**Requirements**

* MAXSTVPS SDK recommends [Unity 2020](https://unity3d.com/unity/whats-new/2020.3.0) or higher
* In order to use MAXSTVPS SDK for Unity, you need basic knowledge of Unity developer tools and developer resources. 
* To find out more about developer tools for Unity, click [here](https://unity.com/developer-tools) for more information.

## Install MAXST VPS Unity SDK

1. Download **MAXSTVPS SDK** 
2. Create or Open Unity Project
3. Newly created project, must download **MAXSTVPSSDK\_0.8.0.unitypackage** and install on Unity
4. Download **VPSData** and install VPSMap in accordance to location

{% hint style="info" %}
Download these files via **email.**
{% endhint %}

## Unity Setting

Description of File/Build Settings/Player Settings for Unity

{% hint style="danger" %}

* Android must only select **OpenGLES3** in Graphic APIs on Other Settings
* Android must uncheck **Multithreaded Rendering**
* Android must have **Custom Main Manifest** & **Custom Main Gradle Template** installed on Publishing Settings
  {% endhint %}

Refer to the following Github links for **Manifest** and **Gradle** 

| Github Link                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------- |
| [AndroidManifest.xml](https://github.com/maxstdev/VPSSDKUnity/blob/main/Assets/Plugins/Android/AndroidManifest.xml) |
| [MainTemplate.gradle](https://github.com/maxstdev/VPSSDKUnity/blob/main/Assets/Plugins/Android/mainTemplate.gradle) |

{% hint style="warning" %}
iOS must include descriptions for **Camera Usage Description** and **Location Usage Description**
{% endhint %}

## Install Editor Coroutines Package 

MAXSTVPS SDK requires Editor Coroutines Package in Unity 

{% hint style="danger" %}
If the following message pops up, go to **Unity > Window > PackageManager >** Search **Editor Coroutines** and download the package
{% endhint %}

```
The type or namespace name 'EditorCoroutines' does not exist in the namespace ‘Unity'.  
```

## Install VPS Map

VPS Map includes mesh, reference images and simulation data of the location. As suggested below, **VPSData** folder needs to be created at same hierarchy as **Unity Project folder (MAXSTVPSUnity)**, and **VPSMap** folder needs to be saved under **VPSData.**

Once you unzip *VPSData\_yangjae\_indoor.zip* by MAXST, it automatically opens under **VPSData** folder as **VPSMap** and **VPSSimulationData**. **yangjae\_indoor** folder will be generated automatically under these two folders. 

![VPSMap Folder Structure](/files/-MbAm9hlRVpnBpvPNh7d)

{% hint style="warning" %}
You must follow **VPSMap Folder Structure** in order to successfully activate VPS Map
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://maxstvps.gitbook.io/documentation-eng/-MbEQLJaN0vXKGxXQmJX/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.