Headset Calibration API Reference (Unity)

The public C# API of AR 51 Headset Calibration, namespace AR51.HeadsetCalibration. 3.0.302

For usage, see the Developer guide. For the core SDK types, see the Unity SDK API reference.

HeadsetCalibrator

class Unity component

namespace AR51.HeadsetCalibration;

public class HeadsetCalibrator : MonoBehaviour

Lines up the headset's world with the AR 51 capture space, automatically and continuously.

Member	Type	Description
RigRoot	Transform (field)	The object that gets lined up. Empty = root of the main camera.
SmoothingSeconds	float (field)	How gently later corrections are applied (seconds).
State	CalibrationState (get)	How well the headset's world lines up right now.
Hint	CalibrationHint (get)	What the wearer can do right now; None when nothing.
HasSolution	bool (get)	true once the headset has been aligned at least once.
HeadsetTracked	bool (get)	The headset reports a valid pose this frame.
HeadsetMounted	bool (get)	The headset is on a head (true when the device doesn't say).
SkeletonId	string (get)	The wearer's tracked person, or null while finding them.

Events

Event	Type	Raised when
StateChanged	event Action<CalibrationState, CalibrationState>	The state changes — with the previous and the new state.
HintChanged	event Action<CalibrationHint>	The hint changes.

Methods

Method	Description
ResetCalibration()	Start fresh (e.g. a new wearer). The view stays where it is until the new alignment is ready.

CalibrationHintPanel

class Unity component

namespace AR51.HeadsetCalibration;

public class CalibrationHintPanel : MonoBehaviour

Optional in-headset panel that shows the calibrator's hint. Its fields match the Settings reference.

HintTexts

class · nested · serializable

The message shown for each hint.

Member	Type	Description
StepIntoView · HeadsetTrackingLost · FindingYou · HoldStill · KeepWalking · Aligned	string	The text for each hint, plus the "aligned" confirmation.
For(CalibrationHint hint)	string	Returns the text for a hint.

CalibrationState

enum

Value	Meaning
NotAligned	Not lined up yet; the view hasn't been moved.
Aligning	Roughly lined up; a few steps of walking make it precise.
Aligned	Lined up; corrections from now on are small and smooth.
Lost	Was lined up but can't follow right now (e.g. the headset lost tracking); the view stays until it recovers.

CalibrationHint

enum

Value	Meaning	Default panel text
None	Nothing to do.	—
StepIntoView	The cameras see nobody.	Step into the capture area so the cameras can see you.
HeadsetTrackingLost	The headset lost its own tracking.	Headset tracking lost. Make sure the room is well lit.
FindingYou	The wearer isn't recognised yet.	Walk a few steps so the system can find you.
HoldStill	Needs a steady look for a moment.	Hold still for a moment and look straight ahead.
KeepWalking	Roughly lined up; finishing.	Walk a few more steps to finish aligning.