SpatialInteractionSource 類別

定義

命名空間:

Windows.UI.Input.Spatial

代表一個偵測到的手部、動作控制器或語音來源實例，這可能會導致互動和手勢。

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

Public NotInheritable Class SpatialInteractionSource

繼承

Object Platform::Object IInspectable SpatialInteractionSource

屬性

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

備註

對於手部和控制器，每個偵測到的手部或運動控制器都會取得自己的識別碼。 只要系統可以追蹤手部與先前偵測到的手部相同，它就會共用識別碼。

針對語音，單一識別碼將用於所有語音輸入。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1703	15063	控制器
1703	15063	IsGraspSupported
1703	15063	IsMenuSupported
1703	15063	IsPointingSupported
1703	15063	TryGetStateAtTimestamp
1709	16299	手部
1903	18362	TryCreateHandMeshObserver
1903	18362	TryCreateHandMeshObserverAsync

屬性

Controller	表示偵測到之動作控制器的詳細資料。
Handedness	取得互動來源代表使用者的左手還是右手。
Id	取得手部、運動控制器或語音來源的識別碼。
IsGraspSupported	取得來源是否支援擷取。
IsMenuSupported	取得來源是否支援功能表按下。
IsPointingSupported	取得來源是否可以提供指標姿勢。
Kind	取得互動來源類型。

方法

TryCreateHandMeshObserver()	同步要求 HandMeshObserver 為追蹤手部偵測到圖形的每個畫面提供網格更新。
TryCreateHandMeshObserverAsync()	要求 HandMeshObserver 為追蹤手部偵測到圖形的每個畫面提供網格更新。
TryGetStateAtTimestamp(PerceptionTimestamp)	從指定的時間戳記開始取得此來源的狀態。

另請參閱

• 空間互動來源範例