OpenXRSpatialEntityTracker

public OpenXRSpatialEntityTracker();

Создаёт принадлежащий вызывающему RefCounted tracker без запуска OpenXR, регистрации в XRServer или обнаружения. Базовое состояние Paused, категория Anchor; Entity/context RID пусты. Для реального приложения обычно используйте заимствованный tracker, зарегистрированный provider, а не synthetic ресурс. Собственный экземпляр освобождайте после удаления своих ссылок/регистрации.

public Rid Entity { get; set; }

RID пространственного объекта runtime, не игровая Entity и не UUID. Изначально пустой. Назначение передаёт трекеру управление этим RID: замена/уничтожение трекера освобождает прежний объект через spatial extension. Не освобождайте RID встроенного трекера самостоятельно и не назначайте произвольный Rid; IsValid не проверяет живого владельца.

public OpenXRSpatialEntityTracker.EntityTrackingState SpatialTrackingState { get; set; }

Состояние пространственного tracking, изначально Paused: Tracking, Paused или Stopped. Setter меняет metadata и при отличии испускает SpatialTrackingStateChanged; не создаёт pose, не включает обнаружение и не валидирует позицию. Перед использованием также проверяйте GetPose("default").HasTrackingData.

public void AddNext(OpenXRStructureBase next);

Добавляет структуру в начало цепочки: новый Next указывает на прежнюю голову. Null игнорируется, успешное добавление испускает NextChanged. Метод меняет ссылки самой структуры; используйте отдельный экземпляр и не добавляйте уже включённую структуру повторно — возможен цикл. Не запрашивает capability у runtime.

public Rid GetEntity();

RID пространственного объекта runtime, не игровая Entity и не UUID. Изначально пустой. Назначение передаёт трекеру управление этим RID: замена/уничтожение трекера освобождает прежний объект через spatial extension. Не освобождайте RID встроенного трекера самостоятельно и не назначайте произвольный Rid; IsValid не проверяет живого владельца.

public OpenXRStructureBase GetNext();

Заимствованный первый OpenXRStructureBase в цепочке дополнительных структур либо null. Это связанный список параметров расширений, не дочерние Entity. Не изменяйте/не освобождайте provider-owned структуры; новые собственные структуры отсоединяйте перед освобождением.

public Rid GetSpatialContext();

Пространственный context RID, изначально пустой. После назначения валидного RID setter отвергает переключение на другой context, включая пустой: создавайте новый tracker. Получение не передаёт владение context; встроенный context движка не освобождайте. Сам setter не проверяет готовность OpenXR context.

public OpenXRSpatialEntityTracker.EntityTrackingState GetSpatialTrackingState();

Состояние пространственного tracking, изначально Paused: Tracking, Paused или Stopped. Setter меняет metadata и при отличии испускает SpatialTrackingStateChanged; не создаёт pose, не включает обнаружение и не валидирует позицию. Перед использованием также проверяйте GetPose("default").HasTrackingData.

public void RemoveNext(OpenXRStructureBase next);

Удаляет первое совпадение ссылки из цепочки, очищает Next удалённой структуры и испускает NextChanged. Null и отсутствующий элемент ничего не меняют. Не уничтожает ресурс и не отменяет уже отправленный асинхронный запрос; provider-owned цепочку не редактируйте.

public void SetEntity(Rid entity);

RID пространственного объекта runtime, не игровая Entity и не UUID. Изначально пустой. Назначение передаёт трекеру управление этим RID: замена/уничтожение трекера освобождает прежний объект через spatial extension. Не освобождайте RID встроенного трекера самостоятельно и не назначайте произвольный Rid; IsValid не проверяет живого владельца.

public void SetSpatialContext(Rid spatialContext);

Пространственный context RID, изначально пустой. После назначения валидного RID setter отвергает переключение на другой context, включая пустой: создавайте новый tracker. Получение не передаёт владение context; встроенный context движка не освобождайте. Сам setter не проверяет готовность OpenXR context.

public void SetSpatialTrackingState(OpenXRSpatialEntityTracker.EntityTrackingState spatialTrackingState);

Состояние пространственного tracking, изначально Paused: Tracking, Paused или Stopped. Setter меняет metadata и при отличии испускает SpatialTrackingStateChanged; не создаёт pose, не включает обнаружение и не валидирует позицию. Перед использованием также проверяйте GetPose("default").HasTrackingData.

public event Action NextChanged;

Сигнал изменения списка дополнительных структур через AddNext/RemoveNext. Не означает, что изменилась pose, обнаружен объект или runtime применил параметры. Прямое изменение поля Next самих структур не обязано проходить через этот сигнал.

public event OpenXRSpatialEntityTracker.SpatialTrackingStateChangedEventHandler SpatialTrackingStateChanged;

Сигнал смены spatial state; аргумент C# имеет тип long. Приводите к EntityTrackingState после проверки ожидаемого значения. Повторное присваивание того же состояния не испускает сигнал. Это не гарантия валидной pose или готовой геометрии; управляйте видимостью и collision отдельно.