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 提供时间戳属性表示的时间可用的指向射线集。

当针对空间交互（例如手势、运动控制器按下或语音交互）时，应用应根据交互的 SpatialInteractionSource 的性质，从交互的 SpatialPointerPose 中选择可用的指向射线：

• 如果交互源不支持指向 (IsPointingSupported 为 false) ，则应用应基于用户的头部凝视（可通过 Head 属性获取）为目标。
• 如果交互源确实支持指向 (IsPointingSupported 为 true) ，则应用可能会根据源的指针姿势（可通过 TryGetInteractionSourcePose 方法获取）定向。

然后，应用应将所选指向射线与其自己的全息影像或空间映射网格相交，以呈现光标并确定用户打算与之交互的内容。

交互开始后，可以使用手部或控制器的相对运动来控制手势，就像 操作 或 导航 手势一样。

版本历史记录

Windows 版本	SDK 版本	已添加值
1703	15063	TryGetInteractionSourcePose
1903	18362	眼睛
1903	18362	IsHeadCapturedBySystem

属性

Eyes	获取用户对此时间戳的视线。
Head	获取用户对此时间戳的头部凝视。
IsHeadCapturedBySystem	获取 (阻止将凝视驱动的按下传递到与此 SpatialPointerPose) 关联的视图时，系统 UI 是否正在捕获用户的头部凝视。
Timestamp	获取确定指向射线时的时间戳。

方法

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	获取指定时间戳的头部凝视和运动控制器指针姿势。
TryGetInteractionSourcePose(SpatialInteractionSource)	获取给定时间戳处特定空间交互源（例如运动控制器）的指针姿势。