SpatialRecognitionStartedEventArgs.TryGetPointerPose メソッド

定義

名前空間:

Windows.UI.Input.Spatial

ユーザーの頭の視線入力や各モーション コントローラーのポインターの姿勢など、このジェスチャをターゲットにして使用できるポインターのポーズを取得します。

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

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

戻り値

SpatialPointerPose

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

注釈

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

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

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

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

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

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