사용자의 입력값을 실시간으로 받아오는 방법 (UI - InputField Event)

강성현
강성현
∙∙조회 6
사용자의 입력값을 실시간으로 받아오는 방법 (UI - InputField Event)

1. 이 기능을 접하게 된 계기

  • 설정창에서 사용자의 숫자입력을 통해 사운드 조절을 하고 싶었습니다.

 

2. 해당 기능을 사용하는 법

  1. Canvas에 Input Field - TextMeshPro 를 추가합니다.
  2. [SerializeField] 직렬화를 통해 앞서 추가한 TMP_InputField 를 참조합니다.
  3. 아래에 있는 이벤트 중 본인에게 필요한 이벤트를 구독하여 사용합니다.

 

3. 이벤트의 종류

1) OnValueChanged(String) - 실시간 값의 변화 감지

입력 필드의 값이 변경될 때마다 실시간으로 호출됩니다.

  • 활용 가능 사례
  1. 실시간 검색 기능
  2. 입력 글자 수 실시간 표시

 

2) OnEndEdit(String) - 입력완료 감지

사용가가 입력을 마쳤다고 판단되는 시점에 호출됩니다.

  1. InputField 활성화 상태에서 Enter 키가 눌렸을 때
  2. 다른 UI를 클릭하여 InputField 의 포커스를 잃었을 때

활용 가능 사례

  1. 설정값 저장
  2. 욕설 필터링

3) OnSelect(String) - InputField 입력 활성화 감지

값을 변경하기 위해 InputField 를 클릭하여 활성화 하는 순간에 호출됩니다.

 

4) OnDeselect(String) - InputField 입력 비활성화 감지

InputField 바깥쪽을 클릭하여 비활성화 되는 순간에 호출됩니다.

 

3. 코드 구현

csharp
   [SerializeField] private TMP_InputField _soundText;
    

    // ---------- Event Method ----------

    private void OnEnable() => BindSoundUI();

    private void OnDisable() => UniBindSoundUI();

    // ----------------------------------

    private void BindSoundUI()
    {
        _soundText.onValueChanged.AddListener(OnInputValueChanged);
        _soundText.onEndEdit.AddListener(OnInputEndEdit);
        _soundText.onSelect.AddListener(OnInputSelect);
        _soundText.onDeselect.AddListener(OnInputDeselect);
    }

    private void UniBindSoundUI()
    {
        _soundText.onValueChanged.RemoveListener(OnInputValueChanged);
        _soundText.onEndEdit.RemoveListener(OnInputEndEdit);
        _soundText.onSelect.RemoveListener(OnInputSelect);
        _soundText.onDeselect.RemoveListener(OnInputDeselect);
    }

    private void OnInputValueChanged(string text)
    {
        Debug.Log($"OnValueChanged - 현재 입력 값 : {text}");
    }
    
    private void OnInputEndEdit(string text)
    {
        Debug.Log($"OnEndEdit - 최종 입력 완료 : {text}");
    }
    
    private void OnInputSelect(string text)
    {
        Debug.Log($"OnSelect - 필드 선택. 초기 값 : {text}");
    }
    
    private void OnInputDeselect(string text)
    {
        Debug.Log($"OnDeselect - 필드 선택 해제. 최종 값 : {text}");
    }

4. 결과