Unity Platform Defines
Unity does not contain a specific Platform Defines for Magic Leap 2. Instead, developers are required to create and edit custom defines symbols if they wish to use them when developing their applications. This topic describes how to create a custom directive to identify code you wish to include or exclude from your application. For example, you can choose code that will only be compiled when deploying to the Magic Leap 2.
Prerequisites
- Magic Leap SDK and Magic Leap Unity Package Installed via the Magic Leap Hub
Custom platform defines are only necessary if you are developing an application for multiple platforms. The Unity engine only provides a single UNITY_ANDROID platform symbol as it does not have distinct build targets for every Android device.
Create a custom platform define in the project
Follow these instructions to add a MAGIC_LEAP_2 platform define to your application:
- Open the Project Settings window ( Edit > Project Settings).
- Select the Player heading on the left side.
- Expand Other Settings on the right pane, and scroll until you find the Script Compilation section.
- Under Scripting Define Symbols you'll see a list of the current define symbols that your project is using.
- To create a new define, hit the + symbol.
- In the new blank, type in a custom define symbol. For this example, we'll be using MAGIC_LEAP_2.
- Press Apply to rebuild the project scripts.
Use the new define in your code
To use the new scripting define in your code, you can simply add a #if
statement anywhere you'd like the code to apply:
#if MAGIC_LEAP_2
//do things here only on the magic leap 2
#endif
If you would like to build for another device and don't wish to include the MAGIC_LEAP_2 specific code, simply remove the definition from your project settings window. Any code within your MAGIC_LEAP_2 define will not be used. To learn more see Unity's Platform Dependent Compilation guide.