Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

モーション コントローラー キーの使用非推奨について

Motion Controller キーは、OpenXR 仕様で定義された一般的な XR コントローラー固有のキーを支持すること、 4.24 において非推奨となりました。この変更により、各コントローラー モデルに対する入力バインドがカスタマイズしやすくなり、モーション コントローラー キーを物理コントローラ ボタンにマッピングする際の混乱が取り除かれました。

新しいキーを使用することで、アクション システム関連でビルドされている Steam VR Input と OpenXR に対するプロジェクトのサポートが改善されます。新しい XR 入力システムは、プロジェクトがターゲットとする特定のコントローラーをエミュレートすることで、デバイス間での互換性提供を目的としています。

非推奨の間、モーション コントローラー キーを使っている既存の入力もサポートされますが、モーション コントローラー キーを使った新規入力の追加はできません。新しい入力にはすべて新しい XR キーを使う必要があります。ただし、新旧のキーを互いに使用することができるため、古い入力のアップグレードを少しずつ行うことができます。

既存のプラグインとの相違点

SteamVR

UE4.24 では、レガシー入力が取り除かれ、その代わりに SteamVR 入力プラグインが導入されました。SteamVR 入力プラグインは Valve によって開発され、エンジンの初期のバージョンからマーケットプレイスで利用することができました。

SteamVR 入力はネイティブ アクション システムです。つまり、最低レベルではすべての入力はアクションによって処理されます。そのため、アクション システムを使用しないブループリントとの後方互換性を維持することができません。ただし、プロジェクトですでにアクション システムを使用しているのであれば、モーション コントローラー キーとの後方互換性は維持されます。

Oculus

Oculus プラグインは、ブループリントで直接使用している場合でも非推奨のモーション コントローラー キーを完全にサポートします。

新しい XR キーを使うと、Oculus Go コントローラーおよび Oculus Touch コントローラーはそれぞれに専用のキーで異なるバインドを作成することが可能になりました。もう 1 セットのキーが必要な場合は、 bGoKeysMappedToTouch=1 BaseEngine.ini. [OculusTouch.Settings] セクションに追加することで、Oculus Go を Touch キーに割り当てることが可能です。ただし、それぞれのアクションに単にキーを 2 つ追加する方法をお勧めします。

Windows Mixed Reality

このプラグインに対しては後方互換性が完全に維持されます。Windows Mixed Reality モーション コントローラー用に新しい XR キーが追加された点が異なります。

4.23 以前のバージョンからの移行について

大きな変更点は、ブループリントでは XR キーを直接使用することができない点です。すべての入力はアクション システムを経由しなければなりません。プロジェクトでアクション システムをまだ使用していない場合は、この機会にアップグレードすると良いでしょう。SteamVR および OpenXR 用にパッケージ化を行う場合、プロジェクトが確実に機能させることができます。

1. アクション システムをまだ使用していない場合は、使用するようにアップグレードします。 アクション システムの使用に関するチュートリアルは、 こちら になります。 which has been deprecated for MotionController (R) Shoulder に対して非推奨とされている InputKey Event specifies FKey 'MotionController_Right_Shoulder' などの非推奨キーをブループリントで使用している場合、ブループリント コンパイラが警告を出します。

2. 新しい XR キーを使用するために既存のアクションをアップグレードします。 既存のモーション コントロール キーを除去して、新しい XR キーのモーション コントロール キーに置き換えます。XR キーをサポートする各コントローラーのアクションに追加します。 現在積極的にサポートしていないコントローラーからキーを追加しないでください。サポートするコントローラーの 1 つをエミュレートするために、SteamVR または OpenXR 実行時までそのままにしておくことができます。

3. For compatibility with SteamVR と互換性を維持するために、すべての Thumbstick 軸と Trackpad 軸は、サフィックスが縦軸または横軸に応じて _X と _Y となります。