OpenXRSpatialCapabilityConfigurationPlaneTracking
Выбор компонентов обнаружения плоскостей.
Конфигурация для CreateSpatialContext, а не сама обнаруженная Entity, tracker или разрешение ОС. Требуется поддержанная capability в работающей OpenXR-сессии. Успешный constructor и выбранный dictionary не означают, что устройство умеет обнаруживать этот тип. HasValidConfiguration проверяет текущую пригодность; context создаётся отдельно асинхронно.
GetConfiguration возвращает borrowed native pointer; не подставляйте его вместо RID и не сохраняйте после lifetime ресурса. GetEnabledComponents читает выбранный список, который может быть пуст до построения конфигурации. Само чтение не получает данные комнаты/маркера.
Дополнительная поддержка Mesh2D/Polygon2D/labels кешируется по экземпляру. Создавайте конфигурацию после готовности сессии; после смены сессии не используйте прежний cached false. При наличии обоих geometric components выбирается Mesh2D.
Настройка spatial entities. На Windows XR-off выполнены 12 проверок неактивных конфигураций и dictionary metadata. Реальные headers/context/discovery, смена сессии и шлем не проверены. Движок не менялся.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
OpenXRSpatialCapabilityConfigurationPlaneTrackingКонструктор
public OpenXRSpatialCapabilityConfigurationPlaneTracking();Создаёт принадлежащую вызывающему RefCounted конфигурацию, не capability singleton и не context. Constructor не запускает OpenXR, detector или запросы. До поддержанного GetConfiguration список компонентов пуст; держите ресурс живым при native использовании. Собственный экземпляр можно Dispose после завершения использования и удаления ссылок; engine-owned конфигурацию не освобождайте.
Методы4
GetEnabledComponentslong[]
public long[] GetEnabledComponents();Копия текущего списка component types как long[], заполненного поддержанным GetConfiguration. Включает Bounded2D/PlaneAlignment; предпочитает Mesh2D, иначе Polygon2D, плюс optional semantic label. Это выбранная конфигурация, не все возможности устройства и не полученная геометрия; до построения список пуст.
long[]Копия текущего списка component types как long[], заполненного поддержанным GetConfiguration. Включает Bounded2D/PlaneAlignment; предпочитает Mesh2D, иначе Polygon2D, плюс optional semantic label. Это выбранная конфигурация, не все возможности устройства и не полученная геометрия; до построения список пуст.
SupportsLabelsbool
public bool SupportsLabels();Запрашивает поддержку plane component semantic labels через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.
boolЗапрашивает поддержку plane component semantic labels через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.
SupportsMesh2Dbool
public bool SupportsMesh2D();Запрашивает поддержку plane component Mesh2D через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.
boolЗапрашивает поддержку plane component Mesh2D через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.
SupportsPolygonsbool
public bool SupportsPolygons();Запрашивает поддержку plane component Polygon2D через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.
boolЗапрашивает поддержку plane component Polygon2D через spatial extension и кеширует результат в configuration. Вызов до готовности нужной сессии может закрепить false: создайте новую configuration после смены сессии/поддержки. True не гарантирует данные в каждом snapshot; Mesh2D при построении конфигурации имеет приоритет над polygon.