오디오 관련 함수: audio_stop_sound
audio_stop_sound 함수는 현재 재생 중인 지정된 소리를 멈추는 기능을 제공합니다. 이 함수는 audio_pause_sound 또는 audio_pause_all을 통해 일시 중지된 모든 소리를 포함합니다.
함수 사용법
구문
audio_stop_sound(index);
인수
| 인수 | 유형 | 설명 |
|---|---|---|
| index | Sound Asset / Sound Instance ID / Audio Queue ID | 멈출 소리의 인덱스 또는 ID입니다. |
반환 값
- 없음 (N/A)
활용 예제
아래의 예제는 글로벌 변수를 확인하여 소리를 멈추거나 다시 재생하는 방식입니다.
if (!global.SFX) {
audio_stop_sound(snd_Waterfall);
} else {
audio_play_sound_at(snd_Waterfall, x, y, 0, 100, 300, 1, true, 1);
}
위의 코드에서 global.SFX가 false를 반환하면, 현재 재생 중인 snd_Waterfall 소리를 멈추고, true를 반환하면 해당 소리를 반복 재생합니다.
다양한 활용 및 응용 예제
- 소리 정지와 환경 설정 전환
- 사용자가 게임 설정을 변경할 때 소리를 중지하려면 다음과 같이 할 수 있습니다.
gml // 설정이 변경되면 소리 멈추기 audio_stop_sound(snd_BackgroundMusic); // 새로운 설정에 따라 소리를 재생 audio_play_sound_at(snd_NewBackgroundMusic, x, y, 0, 100, 300, 1, true, 1); - 게임 종료 시 모든 소리 멈추기
- 게임이 종료될 때 모든 소리를 멈추려면 다음과 같은 방법으로 구현할 수 있습니다.
gml // 게임 종료 시 모든 소리 정지 audio_stop_all(); - 일시 중지 기능 구현
- 게임 중 일시 정지 상태에서 소리를 멈추고, 다시 시작할 때 소리를 재생할 수 있습니다.
gml if (isPaused) { audio_stop_sound(snd_GameplayMusic); } else { audio_play_sound_at(snd_GameplayMusic, x, y, 0, 100, 300, 1, true, 1); }
위의 예제들을 통해 audio_stop_sound 함수를 유용하게 활용할 수 있습니다. 다양한 상황에서 소리 관리를 통해 더 나은 사용자 경험을 제공해 보세요.