Android 仮想キーボード

Unreal Engine 4 (UE4) Android ベースのすべてのプロジェクトは、標準ポップアップ ダイアログ入力ボックスまたはオペレーション システム仮想キーボードのいずれかの使用をサポートしています。このドキュメントでは、UE4 プロジェクトで仮想キーボードをセットアップし呼び出す方法を説明します。

手順

プロジェクトで仮想キーボードを有効にするには、以下の手順を行います。

1. メイン ツールバー から [Edit (編集)] > [Project Settings (プロジェクト設定)] オプションをクリックします。

   

2. [Project Settings (プロジェクト設定)] メニューで [Platforms] > [Android] を選び [APKPackaging] セクションの中の [Enable improved virtual keyboard Experimental (改善された仮想キーボードを有効にする)(実験的)] オプションの横にあるチェックマーク ボックスをクリックして有効にします。

   クリックしてフルサイズで表示。

3. [コンテンツ ブラウザ] を右クリックして [User Interface] を選び、[Widget Blueprint] オプションをクリックして新しいブループリントに 「Input Text」 という名前を付けます。

   

4. Input Text UMG ウィジェットをダブルクリックして開き、[Palette] から TextBox を UMG グラフへドラッグします。

   クリックしてフルサイズで表示。

5. Canvas パネルの中央にくるように TextBox を配置して [Compile] ボタンと [Save] ボタンを押します。

   クリックしてフルサイズで表示。

   入力エレメントを可視にし、バーチャル キーボードの背後で見えづらくならないように調整するのは各自のアプリケーション側です。提供されている OnVirtualKeyboardShown および OnVirtualKeyboardHidden イベント ハンドラを使って UI エレメントが仮想キーボードで隠れてしまわないようにしっかり調整してください。

6. Level ブループリント を開き、以下のノードを Event Graph に追加します。

   クリックしてフルサイズで表示。

   • Event Begin Play
   • Create Widget
   • Add to Viewport

7. Event Begin Play を Create Widget に接続し Create Widget を Add Viewport ノードに接続します。Level ブループリント は下の画像のような状態になります。

   クリックしてフルサイズで表示。

   
   

8. 次に Create Widget Blueprint ノードの Class 入力に先ほど作成した InputText ウィジェット ブリントを追加します。

   

9. レベルに 「AndroidVirtualKeyboard」 と名前を付けて保存し、[Project Settings] を開いて [Maps & Modes] の [Default Maps] で、[Editor Startup Map] と [Game Default Map] に AndroidVirtualKeyboard マップを入力します。

   クリックしてフルサイズで表示。

   
   

10. 次にメインメニューから [Launch] の隣にある小さな白い三角をクリックして、表示されたリストの中から UE4 プロジェクトをデプロイする Android デバイスを選びます。

最終結果

プロジェクトを Android デバイスで起動後、テキスト入力ボックスを押せば以下の動画のように Android システム キーボードを使ってテキストを自由に入力できるようになります。

Android.NewKeyboard コンソール変数の後に次のいずれかの数字を入力すると仮想キーボードを無効にすることができます。こうすることにより、ユーザーが異なる IME (Input Method Editor) を必要とする言語を使う場合に便利です。