コントローラーインプットとトラッキングのスタートガイド

• Questコントローラーの処理をUnreal Engineプロジェクトに追加する。
• コントローラーのトリガーを通じてユーザーインプットを受け取る。
• ユーザーがコントローラーのサムスティックを押した時点でインプットを受け取る。
• ハプティックフィードバックを提供する。
• コントローラーの位置と回転情報(6DOF)を受け取る。

1. [コンテンツドロワー]で、*ゲームモードベースを親クラスとして、Blueprintクラスアセットを新たに作成します。新しいアセットに、実際の用途に適した名前を付けます。この例では、ControllerGameModeという名前にしています。
   
2. [コンテンツドロワー]で、*ポーンを親クラスとして、Blueprintクラスアセットを新たに作成します。新しいアセットに、実際の用途に適した名前を付けます。この例では、ControllerPawnという名前にしています。
   
3. [ウィンドウ]メニューで[ワールドの設定]を選択します。新しい[ゲームモード]アセットを[GameModeオーバーライド]プロパティに割り当てることにより、該当するゲームモードがアプリ実行時に使われるようにします。
   
4. [コンテンツドロワー]で、[ゲームモード]アセットをダブルクリックして編集用に開きます。[Blueprintエディター]ツールバーで、[クラスのデフォルト]がまだ選択されていなければクリックします。新しいポーンアセットを[デフォルトポーンクラス]プロパティに代入することにより、自分のゲームモードで自分のポーンクラスが使われるようにします。
   

1. [コンテンツドロワー]で、新しいインプットアクションアセットを追加します。これは、右コントローラーの[A]ボタンを押す動作用なので、それに応じた名前を指定します。この例では、XR_R_A_InputActionという名前にしています。
   
2. アクセス対象となるその他すべてのインプットについてこの処理を繰り返します。このガイドでは、最低でも[A]ボタンを押した場合のインプットアクションと、グリップ軸が必要です。軸インプットのためのインプットアクションを追加する場合は、アセットをダブルクリックし、[値の型]プロパティに適切な型を設定する必要があります。
3. [コンテンツドロワー]で、新しい[インプットマッピングコンテキスト]アセットを追加し、それに適切な名前を指定します。この例では、XRInputMappingContextという名前にしています。
   
4. [インプットマッピングコンテキスト]アセットをダブルクリックして編集し、インプットアクションごとにMappings配列に項目を追加して、それぞれを対応するインプットに関連付けます。
   

1. [コンテンツドロワー]で、ポーンアセットをダブルクリックして編集用に開きます。
2. [コンポーネント]パネルで、DefaultSceneRootコンポーネントの下にモーションコントローラーコンポーネントを新たに追加します。新しいコンポーネントの名前として、LeftMotionControllerを指定します。
   
3. LeftMotionControllerコンポーネントが選択されている状態で、[詳細]パネルで[モーションソース]プロパティを[左]に設定します。
4. [Components (コンポーネント)]パネルで、DefaultSceneRootコンポーネントの下にMotion Controller (モーションコントローラー)コンポーネントを新たに追加します。新しいコンポーネントの名前として、RightMotionControllerを指定します。
   
5. RightMotionControllerコンポーネントが選択されている状態で、[詳細]パネルで[モーションソース]プロパティを[右]に設定します。
6. [コンポーネント]パネルで、LeftMotionControllerコンポーネントの下にOculusXRControllerコンポーネントを新たに追加します。コンポーネントの名前としてLeftOculusXRControllerを指定します。
   
7. LeftOculusXRControllerコンポーネントが選択されている状態で、[詳細]パネルで[骨格タイプ]プロパティを[左]に設定します。
8. [コンポーネント]パネルで、RightMotionControllerコンポーネントの下にOculusXRControllerコンポーネントを新たに追加します。コンポーネントの名前としてRightOculusXRControllerを指定します。
   
9. LeftOculusXRControllerコンポーネントが選択されている状態で、[詳細]パネルで[骨格タイプ]プロパティを[右]に設定します。
10. [コンポーネント]パネルで、DefaultSceneRootコンポーネントの下にカメラコンポーネントを新たに追加します。コンポーネントの名前として、VRCameraを指定します。
    

1. [イベントグラフ]で、[プレイ開始]イベントの横を右クリックし、[ヘッドマウンスディスプレイが有効]を選択します。
   
2. [ヘッドマウンスディスプレイが有効]ノードのアウトプットピンをドラッグして引き出し、[ブランチ]を選択します。
   
3. [プレイ開始]イベントのアウトプットexecピンからの接続を、Branchノードのインプットexecピンまでドラッグします。
4. Branchノードのアウトプットexecピンをドラッグして引き出し、[トラッキングの原点を設定]を選択します。
   
5. [トラッキング原点を設定]機能で、[原点]ピン値を[ローカルフロア]に設定します。
6. [トラッキング原点を設定]機能の後ろを右クリックし、[プレイヤーのコントローラーを取得]を選択します。
   
7. [プレイヤーのコントローラーを取得]ノードのアウトプットピンをドラッグして引き出し、[EnhancedInputLocalPlayerSubsystemを取得]を選択します。
   
8. [拡張インプットローカルプレイヤーサブシステム]ノードをドラッグして引き出し、[マッピングコンテキストを追加]を選択します。
   
9. [マッピングコンテキストを追加]機能で、[マッピングコンテキスト]ピン値を、前に作成した[インプットマッピングコンテキスト]アセットを参照するように設定します。
   
10. [トラッキング原点を設定]機能のアウトプットexecピンから、[マッピングコンテキストを追加]機能のインプットexecピンまで接続をドラッグします。

1. [マイBlueprint]パネルの[コンポーネント]セクションにあるRightOculusXRControllerコンポーネントを、[ティック]イベントの横にある[イベントグラフ]までドラッグします。[RightOculusXRControllerを取得]を選択します。
   
2. RightOculusXRControllerノードのアウトプットピンをドラッグして引き出し、[Get Motion Controller Data]を選択します。
   
3. Get Motion Controller Data関数で、[Hand (手)]ピン値を[Right (右)]に設定します。
   
4. Tickイベントのアウトプットexecピンから、Get Motion Controller Data関数のインプットexecピンまでドラッグしてつなげます。
5. Get Motion Controller Data関数の[Motion Controller Data (モーションコントローラーデータ)]アウトプットピンをドラッグして引き出し、[Promote to Variable (変数に昇格)]を選択します。
   
6. [マイBlueprint]パネルの[Variables (変数)]セクションで、新しい変数の名前としてRight Motion Controller Dataを指定します。
   
7. Setノードのアウトプットピンをドラッグして引き出し、[Break XRMotionControllerData]を選択します。
   
8. [XRMotionControllerDataを破棄]ノードの下矢印をクリックして、アウトプットピンをすべて公開します。
9. [設定]ノードのアウトプットexecピンをドラッグして引き出し、[文字列の出力]を選択します。
   
10. [XRMotionControllerDataを破棄]ノードの[照準位置]アウトプットピンから、[文字列を出力]機能の[入力文字列]インプットピンまで接続をドラッグします。
    
11. [Blueprintエディター]ツールバーの[コンパイル]ボタンをクリックして、ポーンクラスをコンパイルします。[保存]ボタンをクリックして、アセットを保存します。
12. レベルを自分のデバイス上で実行して、画面に出力されるコントローラーの位置を確認します。

• コントローラーインプットのマッピング
• Meta Quest Touch Plusコントローラー
• コントローラーの入力とトラッキングのベストプラクティス
• コントローラー入力とトラッキングのトラブルシューティング