SpatialLocator Класс

Ссылка

Определение

Пространство имен:: Windows.Perception.Spatial

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Предоставляет доступ к расположению устройства, которое отслеживается относительно окружения пользователя, например HoloLens или другой Смешанная реальность гарнитуры.

public ref class SpatialLocator 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 SpatialLocator 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 SpatialLocator

Public NotInheritable Class SpatialLocator

Наследование: Object Platform::Object IInspectable SpatialLocator

Атрибуты: 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)

Класс SpatialLocator представляет устройство, положение и ориентацию которого могут отслеживаться Windows относительно окружения пользователя. Экземпляр SpatialLocator является источником для подключенных к указателю и стационарных опорных кадров. На Смешанная реальность гарнитуре, такой как HoloLens, эти опорные кадры можно использовать для голографической отрисовки и для рассуждений о поверхностях в мире вокруг устройства.

Свойства

Locatability

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

Методы

CreateAttachedFrameOfReferenceAtCurrentHeading()	Создает систему ссылок, которая позиционально прикреплена к этому объекту SpatialLocator с текущей ориентацией в качестве фиксированного заголовка.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	Создает систему отсчета, которая позиционально прикреплена к данному Объекту SpatialLocator с текущей ориентацией в качестве фиксированного заголовка и со смещением источника указанной относительной позицией.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	Создает систему отсчета, которая позиционально прикреплена к этому объекту SpatialLocator с текущей ориентацией в качестве фиксированного заголовка и с его смещением источника и повернута на указанное относительное положение и ориентацию.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	Создает систему отсчета, которая позиционально прикреплена к этому Объекту SpatialLocator с заданным заголовком в радианах относительно текущей ориентации и со смещением его источника указанным относительным положением и ориентацией.
CreateStationaryFrameOfReferenceAtCurrentLocation()	Создает систему отсчета, которая остается неподвижной относительно окружения пользователя, с его исходным источником в текущем расположении SpatialLocator.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	Создает систему отсчета, которая остается неподвижной относительно окружения пользователя, с ее исходным источником в указанном смещении от текущего расположения SpatialLocator.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	Создает систему отсчета, которая остается неподвижной относительно окружения пользователя, с ее исходным источником по указанному смещению от текущего расположения SpatialLocator, а затем поворачивается при указанном повороте.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	Создает систему отсчета, которая остается неподвижной относительно окружения пользователя, с ее исходным источником по указанному смещению от текущего расположения SpatialLocator вдоль указанного относительного заголовка в радианах, а затем поворачивается при указанном повороте.
GetDefault()	Возвращает экземпляр SpatialLocator, который отслеживает расположение текущего устройства, например HoloLens, относительно окружения пользователя.
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	Возвращает объект SpatialLocation, представляющий расположение устройства в указанной метке времени. Координаты внутри выражаются относительно предоставленной системы координат. Если устройство не может находиться в этой системе координат в указанной метке времени, возвращаемое значение будет иметь значение NULL. Это может произойти, например, если устройство потеряло отслеживание.

События

LocatabilityChanged	Происходит при изменении состояния системы пространственного расположения.
PositionalTrackingDeactivating	Происходит, когда система пространственного расположения устройства деактивируется из-за бездействия.

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

См. также раздел

Пример голограммы с тегами