入力アクション — MRTK2

[アーティクル]
07/12/2023

Input Actionsは、入力を生成する特定の入力ソースからアプリケーションロジックを分離するための作業入力を抽象的に行えるようにするものです。たとえば、 [選択] アクションを定義して、マウスの左ボタン、ゲームパッドのボタン、6 つの DOF コントローラーのトリガーにマップすると便利な場合があります。これにより、アプリケーションロジックが [選択] 入力のアクションイベントをリッスンするようになり、それを生み出すことができるすべての異なる入力を認識する必要がなくなります。

入力アクションの作成

入力アクションは、Mixed Reality Toolkit ツールキットコンポーネントの入力システムプロファイル内の入力アクションプロファイルで構成され、アクションの名前と、マップ可能な入力の種類 (軸の制約) を指定します。

軸の制約で最もよく使用される値を次に示します。

軸の制約	説明
デジタル	ゲームパッドまたはマウスのバイナリボタンのようなオン/オフの入力。
1 つの軸	ゲームパッドのアナログトリガーのような 1 つの軸のアナログ入力。
デュアル軸	サムスティックのようなデュアル軸のアナログ入力。
6 つの DOF	6 つの DOF コントローラーによって生成されるような平行移動と回転を備えている 3D 姿勢。

完全な一覧については、「AxisType」を参照してください。

アクションへの入力のマッピング

入力をアクションにマップする方法は、入力ソースの種類によって異なります。

コントローラーの入力

[入力システムプロファイル] の下にある [コントローラー入力マッピングプロファイル] にアクセスします。サポートされているすべてのコントローラーの一覧が表示されます。

構成するものを選択すると、ダイアログウィンドウがすべてのコントローラー入力と共に表示され、それぞれに対してアクションを設定できます。

音声入力

音声コマンドプロファイルの、入力システムプロファイルの下に、現在定義されている音声コマンドの一覧が表示されます。そのうちの 1 つをアクションにマップするには、[アクション] ドロップダウンで選択するだけです。

ジェスチャ入力

[入力システムプロファイル] の下にある [ジェスチャプロファイル] には、定義されているジェスチャがすべて含まれています。 [アクション] ドロップダウンで選択して、それぞれをアクションにマップできます。

入力アクションの処理

警告

現在、このセクションで説明するメソッドを使用して処理できるのは、デジタル型の入力アクションだけです。その他のアクションの種類については、その代わりに対応する入力のイベントを直接処理する必要があります。たとえば、コントローラー入力にマップされた 6 つの DOF アクションを処理するには、IMixedRealityGestureHandler<T> を T = MixedRealityPose と共に使用する必要があります。

入力アクションを処理する最も簡単な方法は、InputActionHandler スクリプトを使用することです。これにより、リッスンするアクションを定義し、Unity イベントを使用してアクションの開始イベントと終了イベントに応答することができます。

より詳細な制御が必要な場合は、 IMixedRealityInputActionHandler インターフェイスをスクリプトで直接実装できます。ハンドラーインターフェイスを介したイベント処理の詳細については、「入力イベント」のセクションを参照してください。

使用例

アクションを作成し、コントローラー、音声とジェスチャの入力にマップし、それを使用してコマンドでオブジェクトを回転させる方法を示すシーンの例については、「MRTK/Examples/Demos/Input/Scenes/InputActions」を参照してください。

次の方法で共有