ドキュメント

Unity Engine

Unity Engine

モバイルキーボード

GUI 要素の場合は自動的に、スクリプトの場合は手動でオンスクリーンキーボードを開きます。
読み終わるまでの所要時間 8 分最終更新 6日前

ほとんどの場合、Unity は GUI 要素のキーボード入力を自動的に処理しますが、スクリプトからの要求に応じてキーボードを表示することも容易です。

GUI 要素

ユーザーが編集可能な GUI 要素をタップすると、キーボードが自動的に表示されます。現在、GUI.TextField、GUI.TextArea、および GUI.PasswordField はキーボードを表示します。詳細は、GUI クラスのドキュメントを参照してください。

手動キーボード操作

注
TouchScreenKeyboard
API は、ネイティブの iPhone、Android、および Windows ストア アプリケーションだけでサポートされています。サポートされていないプラットフォームでそのプロパティにアクセスしようとすると、例外がスローされます。複数のプラットフォームをターゲットにしている場合は、使用前にコードが
TouchScreenKeyboard.isSupported
を確認するようにしてください。
TouchScreenKeyboard.Open() 機能を使用してキーボードを開きます。この関数が取得するパラメータについては、TouchScreenKeyboard スクリプトリファレンスを参照してください。

キーボーレイアウトオプション

キーボードは以下のオプションをサポートします。

プロパティ

function

TouchScreenKeyboardType.Default手紙数字と記号のキーボードに切り替え可能
TouchScreenKeyboardType.ASCIICapable手紙数字と記号のキーボードに切り替え可能
TouchScreenKeyboardType.NumbersAndPunctuation数字と記号文字を含むキーボードに切り替え可能
TouchScreenKeyboardType.URLスラッシュと .com ボタンのある文字数字と記号のキーボードに切り替え可能
TouchScreenKeyboardType.NumberPad0 から 9 までの数字のみ
TouchScreenKeyboardType.PhonePad電話番号を入力するためのキーボード
TouchScreenKeyboardType.NamePhonePad手紙電話機のキーボードに切り替え可能
TouchScreenKeyboardType.EmailAddress@ 記号のある文字数字と記号のキーボードに切り替え可能

テキストプレビュー

デフォルトでは、編集ボックスが作成され、キーボードが表示された後、その上に配置されます。これはユーザーが入力しているテキストのプレビューとして機能するため、テキストは常にユーザーに表示されます。ただし、 TouchScreenKeyboard.hideInput を true に設定することで、テキストプレビューを使用不可にできます。これは、特定のキーボード タイプと入力モードに対してのみ機能することに注意してください。例えば、電話のキーパッドや複数行のテキスト入力では動作しません。このような場合、編集ボックスは常に表示されます。TouchScreenKeyboard.hideInput はグローバル変数で、すべてのキーボードに影響します。

可視性とキーボードサイズ

TouchScreenKeyboard には、画面上のキーボードの可視性状態とサイズを決定する 3 つのキーボードプロパティーがあります。

プロパティ

function

visibleキーボードが画面上に完全に表示され、文字の入力に使用できる場合に true を返します。
領域キーボードの位置と寸法を返します。
activeキーボードがアクティブになっている場合は true を返します。このプロパティは静的プロパティではありません。このプロパティを使用するにはキーボードインスタンスが必要です。
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);

Hiding text while typing

アラートキーボード

従来の不透明な背景ではなく、黒い半透明の背景でキーボードを表示するには、次のように TouchScreenKeyboard.Open() を呼び出します。
TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default, false, false, true, true);

Alert keyboard