SpatialPointerPose 類別

定義

命名空間:

Windows.UI.Input.Spatial

代表可用的空間指標姿勢，例如使用者的頭部注視、眼部注視和每個動作控制器的指標姿勢，用於目標手勢、動作控制器按下和語音互動。

public ref class SpatialPointerPose 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 SpatialPointerPose 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 SpatialPointerPose

Public NotInheritable Class SpatialPointerPose

繼承

Object Platform::Object IInspectable SpatialPointerPose

屬性

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 引進)

備註

SpatialPointerPose會在Timestamp屬性所代表的時間提供一組可用的指向光線。

以空間互動為目標時，例如手勢、動作控制器按下或語音互動，應用程式應該根據互動的 SpatialInteractionSource本質，選擇可從互動的 SpatialPointerPose 取得的指向光線：

• 如果互動來源不支援指向 (IsPointingSupported 為 false) ，則應用程式應該根據使用者的頭部注視，透過 Head 屬性取得。
• 如果互動來源支援指向 isPointingSupported (isPointingSupported 為 true) ，則應用程式可能會改為根據來源的指標姿勢來設定目標，並透過 TryGetInteractionSourcePose 方法取得。

然後，應用程式應該與所選的指向光線與其自己的全像投影或空間對應網格交集，以轉譯游標，並判斷使用者想要與其互動的內容。

一旦開始互動，就可以使用手部或控制器的相對動作來控制手勢，就像 操作 或 導覽 手勢一樣。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1703	15063	TryGetInteractionSourcePose
1903	18362	眼睛
1903	18362	IsHeadCapturedBySystem

屬性

Eyes	取得使用者對此時間戳記的眼球注視。
Head	取得使用者對此時間戳記的頭部注視。
IsHeadCapturedBySystem	取得使用者頭部注視目前是否由系統 UI 擷取， (防止注視驅動按下傳送至與此 SpatialPointerPose 相關聯的檢視) 。
Timestamp	取得判斷指向光線時的時間戳記。

方法

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	取得指定時間戳記的頭部注視和動作控制器指標姿勢。
TryGetInteractionSourcePose(SpatialInteractionSource)	取得特定空間互動來源的指標姿勢，例如動作控制器在指定的時間戳記。