OpenXRSpatialEntityTracker

public OpenXRSpatialEntityTracker();

Creates a caller-owned RefCounted tracker without starting OpenXR, registering with XRServer or detecting anything. Base state is Paused, category Anchor, entity/context RIDs empty. Real applications normally use the borrowed provider-registered tracker rather than a synthetic resource. Release your own instance after removing owned references/registration.

public Rid Entity { get; set; }

Runtime spatial-entity RID, not a game-tree Entity or persistence UUID. Initially empty. Assignment gives the tracker responsibility for this RID: replacing/destroying the tracker frees its previous entity through the spatial extension. Do not free a built-in tracker RID yourself or assign arbitrary Rids; IsValid does not verify a live owner.

public OpenXRSpatialEntityTracker.EntityTrackingState SpatialTrackingState { get; set; }

Spatial tracking state, initially Paused: Tracking, Paused or Stopped. The setter updates metadata and emits SpatialTrackingStateChanged on change; it creates no pose, starts no discovery and validates no position. Also require GetPose("default").HasTrackingData before using a pose.

public void AddNext(OpenXRStructureBase next);

Prepends a structure, setting its Next to the previous head. Null is ignored; a successful addition emits NextChanged. Mutates the supplied structure links; use a distinct instance and never insert an already linked structure again, which can create a cycle. Requests no runtime capability.

public Rid GetEntity();

Runtime spatial-entity RID, not a game-tree Entity or persistence UUID. Initially empty. Assignment gives the tracker responsibility for this RID: replacing/destroying the tracker frees its previous entity through the spatial extension. Do not free a built-in tracker RID yourself or assign arbitrary Rids; IsValid does not verify a live owner.

public OpenXRStructureBase GetNext();

Borrowed first OpenXRStructureBase in the additional-structure chain, or null. A linked extension-parameter list, not child Entities. Do not mutate/dispose provider-owned structures; detach newly owned structures before releasing them.

public Rid GetSpatialContext();

Spatial-context RID, initially empty. After a valid RID is assigned, the setter rejects a different context, including empty; create a new tracker instead. Reading transfers no context ownership; do not free engine-owned default contexts. The setter does not establish OpenXR context readiness.

public OpenXRSpatialEntityTracker.EntityTrackingState GetSpatialTrackingState();

Spatial tracking state, initially Paused: Tracking, Paused or Stopped. The setter updates metadata and emits SpatialTrackingStateChanged on change; it creates no pose, starts no discovery and validates no position. Also require GetPose("default").HasTrackingData before using a pose.

public void RemoveNext(OpenXRStructureBase next);

Unlinks the first matching reference, clears that structure Next and emits NextChanged. Null/absent entries do nothing. Destroys no resource and cancels no submitted asynchronous request; do not edit provider-owned chains.

public void SetEntity(Rid entity);

Runtime spatial-entity RID, not a game-tree Entity or persistence UUID. Initially empty. Assignment gives the tracker responsibility for this RID: replacing/destroying the tracker frees its previous entity through the spatial extension. Do not free a built-in tracker RID yourself or assign arbitrary Rids; IsValid does not verify a live owner.

public void SetSpatialContext(Rid spatialContext);

Spatial-context RID, initially empty. After a valid RID is assigned, the setter rejects a different context, including empty; create a new tracker instead. Reading transfers no context ownership; do not free engine-owned default contexts. The setter does not establish OpenXR context readiness.

public void SetSpatialTrackingState(OpenXRSpatialEntityTracker.EntityTrackingState spatialTrackingState);

Spatial tracking state, initially Paused: Tracking, Paused or Stopped. The setter updates metadata and emits SpatialTrackingStateChanged on change; it creates no pose, starts no discovery and validates no position. Also require GetPose("default").HasTrackingData before using a pose.

public event Action NextChanged;

Additional-structure list change through AddNext/RemoveNext. Establishes no changed pose, discovery or runtime application. Directly changing a structure Next need not pass through this signal.

public event OpenXRSpatialEntityTracker.SpatialTrackingStateChangedEventHandler SpatialTrackingStateChanged;

Spatial-state change signal; its C# argument is long. Convert to EntityTrackingState after checking the expected value. Reassigning an equal state emits nothing. This establishes neither valid pose nor ready geometry; handle visibility and collision separately.