OpenXRSpatialAnchorCapability

public OpenXRFutureResult CreateDefaultPersistenceContext(Callable userCallback = default);

Вызывает метод OpenXRSpatialAnchorCapability.CreatePersistenceContext с конфигурацией, которая, вероятно, будет работать с средой выполнения XR. user_callback вызывается при создании контекста.

public OpenXRAnchorTracker CreateNewAnchor(Transform3D transform, Rid spatialContext);

Создает новый якорь, который будет отслеживаться средой выполнения XR. Параметр transform должен представлять собой преобразование в локальном пространстве вашего узла XROrigin3D. Если параметр spatial_context не указан, будет использоваться значение по умолчанию; для этого необходимо установить параметр ProjectSettings.xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection. Возвращаемый трекер будет отслеживать местоположение в случае изменения нашего опорного пространства. Параметр next должен быть допустимым объектом next для цепочки XrSpatialAnchorCreateInfoEXT.

public OpenXRAnchorTracker CreateNewAnchor(Transform3D transform, Rid spatialContext = default, OpenXRStructureBase next = null);

Создает новый якорь, который будет отслеживаться средой выполнения XR. Параметр transform должен представлять собой преобразование в локальном пространстве вашего узла XROrigin3D. Если параметр spatial_context не указан, будет использоваться значение по умолчанию; для этого необходимо установить параметр ProjectSettings.xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection. Возвращаемый трекер будет отслеживать местоположение в случае изменения нашего опорного пространства. Параметр next должен быть допустимым объектом next для цепочки XrSpatialAnchorCreateInfoEXT.

public OpenXRFutureResult CreatePersistenceContext(OpenXRSpatialAnchorCapability.PersistenceScope scope, Callable userCallback = default);

Создает новый контекст постоянного хранения данных. Примечание: Это асинхронный метод, возвращающий объект OpenXRFutureResult, с помощью которого отслеживается статус; удаление этого объекта не отменит процесс создания. В случае успеха будет вызван user_callback, если он указан. Результатом этой функции является Rid нашего контекста постоянного хранения.

public void DoEntityUpdate(Rid spatialContext, Reckfell.Collections.Array<OpenXRSpatialComponentData> componentData, OpenXRStructureBase nextSnapshotCreate = null, OpenXRStructureBase nextSnapshotQuery = null);

Вызывает OpenXRSpatialEntityExtension.UpdateSpatialEntities и OpenXRSpatialEntityExtension.QuerySnapshot с сущностями-якорями, связанными с spatial_context. component_data — это OpenXRSpatialComponentData, которые необходимо обновить для этой возможности якоря. Если next_snapshot_create не равен null, передайте его параметру next в OpenXRSpatialEntityExtension.UpdateSpatialEntities. Если next_snapshot_query не равен null, передайте его параметру next в OpenXRSpatialEntityExtension.QuerySnapshot.

public void FreePersistenceContext(Rid persistenceContext);

Освобождает контекст постоянного хранения, ранее созданный с помощью метода OpenXRSpatialAnchorCapability.CreatePersistenceContext.

public ulong GetPersistenceContextHandle(Rid persistenceContext);

Возвращает внутренний дескриптор для данного контекста сохранения данных. Примечание: Для реализаций ReckfellExtension.

public bool IsPersistenceScopeSupported(OpenXRSpatialAnchorCapability.PersistenceScope scope);

Возвращает true, если данная область сохранения поддерживается нашей возможностью пространственной привязки. Примечание: Действительно только после создания экземпляра OpenXR.

public bool IsSpatialAnchorSupported();

Возвращает true, если аппаратное обеспечение поддерживает пространственные привязки. Возвращает допустимое значение только после инициализации OpenXR.

public bool IsSpatialPersistenceSupported();

Возвращает true, если оборудование поддерживает постоянные пространственные привязки. Возвращает допустимое значение только после инициализации OpenXR.

public OpenXRFutureResult PersistAnchor(OpenXRAnchorTracker anchorTracker, Rid persistenceContext = default, Callable userCallback = default);

Преобразует этот якорь в постоянный. Это означает, что его местоположение будет сохранено на устройстве, и якорь будет восстановлен при следующем запуске вашего приложения. Если persistence_context не указан, будет использоваться значение по умолчанию; для этого необходимо установить ProjectSettings.xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection. Примечание: Это асинхронный метод, который возвращает объект OpenXRFutureResult, с помощью которого отслеживается статус; удаление этого объекта не отменит процесс создания. В случае успеха будет вызван user_callback, если он указан. Значение результата этой функции — логическое значение, которое будет установлено в true после успешного завершения.

public void RemoveAnchor(OpenXRAnchorTracker anchorTracker);

Удалите якорь, созданный ранее с помощью метода OpenXRSpatialAnchorCapability.CreateNewAnchor. Если этот якорь был постоянным, необходимо сначала вызвать метод OpenXRSpatialAnchorCapability.UnpersistAnchor и дождаться его обратного вызова.

public OpenXRFutureResult StartEntityDiscovery(Rid spatialContext, Reckfell.Collections.Array<OpenXRSpatialComponentData> componentData, OpenXRStructureBase nextSnapshotCreate = null, OpenXRStructureBase nextSnapshotQuery = null, Callable userCallback = default);

Вызывает OpenXRSpatialEntityExtension.DiscoverSpatialEntities и OpenXRSpatialEntityExtension.QuerySnapshot с сущностями-якорями, связанными с spatial_context. component_data — это OpenXRSpatialComponentData, которые необходимо обнаружить для этой возможности якоря. Если next_snapshot_create не равен null, передайте его параметру next в OpenXRSpatialEntityExtension.DiscoverSpatialEntities. Если next_snapshot_query не равен null, передайте его параметру next в OpenXRSpatialEntityExtension.QuerySnapshot. user_callback, если он не равен null, вызывается с двумя параметрами, обычно дважды. Первый параметр — это Rid снимка обнаружения, а второй параметр — логическое значение, где false указывает, что снимок обнаружения вот-вот будет обработан, а true указывает, что снимок обнаружения был обработан и component_data содержит допустимые данные. Второй вызов пропускается, если возникла ошибка. Возвращаемый OpenXRFutureResult идентичен результату, возвращаемому методом OpenXRSpatialEntityExtension.DiscoverSpatialEntities.

public OpenXRFutureResult UnpersistAnchor(OpenXRAnchorTracker anchorTracker, Rid persistenceContext = default, Callable userCallback = default);

Удаляет постоянные данные из этого якоря. Среда выполнения не будет создавать якорь заново при перезапуске вашего приложения. Если persistence_context не указан, будет использоваться значение по умолчанию; для этого необходимо установить ProjectSettings.xr/openxr/extensions/spatial_entity/enabled. Примечание: Это асинхронный метод, который возвращает объект OpenXRFutureResult, с помощью которого отслеживается статус; удаление этого объекта не отменит процесс создания. В случае успеха будет вызван user_callback, если он указан. Значение результата этой функции — логическое значение, которое будет установлено в true после успешного завершения.