가상 키보드 표시 함수 설명
이 문서는 게임을 실행하는 장치에서 가상 키보드를 표시하는 keyboard_virtual_show 함수에 대해 설명합니다. 이 함수는 플랫폼 지원에 대한 정보는 가상 키보드를 참조하세요.
함수 사용 목적
- Windows에서는 IME(입력기)를 사용할 수 있도록 하며, 이 경우 인자는 사용되지 않고 모든 인자에
undefined를 전달할 수 있습니다.
인자 설명
가상 키보드를 사용하기 위해서는 첫 번째 세 인자에 대해 다음 상수 중 하나를 제공해야 합니다.
키보드 유형
| 키보드 유형 상수 | 설명 |
|---|---|
| kbv_type_default | 현재 시스템의 기본 키보드 유형. |
| kbv_type_ascii | ASCII 전용 키보드. |
| kbv_type_url | URL 입력에 최적화된 일반 키보드. 보통 ".com" 또는 다른 도메인 키와 "/" 및 "." 키가 포함됨. |
| kbv_type_email | 이메일 입력에 최적화된 일반 키보드. 보통 "@" 및 "." 문자가 포함됨. |
| kbv_type_numbers | 숫자 전용 키보드, 보통 숫자 패드로 표시됨. |
| kbv_type_phone | 전화 패드 키보드. 보통 "*" 및 "#" 키가 포함된 숫자 전용. |
| kbv_type_phone_name | 전화번호와 이름 입력에 최적화된 키보드. 보통 ASCII 키보드와 유사하지만 제한된 특수 문자 선택이 포함됨. |
반환 키 유형
| 반환 키 유형 상수 | 설명 |
|---|---|
| kbv_returnkey_default | 현재 시스템의 기본 반환 키 제목. |
| kbv_returnkey_go | 반환 키 제목을 "Go"로 설정. |
| kbv_returnkey_google | 반환 키 제목을 "Google"로 설정. |
| kbv_returnkey_join | 반환 키 제목을 "Go"로 설정. |
| kbv_returnkey_next | 반환 키 제목을 "Next"로 설정. |
| kbv_returnkey_route | 반환 키 제목을 "Route"로 설정. |
| kbv_returnkey_search | 반환 키 제목을 "Search"로 설정. |
| kbv_returnkey_send | 반환 키 제목을 "Send"로 설정. |
| kbv_returnkey_yahoo | 반환 키 제목을 "Yahoo"로 설정. |
| kbv_returnkey_done | 반환 키 제목을 "Done"으로 설정. |
| kbv_returnkey_continue | 반환 키 제목을 "Continue"로 설정. |
| kbv_returnkey_emergency | 반환 키 제목을 "Emergency Call"로 설정. |
자동 대문자화 유형
| 자동 대문자화 유형 상수 | 설명 |
|---|---|
| kbv_autocapitalize_none | 자동 대문자화 비활성화. |
| kbv_autocapitalize_words | 단어가 자동 대문자화됨. |
| kbv_autocapitalize_sentences | 문장이 자동 대문자화됨. |
| kbv_autocapitalize_characters | 모든 문자가 대문자로 변환됨. |
마지막 인자는 예측 텍스트를 활성화/비활성화하는 데 사용되며, true로 설정하면 활성화되고, false로 설정하면 비활성화됩니다. 예측 텍스트 모드에서는 가상 키보드가 일반 GameMaker 키 입력 이벤트를 생성하지 않습니다. 대신, lastcharacter pressed 및 keyboard string 변수를 업데이트합니다.
플랫폼별 주의사항
- Android:
kbv_type_phone_name은 지원되지 않으며 ASCII 키보드가 표시됩니다. 반환 키 유형은kbv_returnkey_go,kbv_returnkey_search,kbv_returnkey_next,kbv_returnkey_send,kbv_returnkey_done만 사용할 수 있습니다. - tvOS: 예측 텍스트 및 자동 대문자화는 지원되지 않으며, 가상 키보드의 높이는 화면 높이로 기본 설정됩니다.
- Xbox GDK: 이 함수를 호출하면 시스템 비동기 이벤트가 생성됩니다.
함수 문법
keyboard_virtual_show(keyboard_type, return_key_type, autocapitalization_type, predictive_text_enabled);
인자 설명
| 인자 | 유형 | 설명 |
|---|---|---|
| keyboard_type | 가상 키보드 유형 상수 | 가상 키보드에서 사용할 키셋을 결정합니다. |
| return_key_type | 가상 키보드 반환 키 유형 상수 | 가상 키보드의 반환/작업 키에 표시되는 내용을 결정합니다. |
| autocapitalization_type | 가상 키보드 자동 대문자화 유형 상수 | 가상 키보드를 통해 입력된 단어의 자동 대문자화 방식을 결정합니다. |
| predictive_text_enabled | 불리언 | 예측 텍스트 입력을 활성화/비활성화합니다. |
활용 예제
if (input == false) {
input = true;
keyboard_virtual_show(kbv_type_numbers, kbv_returnkey_default, kbv_autocapitalize_none, false);
}
위 코드는 주어진 변수가 true로 설정되지 않은 경우 OS 가상 키보드를 표시합니다.
keyboard_virtual_show(kbv_type_email, kbv_returnkey_send, kbv_autocapitalize_sentences, true);
이 코드는 이메일 입력에 최적화된 키보드를 표시하고, 예측 텍스트를 활성화합니다.
keyboard_virtual_show(kbv_type_url, kbv_returnkey_google, kbv_autocapitalize_none, false);
이 코드는 URL 입력에 최적화된 키보드를 표시하며, 자동 대문자화 및 예측 텍스트를 비활성화합니다.