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	当设备的空间位置系统由于不活动而停用时发生。

另请参阅

• 标记全息影像示例