Download and Import MAGES™ SDK¶
Before you start¶
Latest stable release of MAGES SDK runs on Unity 2020.3.9f1 LTS or above. Login using your developer account credentials.
Note
Support for Unity 2021.3 LTS is available in BETA version
Unity manages its latest versions through Unity Hub. You can download it by visiting this page.
After installing Unity Hub, navigate to the Installs tab and click the Install Editor Button as illustrated below.
Finally, in the Archive tab you can locate the specified Unity version and install it.
Warning
Make sure you install this specific version otherwise you may encounter incompatibilities between internal and third party packages.
Before you download/import MAGES™ SDK you have to create a new empty Unity project.
It is recommended to start an empty Unity project by selecting the 3D preset, as shown in the image below:
Download MAGES™ SDK¶
Unity is currently utilizing the package manager functionality in order to install and update third party packages with ease.
To let your Unity project access the MAGES™ package, you need to add ORamaVR registry to your project list of registries. To do so, follow the steps below.
Navigate to Edit → Project Settings → Package Manager.
In the Scoped Registry section, add a new scoped registry and fill in the details as illustrated below.
For your convenience, you can find these links below:
Name
ORamaVR
URL
Scope(s)
com.oramavr.mages
Click Save, or Apply.
Navigate to Window → Package Manager. You should be able to locate MAGES™ package under ORamaVR registry.
Note
Make sure to set Packages to My Registries from the dropdown menu on the top of the window, to be able to see the MAGES™ SDK package.
Select the MAGES™ package and click the Install button.
Note
Depending on your internet connection speed, it may take several minutes to download the package.
You will be presented with the MAGES Panel window (if it does not open automatically, you can open it from the MAGES/MAGES Panel button at the top bar).
It is recommended to fix all the issues listed here. The issues with the error icon are mandatory in order for the MAGES SDK to function correctly. Issues with the warning icon are recommended, while issues with the info icon are only needed for specific functionalities.
Note
It may take some time to apply each setting, or check for completion. In both cases an appropriate loading message will appear.
Note
PUN2 package is used only if your application requires multiplayer features. If you are interested only in single player mode, you can ignore this package.
In order to use the MAGES™ SDK you must have an ORamaVR account. Go to the Log in tab to log in or create one if you do not already have.
