共用方式為


SpatialLocator 類別

定義

提供相對於使用者周圍追蹤之裝置位置的存取權,例如 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
屬性

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

發生于裝置的空間位置系統因為閒置而停用時。

適用於

另請參閱