SpatialPointerPose クラス

リファレンス

定義

名前空間:: Windows.UI.Input.Spatial

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 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 が true の場合)、アプリは代わりに、 TryGetInteractionSourcePose メソッドを通じて使用できるソースのポインターの姿勢に基づいてターゲットを設定できます。

その後、アプリは、選択したポインティングレイを独自のホログラムまたは空間マッピングメッシュと交差させ、カーソルをレンダリングし、ユーザーが何を操作しようとしているかを判断する必要があります。

操作が開始されると、[ 操作 ] または [ ナビゲーション ] ジェスチャと同様に、手またはコントローラーの相対モーションを使用してジェスチャを制御できます。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	TryGetInteractionSourcePose
1903	18362	目
1903	18362	IsHeadCapturedBySystem

プロパティ

Eyes	このタイムスタンプのユーザーの目の視線入力を取得します。
Head	このタイムスタンプのユーザーの頭の視線入力を取得します。
IsHeadCapturedBySystem	ユーザーの頭の視線入力が現在システム UI によってキャプチャされているかどうかを取得します (この SpatialPointerPose に関連付けられているビューに視線入力による押し込みが配信されないようにします)。
Timestamp	ポインティングレイが決定されたときのタイムスタンプを取得します。

メソッド

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	指定したタイムスタンプの頭の視線入力とモーションコントローラーポインターのポーズを取得します。
TryGetInteractionSourcePose(SpatialInteractionSource)	特定のタイムスタンプにある特定の空間相互作用ソース (モーションコントローラーなど) のポインターポーズを取得します。

適用対象

次の方法で共有