モバイルキーボード

ほとんどの場合、Unity は GUI 要素のキーボード入力を自動的にハンドリングしますがスクリプトからの要求によりキーボードを表示するのも簡単です。

GUI 要素

ユーザーが編集可能な GUI 要素をタップしたときキーボードは自動表示されます。現在では GUI.TextField、GUI.TextArea、GUI.PasswordField によりキーボードが表示されます。詳細については GUI クラス を参照してください。

手動でのキーボードハンドリング

TouchScreenKeyboard.Open() 関数を使用してキーボードを開きます。この関数が使用する引数については TouchScreenKeyboard スクリプティングリファレンスを参照してください。

キーボード種類のまとめ

キーボードは次の種類をサポートしています。

テキストプレビュー

デフォルトでは、キーボードが表示された後に編集ボックスが作成されてキーボードの上に配置されます。ユーザーが入力しているテキストのプレビューとして動作し、ユーザーはテキストを常に見ることができます。しかし、TouchScreenKeyboard.hideInput を true にすることで、テキストプレビューを無効化できます。特定のキーボードの種類および入力モードでのみ動作することに注意してください。例えば、電話キーパッドや複数行テキスト入力では動作しません。そういったケースでは、編集ボックスは必ず表示されます。TouchScreenKeyboard.hideInput はグローバル変数ですべてのキーボードに影響します。

Visibility およびキーボードサイズ

TouchScreenKeyboard には 3 つのキーボードプロパティにより、キーボードの Visibility ステータスおよび画面上のサイズを決定します。

TouchScreenKeyboard.area は、キーボードが完全に画面に表示されるまで、位置とサイズが 0 にセットされた rect を返すことに注意してください。TouchScreenKeyboard.Open の直後に値を取得すべきではありません。キーボードイベントのステップは次のとおりです。

• TouchScreenKeyboard.Open がコールされる。TouchScreenKeyboard.active が true を返す。TouchScreenKeyboard.visible が false を返す。TouchScreenKeyboard.area が (0, 0, 0, 0) を返す。
• キーボードが画面上にスライドしながら表示される。すべてのプロパティは同じままです。
• キーボードの画面上でのスライドが止まる。TouchScreenKeyboard.active が true を返す。TouchScreenKeyboard.visible が true を返す。TouchScreenKeyboard.area がキーボードの実際の位置とサイズを返す。

セキュリティのかかったテキスト入力

キーボード入力が行われるときに入力した文字を隠すことが可能です。これはユーザーにセンシティブな情報（パスワードなど）の入力を求めるときに使用してください。セキュリティのかかったテキスト入力を有効化して、キーボードをスクリプトから開くためには、次のコードを使用します。

TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true);

アラートキーボード

キーボードで、通常の不透明な背景ではなく、部分的に透明で黒い背景としたい場合、次のように TouchScreenKeyboard.Open を呼び出します:

TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true, true);