window_has_focus 함수 설명
window_has_focus 함수는 현재 창(또는 탭)의 상태를 확인하는 데 사용됩니다. 만약 창이 포커스를 잃으면 이 함수는 false를 반환하고, 그렇지 않으면 true를 반환합니다. 대부분의 경우 os_is_paused() 함수를 사용하여 이 상태를 확인할 수 있지만, 특정 상황(예: Chrome 앱에서의 게임)에서는 이 함수가 작동하지 않을 수 있습니다. 이럴 때는 window_has_focus 함수를 사용해야 합니다.
문법
window_has_focus();
반환값
- Boolean: 창이 포커스를 가지고 있으면
true, 그렇지 않으면false를 반환합니다.
예제
if (!window_has_focus()) {
PauseGame();
}
위의 코드는 게임 창이 포커스를 가지고 있는지 확인하고, 만약 함수가 false를 반환하면 PauseGame() 함수를 호출합니다.
활용 예제
| 예제 번호 | 설명 | 코드 스니펫 |
|---|---|---|
| 1 | 게임이 포커스를 잃었을 때 일시 정지 | gml if (!window_has_focus()) { PauseGame(); } |
| 2 | 포커스가 있을 때 게임 진행 | gml if (window_has_focus()) { ContinueGame(); } |
| 3 | 포커스 상태에 따라 UI 업데이트 | gml if (window_has_focus()) { UpdateUI(); } else { HideUI(); } |
| 4 | 포커스가 없을 때 사운드 일시 정지 | gml if (!window_has_focus()) { StopSound(); } |
| 5 | 포커스 상태에 따라 배경 음악 조절 | gml if (window_has_focus()) { PlayMusic(); } else { MuteMusic(); } |
이 함수는 HTML5, Windows, macOS 플랫폼에서만 유효합니다.