#
Magic Leap 2
We are working on updating Magic Leap support to newer versions.
#
Prerequisites
- Magic Leap 2 tools
- ML C SDK 1.4.0
- ML Unity package 1.7.0
- Unity 2022.3 LTS
- Immersal Core 2.0
#
Installation
Download and install the above mentioned versions of the Magic Leap C SDK and Unity package using the Magic Leap Hub package manager.
In the Unity Package Manager, install the Magic Leap package with the "Add package from tarball..." tool. Navigate to the location of the following folders and select the .tgz file within to add the package from com.magicleap.unitysdk.tgz (downloaded via ML Hub).
For example:
- Mac :
$HOME/MagicLeap/tools/unity/<Version>/com.magicleap.unitysdk.tgz
- Windows :
%USERPROFILE%/MagicLeap/tools/unity/<Version>/com.magicleap.unitysdk.tgz
After Magic Leap 2 Unity package has been installed, you can install the Immersal Magic Leap 2 support package:
- Open up the Package Manager from Window > Package Manager
- Click the + button and select "Add package from Git URL"
- Copy & paste the package URL below and click Add
Package URL: https://github.com/immersal/imdk-ml2.git
#
Unity project configuration
Ensure Magic Leap XR Plug-In is enabled and configured:
- Switch the build platform to Android.
- Enable Magic Leap in Project Settings > XR Plug-In Management.
- Check and fix issues in Project Settings > XR Plug-In Management > Project Validation.
In addition, please ensure the following permissions have been enabled in the Magic Leap custom AndroidManifest:
- android.permission.CAMERA
- com.magicleap.permission.SPATIAL_MAPPING
- com.magicleap.permission.SPATIAL_ANCHOR
You can find these permission in the Edit > Project Settings > Magic Leap > Permissions view.
Please refer to Magic Leap 2 documentation if you have issues in configuring your project.
#
Simple sample
The Magic Leap 2 support package contains one sample scene showcasing the basic setup for using Immersal together with Magic Leap 2.
#
Building and running
The application can be built the same way as any other Magic Leap 2 application. For more details, you can refer to the Magic Leap 2 example documentation
Note: there is a known issue when running the application for the first time that can cause localization to not work automatically. Currently you can simply restart the application to get around this. We are working on fixing this issue.