오디오 함수 설명서: audio_stop_all
개요
audio_stop_all 함수는 현재 재생 중인 모든 사운드를 중지하는 기능을 제공합니다. 이 함수는 audio_pause_sound 또는 audio_pause_all 함수를 사용하여 일시 중지된 모든 사운드도 포함됩니다. 또한, 오디오 버퍼 큐에서 모든 대기 중인 버퍼를 제거하고, 제거된 각 버퍼에 대해 Audio Playback 이벤트를 실행하며, "queue_shutdown" 키를 1로 설정합니다.
문법
audio_stop_all();
반환 값
- N/A (반환 값 없음)
활용 예제
다음은 audio_stop_all 함수의 사용 예시입니다.
if (!global.SFX) {
audio_stop_all();
}
위의 코드는 전역 변수 SFX를 체크한 후, 그 값이 false일 경우 현재 재생 중인 모든 소리를 중지합니다.
다양한 활용 및 응용 예제
| 예제 번호 | 설명 | 코드 스니펫 |
|---|---|---|
| 1 | 게임이 일시 중지 상태인 경우 모든 소리 중지 | ```gml |
| if (is_paused) { | audio_stop_all(); | |
| } | } | |
| 2 | 특정 게임 레벨이 끝났을 때 오디오 중지 | ```gml |
| if (level_finished) { | audio_stop_all(); | |
| } | } | |
| 3 | 배경음악이 변경될 때 이전 소리 중지 | ```gml |
| audio_stop_all(); | // 새로운 배경음악 로드 | |
| audio_play_sound(new_background, 1, true); | ```gml | |
| 4 | 사용자가 설정을 변경할 때 모든 사운드 중지 | ```gml |
| if (settings_changed) { | audio_stop_all(); | |
| } | } |
결론
audio_stop_all 함수는 모든 소리를 중지해야 하는 다양한 상황에서 매우 유용하게 사용될 수 있습니다. 이를 통해 사용자 경험을 향상시키고, 불필요한 소음으로부터 게임을 사용자가 쉽게 집중할 수 있는 환경을 만들어 줄 수 있습니다.