SpatialAnchor Класс

Определение

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

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 IInspectable SpatialAnchor
Атрибуты

Требования к 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 УдаленоByUser

Свойства

CoordinateSystem

Возвращает систему координат привязки с примененными корректировками ослабления.

RawCoordinateSystem

Возвращает систему координат привязки без применения ослабления.

RemovedByUser

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

Методы

TryCreateRelativeTo(SpatialCoordinateSystem)

Создает привязку в источнике указанной системы координат.

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)

Создает привязку в определенной позиции в указанной системе координат.

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)

Создает привязку в определенной позиции и ориентации в указанной системе координат.

Это может возвращать значение NULL, если система достигла предела для пространственных привязок. Он также может возвращать значение NULL, если указанная система координат не может находиться в этом кадре.

События

RawCoordinateSystemAdjusted

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

Применяется к