SpatialLocator 類別

定義

命名空間:

Windows.Perception.Spatial

提供相對於使用者周圍追蹤之裝置位置的存取權，例如 HoloLens 或其他Mixed Reality頭戴式裝置。

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 之類的Mixed Reality頭戴式裝置上，這些參考畫面可用於全像攝影轉譯，以及基於裝置周圍表面的考慮。

屬性

Locatability

取得裝置空間位置系統的目前狀態。

方法

CreateAttachedFrameOfReferenceAtCurrentHeading()	建立一個參考框架，其位置附加至這個 SpatialLocator，其目前方向為固定標題。
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	建立參考框架，這個框架會以目前方向作為固定標題，並以指定的相對位置的原點位移，定位到這個 SpatialLocator。
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	建立一個參考框架，這個框架會以目前方向作為固定標題，並以其原點位移和由指定的相對位置和方向旋轉。。
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	發生于裝置的空間位置系統因為閒置而停用時。

另請參閱

• 標籤全像投影範例