SpatialRecognitionStartedEventArgs.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

ポインターのポーズを表す座標系。

ポインターはポーズをとります。

このポーズは、アクティブなジェスチャを開始するために、この認識エンジンにルーティングされた最初の SpatialInteraction のタイムスタンプから取得されます。

手のジェスチャ、モーションコントローラーの押下、音声操作などの空間相互作用を対象とする場合、アプリでは、操作の SpatialInteractionSource の性質に基づいて、対話式操作の SpatialPointerPose から使用可能なポインティングレイを選択する必要があります。

操作ソースがポイントをサポートしていない場合 (IsPointingSupported が false の場合)、アプリはユーザーの視線入力に基づいてターゲットにする必要があります。 Head プロパティを使用して使用できます。
相互作用ソースがポイントをサポートしている場合 (IsPointingSupported が true の場合)、アプリは、代わりに、 TryGetInteractionSourcePose メソッドを介して使用できるソースのポインターの姿勢に基づいてターゲットを設定できます。

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

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

このメソッドは、指定した座標系が現時点で見つからない場合に null を返します。