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


SpatialLocator Класс

Определение

Предоставляет доступ к расположению устройства, которое отслеживается относительно окружения пользователя, например 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
Атрибуты

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

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

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

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