기술 자료

Unity 엔진

Unity 엔진

모바일 키보드

GUI 요소에 대해 자동으로 또는 스크립트를 통해 수동으로 온스크린 키보드를 엽니다.
읽는 시간 2분최근 업데이트: 9일 전

대부분의 경우 Unity GUI 요소에 대한 키보드 입력을 자동으로 처리하지만, 필요한 경우 스크립트에서 키보드를 쉽게 표시할 수 있습니다.

GUI 요소

사용자가 편집 가능한 GUI 요소를 탭하면 키보드가 자동으로 나타납니다. 현재 키보드는 GUI.TextField, GUI.TextArea 및 GUI.PasswordField가 표시됩니다. 자세한 내용은 GUI 클래스 문서를 참조하십시오.

수동 키보드 핸들링

참고
TouchScreenKeyboard
API는 네이티브 iPhone, Android 및 Windows 스토어 앱에서만 지원됩니다. 지원되지 않는 플랫폼에서 해당 프로퍼티에 액세스하려고 하면 예외가 발생합니다. 여러 플랫폼을 대상으로 하는 경우 코드를 사용하기 전에 코드가
TouchScreenKeyboard.isSupported
를 확인해야 합니다.
키보드를 열려면 TouchScreenKeyboard.Open() 함수를 사용합니다. 이 함수의 파라미터는 TouchScreenKeyboard 스크립팅 레퍼런스를 참조하십시오.

키보드 레이아웃 옵션

키보드는 다음 옵션을 지원합니다.。

프로퍼티

_함수**

TouchScreenKeyboardType.Default문자。 숫자 및 기호 키보드로 전환할 수 있습니다.
TouchScreenKeyboardType.ASCIICapable문자。 숫자 및 기호 키보드로 전환할 수 있습니다.
TouchScreenKeyboardType.NumbersAndPunctuation숫자와 기호입니다. 문자 키보드로 전환할 수 있습니다.
TouchScreenKeyboardType.URL슬래시 및 .com 버튼이 있는 문자 숫자 및 기호 키보드로 전환할 수 있습니다.
TouchScreenKeyboardType.NumberPad0에서 9까지의 숫자만
TouchScreenKeyboardType.PhonePad전화번호를 입력하는 데 사용되는 키보드입니다.
TouchScreenKeyboardType.NamePhonePad문자。 휴대폰 키보드로 전환할 수 있습니다.
TouchScreenKeyboardType.EmailAddress@ 기호가 있는 문자. 숫자 및 기호 키보드로 전환할 수 있습니다.

텍스트 미리보기

기본적으로 수정 상자가 생성되고 키보드가 나타나면 키보드 위에 배치됩니다. 이는 사용자가 입력하는 텍스트의 미리보기로 작동하므로 텍스트가 항상 사용자에게 표시됩니다. 그러나 TouchScreenKeyboard.hideInput을 true로 설정하여 텍스트 미리보기를 비활성화할 수 있습니다. 이는 특정 키보드 타입과 입력 모드에서만 작동합니다. 예를 들어 휴대폰 키패드와 다중 행 텍스트 입력에는 작동하지 않습니다. 이러한 경우에는 항상 수정 상자가 표시됩니다. TouchScreenKeyboard.hideInput은 전역 변수이며 모든 키보드에 영향을 줍니다.

가시성 및 키보드 크기

TouchScreenKeyboard에는 화면의 키보드 가시성 상태와 크기를 결정하는 세 가지 키보드 프로퍼티가 있습니다.

프로퍼티

_함수**

visible키보드가 화면에 완전히 보이고 문자를 입력하는 데 사용할 수 있는 경우 true를 반환합니다.
area키보드의 포지션과 크기를 반환합니다.
active키보드가 활성화되면 true를 반환합니다. 이 프로퍼티는 정적 프로퍼티가 아닙니다. 이 프로퍼티를 사용하려면 키보드 인스턴스가 있어야 합니다.
TouchScreenKeyboard.area는 키보드가 화면에 완전히 보일 때까지 포지션과 크기가 0으로 설정된 사각형을 반환합니다. 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