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