XREAL Markers
Introduction
Introducing XREAL Markers, a novel set of 'interactive' image tracking cards designed to facilitate virtual and real-world interaction. By manipulating the magnetic sliders on the cards, users can engage in dynamic gameplay experiences. The cards are available in three distinct colors: green for bidirectional functionality, blue for tridirectional, and orange for six-directional capabilities. Developers are encouraged to leverage the cards' interactive features to innovate and enhance both new and existing applications. Additionally, we invite you to explore the sample application 'Spatial Life,' thoughtfully crafted by the XREAL design team.
Requirement
To ensure optimal performance and compatibility when using the Spatial Life application, the following hardware and software specifications must be met:
Android phones listed in Device Compatibility or Beam Pro.
XREAL Air 2 Ultra
XREAL Markers
For developers interested in creating applications akin to Spatial Life, with feature coaster image tracking, additional resource is required:
Developers who don’t have Marker cards can download and print this PDF file for use.
Usage Instructions:
Please print the Marker images on matte A4 paper in color to ensure accurate output size.
When printing, do not enlarge the image; print at 100% scale.
Cut out the Marker along the black border and attach it to a rigid cardboard.
Within the camera’s recognition range, only one card of the same color should appear.
Developer Guide
Developers who don’t have Marker cards can download and print this PDF file for use.
Usage Instructions:
Please print the Marker images on matte A4 paper in color to ensure accurate output size.
When printing, do not enlarge the image; print at 100% scale.
Cut out the Marker along the black border and attach it to a rigid cardboard.
Within the camera’s recognition range, only one card of the same color should appear.
Developer Guide
Learn how to use the Coasters Image Tracking feature in your own apps.
Create a new project in Unity.
Need help setting up? Try Getting Started with NRSDK first
Click NRSDK -> CoastersTrackingModule -> Install
Note that the coasters image tracking is not compatible with the original image tracking. If you want to use the old version SDK, click uninstall.
Open scene
CoastersimageTracking
Modify your application logic as needed. The editor includes a simulator for image tracking, demonstrated in the screenshot below. This simulator provides 11 buttons, each corresponding to one of the 11 images. By clicking these buttons, you can simulate the tracking effect for the respective image.
The Marker feature uses a trained data sample. The sample resource address is shown in the figure below. It needs to be specified in the SessionConfig resource.
Set the ImageTrackingMode to enable.
Before building an APK, please add the following lines inside the
<application>
element of yourAndroidManifest.xml
Usage
Get the current tracked Image list.
Get the tracking status of Image
In Marker, the
GetTrackingState
method will only return two states: Tracking and Paused.
Get the ID of the Image
In Marker, the value range of ID is [0,10], corresponding to different states of Marker cards.
Get image pose and size information
Enable and disable ImageTracking functionality
Last updated