Skip to main content
Version: 21 Aug 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.

NameSpace
using MagicLeap.OpenXR.Features.MarkerUnderstanding;
caution

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

caution

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)
caution

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​