3 Step Guide to Magic Leap Setup and Unity Configuration

Last Updated: November 14 2018

Magic LeapMixed Reality

The Magic Leap One is a complex piece of technology, but developing for it doesn't have to be complicated. Magic Leap and Unity have made the setup process very simple. Here's how to setup your Magic Leap One into developer mode, including importing Magic Leap assets into Unity to start building your AR app.

Skip to the Technical Steps


Step 1: Register on the Magic Leap Creator Portal

You'll have to register your name, birth date, and email with Magic Leap before you can get started. Every time you log in, they'll confirm it's you by sending a 6-digit code to your email.




Once signed in, navigate to the Downloads tab.

Step 2: Download the Lumin SDK Unity Package

You'll need to download the Lumin software development kit in order to create your own Magic Leap app. Choose your platform (for us it's Unity) so the platform's Technical Preview is included, and download the package. This process will take about 10 minutes, so take a break, make some tea, and come back when you're ready.





Once Unity's Technical Preview and Lumin SDK have finished downloading, open up and run the Magic Leap Package Manager:


installing magic leap



You'll have to sign in to Magic Leap's Creator Portal once the Wizard is done, and the Package Manager will open to this page:




Drink your tea before it gets cold. You might even have time to brew a second cup.

When the Package Manager is ready, it will open to this screen where you'll see all the packages available to install:





As you select packages to install, the Manager won't start downloading until you've clicked "Apply Changes" at the end, so let's select all the packages you need at once.

Under Common Packages, you'll want to download:

  • Lumin SDK
  • C API Documentation

And under Unity Packages, you'll want to download:

  • Unity API Documentation
  • Magic Leap Unity Package

Once you have selected your desired packages to download and install, click "Apply Changes," and the Package Manager will begin downloading all packages.





When the Manager has finished, you'll see checkmarks next to the packages installed:




Congratulations! You can now open up Unity and start building! But first, we'll have to import Magic Leap assets into Unity.

Download our 10-week AR Development with Unity Course Syllabus


Step 3: Import Magic Leap Assets into Unity

Before you start building, we need to make sure Magic Leap's assets work with Unity. This is a multi-step process. You can do it!

First, we'll Create a Magic Leap Project:

  1. Open the Unity Technical Preview downloaded from the Magic Leap Package Manager
  2. Select New, enter project name and save location for the project (in our example below, we titled our project 'Appendectomy')
  3. Select the Magic Leap template and click on Create Project




Open your Project, and now we'll configure the Project Build Settings:

  1. Go to File > Open Scene > Navigate to your project > Open
  2. Click File > Build Settings
  3. Under the Platform section:
      1. Select Lumin OS
      2. Switch Platform

  4. Then, under the Lumin OS section, you'll need to set the location of the Magic Leap Unity Package:
    1. Enable Sign Package
    2. Set the Lumin SDK Location path (wherever you have it saved on your PC). For example, C:/Users/you/MagicLeap/mlsdk/v0.10.0

Now we'll import the Magic Leap Unity Package that includes the important libraries and assets we'll need.

  1. Under the Assets menu, select Import Package and click Custom Package
  2. Navigate to the Magic Leap Unity Package and open. Example location: C:/Users/you/MagicLeap/tools/unity/v0.17.0/MagicLeap-0.17.0
  3. Click All then Import

Great! You can now start building your AR app on Magic Leap! We have a how-to post ready for you when you're ready to deploy your app onto your Magic Leap One for testing.

If you're not sure how to take your idea to a prototype, we can help. Circuit Stream's 10-week Development with Unity course gives you the skills you need to build your app and begin a career in VR/AR development. Download our syllabus and see what's in store when you register!


Download Syllabus



Technical Steps:

  1. Register on the Magic Leap Creator Portal
  2. Download the Unity Package that includes the Magic Leap Lumin SDK
    1. Under Common Packages, download and install:
      1. Lumin SDKI
      2. C API Documentation
    2. Under Unity Packages, download and install:
      1. Magic Leap Unity Package
      2. Unity API Documentation
    3. Click "Apply Changes"
  3. Import Magic Leap Assets into Unity
    1. Open Unity Technical Preview downloaded from Magic Leap Portal
    2. Select New, enter project name and specify save location for project
    3. Select Magic Leap template and click on Create Project
    4. In Unity, go to File > Open Scene > Open your desired scene
    5. Under Platform section:
      1. Select Lumin OS
      2. Click Switch Platform
      3. Under Lumin OS, enable Sign Package
      4. Set Lumin SDK Location path
    6. Back in Unity, navigate to Assets > Import Package and select Custom Package
    7. Navigate to the Magic Leap Unity Package and Open
    8. Click All and Import

AUTHOR

NAKISA DONNELLY

Instructor and Unity Developer

Receive our newsletter to stay on top of the latest virtual reality and augmented reality info.