SpatialAnchor Класс

Определение

Пространство имен:

Windows.Perception.Spatial

Представляет систему координат, которая строго привязана к точке в окружении пользователя.

public ref class SpatialAnchor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialAnchor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialAnchor

Public NotInheritable Class SpatialAnchor

Наследование

Object Platform::Object IInspectable SpatialAnchor

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v2.0)

Комментарии

Вы можете создать Объект SpatialAnchor в любой позиции и ориентации в spatialCoordinateSystem по вашему выбору. Устройство должно быть в состоянии найти систему координат в данный момент, и система не должна достичь предела пространственных привязок.

После определения система координат SpatialAnchor постоянно корректируется, чтобы сохранить точное положение и ориентацию исходного расположения. Затем вы можете использовать этот SpatialAnchor для отрисовки голограмм, которые будут отображаться фиксированными в окружении пользователя в точном расположении.

Эффекты корректировки, которые удерживают привязку на месте, увеличиваются по мере увеличения расстояния от привязки. Следует избегать отрисовки содержимого относительно привязки, которая находится более чем в 3 метрах от источника этой привязки.

Вы можете сохранить SpatialAnchor с помощью класса SpatialAnchorStore , а затем вернуть его в будущий сеанс приложения.

Свойство CoordinateSystem получает систему координат, которая позволяет размещать содержимое относительно привязки, при этом применяется смягчение, когда устройство настраивает точное расположение привязки.

Используйте свойство RawCoordinateSystem и соответствующее событие RawCoordinateSystemAdjusted для самостоятельного управления этими корректировками.

Система координат является правой рукой с +y вверх, +x справа и -z вперед.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	RemovedByUser

Свойства

CoordinateSystem	Возвращает систему координат привязки с примененными корректировками для облегчения.
RawCoordinateSystem	Возвращает систему координат привязки без применения реалистичной анимации.
RemovedByUser	Возвращает значение, указывающее, была ли сохраненная привязка удалена пользователем.

Методы

TryCreateRelativeTo(SpatialCoordinateSystem)	Создает привязку в начале указанной системы координат.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Создает привязку в определенной позиции в указанной системе координат.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Создает привязку в определенной позиции и ориентации в указанной системе координат. Это может возвращать значение NULL, если система достигла предела для пространственных привязок. Он также может возвращать значение NULL, если указанная система координат не может находиться в этом кадре.

События

RawCoordinateSystemAdjusted

Происходит, когда устройство настраивает точное расположение привязки, что обновляет RawCoordinateSystem.