Unityにおける文字入力フィールドとイベントハンドリング

2024年9月11日

この技術資料では、Unityでのユーザーインターフェース（UI）の基本的な操作、特に文字入力フィールド（Input Field）とイベントハンドリングの使用方法について解説します。UIの操作は、ゲームやアプリケーションでユーザーとのやり取りを行うための重要な要素です。特にテキスト入力やボタン操作など、ユーザーの行動に対して適切に反応することが求められます。これらの機能を効果的に使用することで、インタラクティブで直感的なアプリケーションを構築できるようになります。

1. 1. 文字入力フィールド（Input Field）について
2. 2. イベントハンドリングについて
3. 3. テキスト入力の確定とは？

1. 文字入力フィールド（Input Field）について

Unityの文字入力フィールド（Input Field）は、ユーザーがテキストを入力できるUI要素です。例えば、ログインフォームやチャットウィンドウで使用されます。

1.1 文字入力フィールドの作成手順

Canvasの作成
GameObjectメニューからUI > Canvasを選択し、キャンバスを作成します。このキャンバス内にUI要素を配置します。
Input Fieldの追加
キャンバスを右クリックし、UI > Input Fieldを選択して文字入力フィールドを追加します。
プレースホルダーとテキストの設定
Input Fieldにはデフォルトで以下の2つの子オブジェクトがあります:
- Placeholder: 入力されていない時に表示される説明テキスト。
- Text: ユーザーが入力したテキストが表示される部分。

1.2 スクリプトでのテキスト入力の取得

using UnityEngine;
using UnityEngine.UI;

public class InputFieldExample : MonoBehaviour
{
    public InputField inputField;

    void Update()
    {
        if (Input.GetKeyDown(KeyCode.Return))
        {
            Debug.Log(inputField.text); // ユーザーが入力したテキストを出力
        }
    }
}

このスクリプトでは、Input Fieldに入力されたテキストがEnterキーを押されたときに取得され、コンソールに表示されます。

1.3 Input Fieldのプロパティ

Character Limit: 入力できる文字数を制限します。
Content Type: 入力内容を制限できます（例: 標準テキスト、パスワード、数字専用など）。
Line Type: 単一行または複数行の入力を選択できます。

2. イベントハンドリングについて

Unityのイベントハンドリングとは、ユーザーの操作（クリック、入力、キー押下など）に応じて特定の処理を実行する仕組みです。

2.1 ボタンのイベントハンドリング例

using UnityEngine;
using UnityEngine.UI;

public class ButtonHandler : MonoBehaviour
{
    public Button myButton;

    void Start()
    {
        // ボタンクリックイベントにハンドラを追加
        myButton.onClick.AddListener(OnButtonClick);
    }

    void OnButtonClick()
    {
        Debug.Log("ボタンがクリックされました！");
    }
}

上記のスクリプトは、myButtonがクリックされると、OnButtonClick関数が呼び出され、コンソールにメッセージが表示されます。

2.2 Input Fieldのイベントハンドリング例

using UnityEngine;
using UnityEngine.UI;

public class InputFieldHandler : MonoBehaviour
{
    public InputField inputField;

    void Start()
    {
        // ユーザーが入力を確定したときにイベントを発生させる
        inputField.onEndEdit.AddListener(OnInputEnd);
    }

    void OnInputEnd(string inputText)
    {
        Debug.Log("入力が確定しました: " + inputText);
    }
}

この例では、ユーザーがテキストの入力を確定（Enterキーを押すか、フォーカスを外すなど）した際にOnInputEnd関数が呼び出され、入力されたテキストがコンソールに表示されます。