가상 키보드 높이 가져오기

가상 키보드의 현재 높이를 픽셀 단위로 반환하는 방법에 대한 설명입니다. 이 값은 화면 크기에 따라 결정되며, 만약 키보드가 보이지 않는 경우 0이 반환됩니다.

액션 문법

keyboard_height = get_virtual_keyboard_height();

예제 코드

아래의 코드 블록은 운영 체제의 가상 키보드가 보이는지 확인하고, 보이다면 키보드의 높이를 픽셀 단위로 가져온 후, 키보드 입력 위에 텍스트를 그립니다.

if (keyboard_visible()) {
    var height = get_virtual_keyboard_height();
    draw_text(0, height - 50, "여기에 텍스트 입력");
}

활용 및 응용 예제

1. 텍스트 입력 필드 위치 조정

가상 키보드가 열릴 때 텍스트 입력 필드의 위치를 자동으로 조정하는 예제입니다.

if (keyboard_visible()) {
    var height = get_virtual_keyboard_height();
    input_field_y = room_height - height - 50; // 키보드 높이를 고려하여 입력 필드 위치 조정
}

2. 키보드 사용 여부에 따른 UI 변화

가상 키보드가 보일 때 UI 요소의 크기나 위치를 변화시키는 예제입니다.

if (keyboard_visible()) {
    var height = get_virtual_keyboard_height();
    button_y = room_height - height - 30; // 버튼 위치 조정
    button_width = room_width - 20; // 버튼 넓이 조정
}

3. 게임 내 입력 모드 전환

가상 키보드의 표시 여부에 따라 게임 내 입력 모드를 전환하는 예제입니다.

if (keyboard_visible()) {
    input_mode = "텍스트 입력 모드";
} else {
    input_mode = "일반 모드";
}

주의 사항

• 이 액션은 모바일 플랫폼에서 주로 사용되며, 데스크탑 환경에서는 가상 키보드가 필요하지 않습니다.
• 키보드가 열리면 화면의 유용한 공간을 차지하므로, 이 값을 활용하여 UI를 동적으로 조정해야 합니다.

© Copyright YoYo Games Ltd. 2023 All Rights Reserved.