Skip to main content
Version: 10 Jul 2024

Marker Understanding Overview

The Magic Leap 2 Marker Understanding OpenXR feature allows developers to detect barcodes and markers. Markers such as Aruco, April Tags and QR Codes can also be tracked in 3D space. You can also place and anchor digital content based on the presence and dimensions of a physical marker.

using MagicLeap.OpenXR.Features.MarkerUnderstanding;

This feature requires the MARKER_TRACKING permission to be enabled in your project's Manifest Settings. (Edit > Project Settings > Magic Leap > Manifest Settings)


This feature requires the Magic Leap 2 Marker Understanding OpenXR Feature to be enabled in your project's OpenXR Settings (Window > XR Plugin Manager > OpenXR Settings).

Supported Fiducial Markers

  • QR
  • Aruco
  • April
  • EAN_13 (experimental)
  • UPC_A (experimental)
  • CODE_128 (experimental)

The 4X4 and 'Aruco Original' dictionaries often have more false detections due to their simpler and less distinctive patterns, which can be easily misidentified in various environments.

Troubleshooting and FAQ

  • Ensure that the target markers are well-lit for optimal detection. This applies to both physically printed and digitally displayed markers. However, avoid excessive light that may cause reflections and obscure the marker's features.
  • Print your markers in black and white. High contrast is crucial for accurate detection of the marker and its pose.
  • Include a white border around your marker to facilitate detection. The border should be sufficiently large to be clearly visible on the camera.

Learn More