Magic Leap: Getting started on Unreal Engine
In this article, I will be demonstrating how to install and set up your computer itowork with the Magic Leap SDK.
Magic Leap SDK
First, you will need to download the Magic Leap Package Manager.
You can download it here and sign in. It’s available both on Windows or Mac, but there‘s no Linux version available at this time of writing. Sorry 🤷♂️
Once downloaded, install the package manager and sign in (again) with your Magic Leap credentials. You will then be greeted with the following page.
Depending on which 3D engine you want to work with, you will need to know the SDK version that is compatible with the Lumin OS of your Magic Leap and your 3D engine. Check the table below:
To work with Unreal Engine and Lumin you will need to download the following packages:
❗️ Be careful not to install the SDK in a path with a white space in it or else the packaging process in Unreal Engine will fail. Also, if your username has a space in it then install the package in an other hard drive or create a new user just for it.
C API Samples
Visual Studio 2017 Extension
Unreal Soundfield Audio
Unreal API Documentation
Visual Studio 2015 Extension
You can now either download the Unreal Engine standalone, the Epic Game Store compiled version with the Lumin package already installed in it or compile the source engine with the Lumin SDK in it yourself.
If you download the standalone version of the Unreal Engine make sure to select the Lumin package in the options as shown below.
Make sure you also select the Android package as it is required by Lumin.
Now you are ready to set up your project!
Open the Epic Games Launcher and log into your account. Launch Unreal Engine and start a new empty project.
Before jumping into anything, you should first set up your project settings:
In the project settings** window, on your left, scroll down the menu and click on
Platforms > Magic Leap **then in
Magic Leap App Title, click on
On the same page in Distribution Signing put your developer certificate (you can get one on the magic leap website, log in and go to
Publish > Certificates).
Back on the left menu and select
Platforms > Magic Leap SDK and enter the path where you installed the Magic Leap SDK.
And finally, on the left menu select
Plugins > Magic Leap Plugin and enable Zero Iteration.
Magic Leap Remote
Don’t have your Magic Leap with you? No worries, the Magic leap Remote allows you to simulate the headset with its remote controller and the all the required environment.
It is automatically installed with the Lumin SDK, you can either launch it via the Magic Leap package manager or directly from the folder where you installed the SDK (
<your path>\mlsdk\<your version>\VirtualDevice).
Once you launched the app you will be greeted with the following window:
Start Simulator and a new window will open with an empty map. On the top left corner of the window, click
Load a Virtual Room, select a map and that’s it! You are ready to use it on the Unreal Engine.
To use this simulator on the Unreal Engine you will need to have done all the previous setup, then go to the drop-down menu of
Play and select
Once you followed their tutorial for Hello_Cube and click
VR Preview you will be able to see the cube in your virtual world.
❗️ If you have a black screen on the simulator, try updating your graphics drivers or reinstall the SDK
There are some limitations on what you can do with the simulator, for example, you won’t be able to test the hand meshing feature or the image tracking feature. But for quick 3d rendering and testing, it is quite useful.
That’s it, you are ready to work with the Lumin SDK and Unreal Engine!