OpenXRSpatialCapabilityConfigurationAprilTag
Конфигурация AprilTag с выбранным словарём.
Конфигурация для CreateSpatialContext, а не сама обнаруженная Entity, tracker или разрешение ОС. Требуется поддержанная capability в работающей OpenXR-сессии. Успешный constructor и выбранный dictionary не означают, что устройство умеет обнаруживать этот тип. HasValidConfiguration проверяет текущую пригодность; context создаётся отдельно асинхронно.
GetConfiguration возвращает borrowed native pointer; не подставляйте его вместо RID и не сохраняйте после lifetime ресурса. GetEnabledComponents читает выбранный список, который может быть пуст до построения конфигурации. Само чтение не получает данные комнаты/маркера.
Source observation: повторный поддержанный GetConfiguration добавляет Marker/Bounded2D без очистки списка и может создать дубли. Создавайте свежий configuration для нового context; не вызывайте native getter многократно ради диагностики. С поддержанной сессией это не воспроизводилось.
Настройка spatial entities. На Windows XR-off выполнены 12 проверок неактивных конфигураций и dictionary metadata. Реальные headers/context/discovery, смена сессии и шлем не проверены. Движок не менялся.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
OpenXRSpatialCapabilityConfigurationAprilTagКонструктор
public OpenXRSpatialCapabilityConfigurationAprilTag();Создаёт принадлежащую вызывающему RefCounted конфигурацию, не capability singleton и не context. Constructor не запускает OpenXR, detector или запросы. До поддержанного GetConfiguration список компонентов пуст; держите ресурс живым при native использовании. Собственный экземпляр можно Dispose после завершения использования и удаления ссылок; engine-owned конфигурацию не освобождайте.
Свойства1
AprilDictСвойство
public OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict AprilDict { get; set; }Выбранный AprilTag dictionary в enum AprilTagDict. Constructor читает project setting marker_tracking/april_tag_dict; текущий default 3 даёт 36H11. Setter сохраняет выбор до создания нового context; не добавляет поддержку runtime, не декодирует код и не запускает detector. Согласуйте со словарём физических маркеров.
Методы3
GetAprilDictOpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict
public OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict GetAprilDict();Выбранный AprilTag dictionary в enum AprilTagDict. Constructor читает project setting marker_tracking/april_tag_dict; текущий default 3 даёт 36H11. Setter сохраняет выбор до создания нового context; не добавляет поддержку runtime, не декодирует код и не запускает detector. Согласуйте со словарём физических маркеров.
OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDictВыбранный AprilTag dictionary в enum AprilTagDict. Constructor читает project setting marker_tracking/april_tag_dict; текущий default 3 даёт 36H11. Setter сохраняет выбор до создания нового context; не добавляет поддержку runtime, не декодирует код и не запускает detector. Согласуйте со словарём физических маркеров.
GetEnabledComponentslong[]
public long[] GetEnabledComponents();Копия сохранённого списка component types как long[], не payload маркера. Поддержанный GetConfiguration добавляет Marker и Bounded2D; до него список пуст. В текущих исходниках marker implementations добавляют элементы без очистки при повторном вызове — возможны дубли. Активный случай не воспроизводился; создавайте свежую configuration для нового context вместо повторного диагностического GetConfiguration.
long[]Копия сохранённого списка component types как long[], не payload маркера. Поддержанный GetConfiguration добавляет Marker и Bounded2D; до него список пуст. В текущих исходниках marker implementations добавляют элементы без очистки при повторном вызове — возможны дубли. Активный случай не воспроизводился; создавайте свежую configuration для нового context вместо повторного диагностического GetConfiguration.
SetAprilDictvoid
public void SetAprilDict(OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict aprilDict);Выбранный AprilTag dictionary в enum AprilTagDict. Constructor читает project setting marker_tracking/april_tag_dict; текущий default 3 даёт 36H11. Setter сохраняет выбор до создания нового context; не добавляет поддержку runtime, не декодирует код и не запускает detector. Согласуйте со словарём физических маркеров.
| Имя | Тип | По умолчанию |
|---|---|---|
aprilDict | OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict | — |
aprilDictВыбранный AprilTag dictionary в enum AprilTagDict. Constructor читает project setting marker_tracking/april_tag_dict; текущий default 3 даёт 36H11. Setter сохраняет выбор до создания нового context; не добавляет поддержку runtime, не декодирует код и не запускает detector. Согласуйте со словарём физических маркеров.
OpenXRSpatialCapabilityConfigurationAprilTag.AprilTagDict
| Значение | Описание |
|---|---|
Dict16H5 = 1 | 4 на 4 бита, минимальное расстояние Хэмминга между любыми двумя кодами = 5, 30 кодов. |
Dict25H9 = 2 | 5 на 5 бит, минимальное расстояние Хэмминга между любыми двумя кодами = 9,35 кодов. |
Dict36H10 = 3 | 6 на 6 бит, минимальное расстояние Хэмминга между любыми двумя кодами = 10, 2320 кодов. |
Dict36H11 = 4 | 6 на 6 бит, минимальное расстояние Хэмминга между любыми двумя кодами = 11, 587 кодов. |