가상 키보드 표시 기능 사용 설명서
이 문서는 게임 실행 중에 가상 키보드를 표시하는 방법에 대한 설명입니다. 이 기능을 사용하면 사용자에게 다양한 키보드 유형을 제공할 수 있습니다. 다음은 이 기능을 사용하는 방법과 각각의 매개변수에 대한 설명입니다.
매개변수 설명
1. 키보드 유형 (Keyboard Type)
이 상수는 가상 키보드에서 사용할 수 있는 키 세트를 설정하는 데 사용됩니다. 사용 가능한 키보드 유형은 다음과 같습니다:
| 키보드 유형 | 설명 |
|---|---|
| kbv_type_default | 현재 시스템의 기본 키보드 타입입니다. |
| kbv_type_ascii | ASCII 전용 키보드입니다. |
| kbv_type_url | URL 입력에 최적화된 일반 키보드입니다. |
| kbv_type_email | 이메일 입력에 최적화된 일반 키보드입니다. |
| kbv_type_numbers | 숫자 전용 키보드로, 일반적으로 숫자 패드로 표시됩니다. |
| kbv_type_phone | 전화 키패드입니다. 일반적으로 숫자와 "*" 및 "#" 키만 포함됩니다. |
| kbv_type_phone_name | 전화번호와 이름을 동시에 입력할 수 있는 최적화된 키보드입니다. |
2. 반환 키 유형 (Return Type)
이 상수는 가상 키보드의 반환/작업 키에 표시되는 내용을 설정하는 데 사용됩니다. 사용 가능한 반환 키 유형은 다음과 같습니다:
| 반환 키 유형 | 설명 |
|---|---|
| kbv_returnkey_default | 현재 시스템의 기본 반환 키 타이틀입니다. |
| kbv_returnkey_go | 반환 키 타이틀을 "Go"로 설정합니다. |
| kbv_returnkey_google | 반환 키 타이틀을 "Google"로 설정합니다. |
| kbv_returnkey_join | 반환 키 타이틀을 "Join"으로 설정합니다. |
| 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"로 설정합니다. |
3. 자동 대문자 설정 (Autocapitalization Type)
이 상수는 가상 키보드를 통해 입력된 단어의 자동 대문자 변환 방식을 결정합니다. 사용 가능한 자동 대문자 설정은 다음과 같습니다:
| 자동 대문자 설정 | 설명 |
|---|---|
| kbv_autocapitalize_none | 자동 대문자를 비활성화합니다. |
| kbv_autocapitalize_words | 단어가 자동으로 대문자로 변환됩니다. |
| kbv_autocapitalize_sentences | 문장이 자동으로 대문자로 변환됩니다. |
| kbv_autocapitalize_characters | 모든 문자가 대문자로 변환됩니다. |
4. 예측 텍스트 설정 (Predictive Text)
이것은 예측 텍스트 기능을 활성화하거나 비활성화하는 설정입니다. true로 설정하면 예측 텍스트가 활성화되고, false로 설정하면 비활성화됩니다.
사용 예제
아래 코드는 마우스 클릭 이벤트가 발생했을 때 가상 키보드의 상태를 확인하고, 키보드가 표시되지 않은 경우 키보드를 표시하거나, 이미 표시되어 있는 경우에는 키보드를 숨깁니다.
if (mouse_check_button_pressed(mb_left)) {
var keyboard_visible = keyboard_virtual_height();
if (keyboard_visible == 0) {
// 가상 키보드를 표시
keyboard_virtual_show(kbv_type_default, kbv_returnkey_default, kbv_autocapitalize_none, true);
} else {
// 가상 키보드를 숨김
keyboard_virtual_hide();
}
}
플랫폼별 주의 사항
일부 플랫폼에서는 지원하는 기능이 다를 수 있으므로 다음 조건들을 유의해야 합니다:
- Android / Amazon Fire:
kbv_type_phone_name는 지원되지 않으며 ASCII 키보드가 표시됩니다. 반환 키 유형은 특정 제한이 있으며 지원되지 않는 키는 기본값으로 대체됩니다. - Android TV / Fire TV: ASCII 키보드에서는 사용자 정의 반환 키 유형이 지원되지 않습니다. 기본 반환 키만 표시됩니다.
- tvOS: 예측 텍스트 및 자동 대문자 기능이 지원되지 않으며, 화면 가득 차는 키보드로 인해 기본 높이가 화면 높이로 설정됩니다.
가상 키보드를 호출하면 시스템 비동기 이벤트가 생성되며, async_load 데이터 구조에는 다음과 같은 키/값 쌍이 포함됩니다:
| 키 | 값 설명 |
|---|---|
| event_type | "virtual keyboard status" |
| screen_height | 가상 키보드의 높이(픽셀 단위) |
| keyboard_status | 키보드의 현재 상태 ("hiding", "hidden", "showing", "visible") |
참고
이 문서는 가상 키보드 사용 관련 기본 사항과 예제를 포함하고 있으며, 다양한 플랫폼에서의 사용 조건도 설명하였습니다. 이 내용들을 통해 효과적으로 가상 키보드를 구현할 수 있습니다.