User Calibration

This document demonstrates how to use the User Calibration OpenXR Feature to determine if the user has calibrated the device to fit and track their eyes properly. This feature can be used in conjunction with Android Intents to:

1. Determine if the user has calibrated their device.
2. Launch the Custom Fit app to complete fit or eye tracking calibration.

caution

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

info

That Magic Leap 2's Eye Calibration API and HeadsetFit API have been combined into a single User Calibration OpenXR Feature.

Example

The following example logs the user's fit status time and eye calibration status every frame when the component is enabled.

using UnityEngine;
using UnityEngine.XR.OpenXR;
using UnityEngine.XR.OpenXR.Features.MagicLeapSupport;

public class UserCalibrationTest : MonoBehaviour
{
    private MagicLeapUserCalibrationFeature _userCalibrationFeature;

    void OnEnable()
    {
        _userCalibrationFeature = OpenXRSettings.Instance.GetFeature<MagicLeapUserCalibrationFeature>();
        if (_userCalibrationFeature == null || !_userCalibrationFeature.enabled)
        {
            Debug.LogError("Magic Leap User Calibration Feature does not exists or is disabled.");
            return;
        }
          
        _userCalibrationFeature.EnableUserCalibrationEvents(true);
    }

    private void Update()
    {
        _userCalibrationFeature.GetLastHeadsetFit(out MagicLeapUserCalibrationFeature.HeadsetFitData headsetFitData);

        // Status can return HeadsetFitStatus.Unknown, HeadsetFitStatus.NotWorn,  HeadsetFitStatus.GoodFit or HeadsetFitStatus.BadFit.
        Debug.Log($"Last Headset fit status: { headsetFitData.status} at time { headsetFitData.time}");

        _userCalibrationFeature.GetLastEyeCalibration(out MagicLeapUserCalibrationFeature.EyeCalibrationData eyeCalibrationData);

        // Status can return EyeCalibrationStatus.Unknown, EyeCalibrationStatus.None, EyeCalibrationStatus.Coarse or EyeCalibrationStatus.Fine.
        Debug.Log($"Last Eye calibration status: {eyeCalibrationData.status}");
    }

    private void OnDisable()
    {
        if (_userCalibrationFeature != null && _userCalibrationFeature.enabled)
            _userCalibrationFeature.EnableUserCalibrationEvents(false);
    }
}

Convert HeadsetFitData.Time into a user readable value

The MagicLeapUserCalibrationFeature.HeadsetFitData.Time is provided as a Unix timestamp which is used to store/transmit date and time information in a compact way. However, to display the date and time in a human-readable, you need to convert it to a a .NET object such as DateTimeOffset or DateTime that supports different formats and time zones.

userCal = OpenXRSettings.Instance.GetFeature<MagicLeapUserCalibrationFeature>();
userCal.GetLastHeadsetFit(out MagicLeapUserCalibrationFeature.HeadsetFitData headsetFitData);

// Convert the time from microseconds to DateTime and format it
string formattedTime = DateTimeOffset.FromUnixTimeMilliseconds(headsetFitData.time / 1000).ToString("d/M/y HH:mm");

Debug.Log($"Last Headset fit at time {formattedTime}");