開発

Unreal Engineでテキスト入力のキーボードオーバーレイを有効にする

更新日時: 2026/04/17

ホーム環境内のテキストフィールドがフォーカスを受け取ると、Questシステムにより、画面上にキーボードオーバーレイが表示されます。一例として、ユーザーが検索オプションを選択した場合があります。

システムキーボードは、使いやすい一貫したインターフェイスでユーザーがテキストを入力できるように、アプリの上部に表示することもできます。キーボードオーバーレイにより、音声入力、スマートフォン入力、複数言語レイアウトが提供されます。キーボードオーバーレイでは、[Settings (設定)] > [System (システム)] > [Language and Region (言語と地域)] > [Language (言語)]でリストされるすべての言語がサポートされます。スペースバーの右側にあるワールドアイコンを選択すると、表示されたキーボード言語を変更できます。

次の画像は、ユーザーが検索バーをクリックした時点でシステムによって表示される英語キーボードオーバーレイの例です。

キーボードオーバーレイのサポートを統合する

設定を使用して、ユーザーがテキストフィールドを選択したときにキーボードオーバーレイを自動的に表示することも、手動でキーボードを表示することもできます。

前提条件

Meta XRプラグインをインストールしておく必要があります。
注: Meta XRプラグインを最近アップグレードした場合、キーボードオーバーレイ機能を使うためにはMeta Questデバイスを再起動する必要があるかもしれません。
フォーカス検知を有効にする必要があります。この設定はデフォルトでオンになっていますが、それが有効になっているかどうかを確認できます。Unrealエディターで、[Edit (編集)] > [Project Settings (プロジェクト設定)] > [Plugins (プラグイン)] > [Meta XR] > [Mobile (モバイル)] > [Focus Aware (フォーカス検知)]に移動します。詳しくは、オーバーレイと入力フォーカスをご覧ください。

プロジェクト設定によりシステムキーボードを有効にする

システムキーボードを有効にした場合、編集可能なUIエレメントが入力フォーカスを受け取った時点でそれが自動的に表示されます。

システムキーボードを有効にするには、次の変更を加えます。

[Edit (編集)] > [Project Settings (プロジェクト設定)] > [Platforms (プラットフォーム)] > [Android] > [APK Packaging (APKパッケージング)]に移動し、[Enable improved virtual keyboard (改善された仮想キーボードの有効化)]が選択されてオンになっていることを確認します。次の画像は、この設定を示しています。
[Edit (編集)] > [Project Settings (プロジェクト設定)] > [Plugins (プラグイン)] > [Meta XR] > [Mobile (モバイル)]に移動し、[Requires System Keyboard (システムキーボードが必要)]をチェックしてオンにします。これにより、oculus.software.overlay_keyboardのエントリーがアプリマニフェストに追加され、ランタイムに対してVRキーボードを使うように指示します。次の画像は、この設定を示しています。

この設定が有効になっている場合、キーボードが表示されると、アプリは入力フォーカスを失います。つまり、HasInputFocusフラグはfalseを返します。キーボードを終了すると、フォーカスはアプリに戻ります。

システムキーボードを手動で表示する

UnrealのFSlateApplication::ShowVirtualKeyboard⁠関数を呼び出して、システムキーボードを手動で表示することができます。キーボード設定と同じように、手動でキーボードを表示すると、アプリは入力フォーカスを失い、HasInputFocusフラグはfalseを返します。キーボードを終了すると、フォーカスはアプリに戻ります。

キーボードオーバーレイを統合したら、テキスト入力エクスペリエンスを構築する際に以下の設計ガイドラインを参照してください。