Android 가상 키보드

모든 언리얼 엔진 4 (UE4) Android 기반 프로젝트는 표준 팝업 입력 대화창 또는 운영 체제의 가상 키보드를 지원합니다. 이 문서에서는 UE4 프로젝트에서 어느 쪽이든 가상 키보드를 설정하고 호출하는 방법을 살펴 보겠습니다.

단계

프로젝트에서 가상 키보드를 활성화하는 방법은 다음과 같습니다:

1. 메인 메뉴 에서 편집 > 프로젝스 세팅 옵션을 클릭합니다.

   

2. 프로젝트 세팅 메뉴의 플랫폼 > Android 에서 APKPackaging 섹션 아래 Enable improved virtual keyboard [Experimental] (향상된 가상 키보드 활성화 [실험단계] 옵션 옆 박스를 클릭해서 체크하여 활성화합니다.

   클릭하면 이미지 원본을 확인합니다.

3. 콘텐츠 브라우저 에 우클릭하고 유저 인터페이스 > 위젯 블루프린트 옵션에서 새 블루프린트 이름을 Input Text 라 합니다.

   

4. Input Text UMG 위젯에 더블클릭하여 열고 팔레트 에서 TextBox 를 끌어 UMG 그래프에 놓습니다.

   클릭하면 이미지 원본을 확인합니다.

5. TextBox 가 Canvas 패널 가운데 오도록 위치를 잡고 컴파일, 저장 버튼을 누릅니다.

   클릭하면 이미지 원본을 확인합니다.

   참고로 입력 요소가 보이고 가상 키보드 뒤에 가려져 있지 않은지 확인하는 것은 앱이 담당합니다. 제공된 OnVirtualKeyboardShown, OnVirtualKeyboardHidden 이벤트 핸들러를 사용하여 UI 요소가 가상 키보드를 가리지 않는지 확인할 수 있습니다.

6. 레벨 블루프린트 를 열고 이벤트 그래프에 노드를 다음과 같이 추가합니다.

   클릭하면 이미지 원본을 확인합니다.

   • Event Begin Play
   • Create Widget
   • Add to Viewport

7. Event Begin Play 노드를 Create Widget 노드에 연결하고 Create Widget 노드를 Add Viewport 노드에 연결합니다. 완성된 레벨 블루프린트 는 다음 이미지와 같습니다.

   클릭하면 이미지 원본을 확인합니다.

8. 다음, Create Widget 블루프린트 노드에서 Class 입력에 아까 만든 InputText 위젯 블루프린트를 추가합니다.

   

9. 레벨을 저장하고 이름을 AndroidVirtualKeyboard 라 한 뒤 프로젝트 세팅을 열어 맵 & 모드 아래 Default Maps (기본 맵) 부분 Editor Startup Map 과 Game Default Map 에 AndroidVirtualKeyboard 를 입력합니다.

   클릭하면 이미지 원본을 확인합니다.

10. 이제 메인 메뉴에서, 실행 버튼 옆 작은 흰색 삼각형을 클릭하면 표시되는 메뉴에서, UE4 프로젝트를 디플로이하려는 Android 디바이스를 선택합니다.

    

최종 결과

Android 디바이스에 프로젝트가 실행되면, 텍스트 입력 칸을 누릅니다. 다음 비디오처럼 Android 시스템 키보드를 사용하여 텍스트를 입력할 수 있습니다.

Android.NewKeyboard 콘솔 변수 뒤의 숫자 값에 따라 가상 키보드를 비활성화할 수도 있습니다. 사용자가 다른 IME (Input Method Editor)가 필요한 언어를 사용할 때 특히 좋습니다.