SpatialInteractionSourceState.TryGetPointerPose メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーの頭の視線入力、目の視線入力、各モーション コントローラーのポインター姿勢など、この状態が取得されたときのタイムスタンプに対して使用可能なポインターのポーズスナップショット取得します。
public:
virtual SpatialPointerPose ^ TryGetPointerPose(SpatialCoordinateSystem ^ coordinateSystem) = TryGetPointerPose;
SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem const& coordinateSystem);
public SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem coordinateSystem);
function tryGetPointerPose(coordinateSystem)
Public Function TryGetPointerPose (coordinateSystem As SpatialCoordinateSystem) As SpatialPointerPose
パラメーター
- coordinateSystem
- SpatialCoordinateSystem
ポインターのポーズを表す座標系。
戻り値
ポインターのポーズ。
注釈
手のジェスチャ、モーション コントローラーの押下、音声操作などの空間相互作用を対象とする場合、アプリでは、操作の SpatialInteractionSource の性質に基づいて、対話の SpatialPointerPose から使用可能なポインティング レイを選択する必要があります。
- 対話ソースがポイントをサポートしていない場合 (IsPointingSupported が false)、アプリはユーザーの頭の視線入力に基づいてターゲットにする必要があります。 これは Head プロパティを通じて使用できます。
- 対話ソースがポインティングをサポートしている場合 (IsPointingSupported が true の場合)、アプリは代わりに、 TryGetInteractionSourcePose メソッドを通じて使用できるソースのポインターの姿勢に基づいてターゲットを設定できます。
その後、アプリは、選択したポインティング レイを独自のホログラムまたは空間マッピング メッシュと交差させ、カーソルをレンダリングし、ユーザーが何を操作しようとしているかを判断する必要があります。
操作が開始されると、[ 操作 ] または [ ナビゲーション ] ジェスチャと同様に、手またはコントローラーの相対モーションを使用してジェスチャを制御できます。
このメソッドは、指定した座標系を現時点で見つけられない場合に null を返します。