Skip to main content
Version: 12 Dec 2024

Unity® MRTK Package 2.0.0-pre.3

  • Magic Leap Unity SDK Version 2.6.0
  • Unity® Version: 2022.2
  • MRTK Foundations v2.8
  • MRTK Examples v2.8

Release Features

  • Voice Intents
    • Refer to SpeechCommandsDemoMagicLeap scene for usage.
  • Control
    • Refer to ControlMagicLeapDemo scene for usage.
  • HandTracking
    • Refer to HandInterationExamplesMagicleap for usage. Only Partially implemented on platform currently.
  • EyeTracking
    • Refer to EyeTrackingDemoMagicLeap for usage.
  • Meshing
    • Refer to MeshingDemoMagicLeap for usage.
  • AllInteractions
    • Refer to InteractionsDemoMagicLeap for Handtracking, Control, EyeTracking, and Voice usage together.

2.0.0-pre.3 Version 1.0 Updates

  • Added a MagicLeapOpenXRSpatialMeshObserver to allow for OpenXR-specific settings if desired that will enable normal Mesh Manager and Point Cloud Manager workflow.

Unity 6 Notes

MRTK 2.8 is not officially supported on Unity 6, but support is available on the Developer Forums should issues be discovered.

  • If still used, com.unity.xr.magicleap needs to be updated to 7.1.1 to continue to be supported in Unity 6.
  • It is recommended to use MRTK 2.8 version 2.8.3, which is the latest version released as previous versions are not supported in Unity 6 and will have errors.
    • It is possible to get around the 2.8.2 errors if required. More information will be available on the Developer Portal and Forums if support is needed.

Known Issues

  • OpenXR Performance issues with MRTK shaders at startup causing delays resulting in a few seconds of no content. This is noticeable with multiple Data providers or especially scenes with Eye Tracking. Temporarily the Interactions Example uses HeadTracking as a fallback instead of EyeTracking and the simple scenes use the URP Unlit Shader while this problem is looked into.
  • Handtracking Performance issues when interacting with other objects. Continuous Improvements made each Sprint.
  • To use the simulator when running MRTK, you must set the Script Changes While Playing setting to Stop Playing and Recompile or Recompile and Continue Playing in the Unity Preferences.
  • The Slot Example in the Speech Commands Sample scene will trigger the change color MRTK popup.
  • Occasionally the controller may not connect properly when launching a new application. Pausing and resuming the application resolves this.

Important Notes

  • Instead of copying a configuration file, clone the DefaultMixedReality version and make adjustments. We have found copying an MRTK configuration file can cause issues such as Input Data Providers not loading or visualizers not attaching properly.
  • Controller Visualizer sometimes stops positioning and the logs say: Left_ControllerModel(Clone) is missing a IMixedRealityControllerVisualizer component! This happens sporadically, we have found adding the MixedRealityControllerVisualizer component to the model itself resolves this.
  • If your application builds and results in a blank/empty scene, you must adjust your project's quality settings. (Known issue in editors 2021.1 and older)
    • To resolve this, remove all but one of the quality presets in your project's quality settings (Edit>Player Settings>Quality).
  • Users may need to add the tracked pose driver to the camera themselves.