Поделиться через


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 Platform::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 RemovedByUser

Свойства

CoordinateSystem

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

RawCoordinateSystem

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

RemovedByUser

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

Методы

TryCreateRelativeTo(SpatialCoordinateSystem)

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

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)

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

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)

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

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

События

RawCoordinateSystemAdjusted

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

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