사운드 존재 여부 확인 함수 (audio_exists)

이 문서에서는 audio_exists 함수에 대해 간단하고 명확하게 설명하며, 다양한 활용 및 응용 예제를 제시합니다.

함수 개요

audio_exists 함수는 특정 사운드 자산이 존재하는지를 확인하는 기능을 제공합니다. 확인할 사운드는 사운드의 개별 인스턴스(이 경우 audio_play_sound 또는 audio_play_sound_at 함수 사용 시 저장된 인덱스를 사용) 또는 사운드 자산일 수 있습니다. 만약 검색하려는 인덱스가 이전에 초기화되지 않았다면, 이 함수는 존재하지 않는 자산 인덱스를 검색하게 되어 오류를 발생시킵니다.

문법

audio_exists(index);

인수 설명

반환 값

예제 코드

아래 코드는 사운드가 존재하는지 확인하고, 만약 존재한다면 그 사운드를 반복 재생하는 예제입니다.

if audio_exists(global.Music) {
    audio_play_sound(global.Music, 0, true);
}

활용 및 응용 예제

1. 게임 시작 시 배경음악 확인 및 재생하기

if audio_exists(global.BackgroundMusic) {
    audio_play_sound(global.BackgroundMusic, 0, true);
} else {
    // 대체 사운드를 재생 또는 로그 출력
    show_message("배경 음악이 존재하지 않습니다.");
}

2. 사운드 시작 시 사운드 자산이 있는지 확인하기

var sound_index = global.JumpSound;

if audio_exists(sound_index) {
    audio_play_sound(sound_index, 1, false); // 단 한 번만 재생
} else {
    show_message("점프 사운드가 없습니다!");
}

3. 사운드 개수에 따른 조건부 효과

var effects_count = 3; // 사용할 사운드 효과의 수
for (var i = 0; i < effects_count; i++) {
    if audio_exists(global.Effects[i]) {
        audio_play_sound(global.Effects[i], 0, false);
    } else {
        show_message(global.Effects[i] + " 사운드가 존재하지 않습니다.");
    }
}

이 문서는 audio_exists 함수의 기본 개념과 활용 예제를 제공하며, 게임 개발에서 사운드 자산을 관리하는 데 유용한 정보가 될 것입니다.