오디오 일시 정지 확인 함수 사용법
audio_is_paused 함수는 주어진 오디오가 현재 일시 정지 상태인지 확인하는 함수입니다. 이 함수는 두 가지 방식으로 사용될 수 있습니다:
- 단일 음원 인스턴스:
audio_play_sound()또는audio_play_sound_at()함수를 사용할 때, 재생 중인 음원의 인덱스를 변수에 저장하여 사용할 수 있습니다. - 음원 자산: 음원 자산을 직접 사용할 때, 주어진 음원의 모든 인스턴스가 확인되며, 만약 어떤 인스턴스라도 일시 정지 상태이면 함수는
true를 반환합니다. 그렇지 않으면false를 반환합니다.
구문
audio_is_paused(index);
인수
| 인수 | 타입 | 설명 |
|---|---|---|
| index | Sound Asset or Sound Instance ID | 확인할 소리의 인덱스 |
반환 값
- Boolean: 소리가 일시 정지 상태이면
true, 그렇지 않으면false를 반환합니다.
예제
다음 코드는 "snd_Waterfall"로 인덱스된 소리가 현재 일시 정지 상태인지 확인하고, 만약 일시 정지 상태라면 소리를 재개합니다.
if audio_is_paused(snd_Waterfall) {
audio_resume_sound(snd_Waterfall);
}
활용 및 응용 예제
여기서는 audio_is_paused 함수를 활용한 몇 가지 추가 예제를 제시합니다.
예제 1: 여러 소리 인스턴스 확인하기
아래 코드는 여러 소리가 일시 정지 상태인지를 확인하고, 일시 정지된 소리만 재개합니다.
if audio_is_paused(snd_Bird) {
audio_resume_sound(snd_Bird);
}
if audio_is_paused(snd_Wind) {
audio_resume_sound(snd_Wind);
}
예제 2: 게임 상태에 따른 오디오 제어
게임이 일시 정지 상태일 때 모든 소리를 일시 정지하고, 게임이 재개될 때 소리를 다시 시작합니다.
if game_paused {
// 모든 소리 일시 정지
audio_pause_sound(snd_Music);
audio_pause_sound(snd_Effects);
} else {
// 소리가 일시 정지 상태인지 확인 후 재개
if audio_is_paused(snd_Music) {
audio_resume_sound(snd_Music);
}
if audio_is_paused(snd_Effects) {
audio_resume_sound(snd_Effects);
}
}
예제 3: 상태 메시지 출력
소리가 일시 정지 상태인지 확인하고, 그에 따라 콘솔에 메시지를 출력할 수도 있습니다.
if audio_is_paused(snd_Thunder) {
show_message("천둥 소리가 일시 정지되었습니다.");
} else {
show_message("천둥 소리가 재생되고 있습니다.");
}
결론
audio_is_paused 함수는 현재 음원의 상태를 확인하는 유용한 도구입니다. 이를 통해 오디오 재생을 보다 효과적으로 관리하고, 사용자 경험을 향상시킬 수 있습니다. 다양한 예제를 통해 자신의 프로젝트에 맞게 응용할 수 있습니다.