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.

../../../_images/UnityHubTutorial.PNG

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:

3D Project Creation

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.

  1. Navigate to Edit → Project Settings → Package Manager.

  2. In the Scoped Registry section, add a new scoped registry and fill in the details as illustrated below.

    ../../../_images/ORamaVRRegistry.PNG

    For your convenience, you can find these links below:

    Name

    ORamaVR

    URL

    https://npm-registry.oramavr.com/

    Scope(s)

    com.oramavr.mages

  3. Click Save, or Apply.

  4. 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.

  5. Select the MAGES™ package and click the Install button.

    ../../../_images/InstallPackage.png

    Note

    Depending on your internet connection speed, it may take several minutes to download the package.

  6. 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).

    MAGES Panel showing the project configuration page with the different issue types

    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.

  7. 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.

    MAGES Panel showing the log in tab page