SpatialPointerPose 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示可用于定位手势、运动控制器按下和语音交互的可用空间指针姿势，例如用户的头部凝视、眼睛凝视和每个运动控制器的指针姿势。
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 SpatialPointerPosePublic NotInheritable Class SpatialPointerPose- 继承
- 属性
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) |
获取给定时间戳处特定空间交互源（例如运动控制器）的指针姿势。 |