오디오 볼륨 설정

개요

이 문서는 주어진 사운드의 볼륨을 설정하는 방법을 설명합니다. 자산 탐색기에서 사운드를 선택하고 볼륨 값을 설정하면 됩니다. 볼륨 값은 0 (무음)에서 1 (최대 볼륨) 사이의 선형 스케일로 설정할 수 있으며, 0.5는 반 정도의 볼륨을 의미합니다. 이 작업은 현재 방에서 재생 중인 사운드의 모든 인스턴스에 영향을 주며, 앞으로 재생될 모든 인스턴스에도 적용됩니다.

시간 조절

"시간" 필드는 볼륨 변화가 적용되는 데 걸리는 시간을 제어합니다. 값이 0이면 즉각적인 변화가 발생하며, 더 큰 값은 주어진 밀리초 동안 점진적으로 볼륨이 변경됩니다.

문법

// 액션 블록 예시
set_audio_volume(sound, volume, time);

인수 설명

예제 코드

아래의 코드는 глоб 변수(global variable)를 검사하여 true 또는 false인지 확인합니다. 만약 true일 경우, 주어진 사운드의 볼륨을 가져와 임시 지역 변수에 저장합니다. 그러고 나서 그 값이 0.5가 아닌지 확인하고, 그렇지 않을 경우, 사운드의 볼륨을 1000 밀리초(1초) 동안 0.5로 페이드 설정합니다. 만약 글로벌 변수가 false로 평가된다면, 사운드의 볼륨을 1로 설정합니다. 여기서 시간의 값이 0으로 설정되어 있어, 볼륨 변화는 즉시 발생합니다.

if(global_variable == true) {
    var temp_volume = audio_get_volume(sound);
    if(temp_volume != 0.5) {
        set_audio_volume(sound, 0.5, 1000);
    }
} else {
    set_audio_volume(sound, 1, 0);
}

활용 및 응용 예제

배경음악 볼륨 설정

게임의 배경음악을 사용자 설정에 맞게 조정할 수 있습니다.

if(user_setting.music_volume != null) {
    set_audio_volume(background_music, user_setting.music_volume, 500);
}

효과음 볼륨 조절

상황에 따라 효과음의 볼륨을 조정할 수 있습니다. 예를 들어, 사용자가 일시 정지 메뉴에 들어갔을 때 효과음을 줄일 수 있습니다.

if(is_paused) {
    set_audio_volume(effect_sound, 0.3, 300);
} else {
    set_audio_volume(effect_sound, 1, 0);
}

결론

이 문서에서는 오디오 볼륨을 설정하는 방법에 대해 설명했습니다. 위의 예제를 통해 다양한 상황에서 이 기능을 어떻게 활용할 수 있는지 이해할 수 있을 것입니다.