마스터 볼륨 가져오기

개요

이 액션은 사운드 시스템의 마스터 볼륨을 반환합니다. 반환되는 볼륨 값은 0과 1 사이이며, 0은 소음이 없음을 의미하고 1은 최대 볼륨을 의미합니다.

구문 및 인수

액션 구문

get_master_volume(target)

인수 설명

예제

아래 예제는 전역 변수를 검사하여 true 또는 false인지 확인합니다. 만약 true라면, 사운드 시스템의 마스터 볼륨을 가져와서 임시 로컬 변수에 저장합니다. 이후 이 값을 체크해서 0.5와 같지 않은 경우, 마스터 볼륨을 0.5로 설정합니다. 만약 전역 변수가 false라면, 마스터 볼륨은 1로 설정됩니다.

var is_sound_enabled = global.sound_enabled; // 전역 변수를 확인합니다.
var master_volume;

if (is_sound_enabled) {
    get_master_volume(master_volume); // 마스터 볼륨을 가져옵니다.
    if (master_volume != 0.5) {
        master_volume = 0.5; // 볼륨을 0.5로 설정합니다.
    }
} else {
    master_volume = 1; // 볼륨을 1로 설정합니다.
}

활용 및 응용 예제

1. 마스터 볼륨 조정

게임의 설정에서 사용자가 볼륨을 조정할 수 있도록 하는 기능을 추가할 수 있습니다.

if (mouse_check_button_pressed(mb_left)) {
    var new_volume = 0.7; // 사용자가 설정한 볼륨
    audio_master_gain(new_volume); // 새로운 볼륨으로 설정
}

2. 볼륨 뮤트 기능

사용자가 버튼을 눌렀을 때 볼륨을 뮤트하거나 원래 볼륨으로 복원하는 기능을 구현할 수 있습니다.

var original_volume;
if (mute_button_pressed()) {
    original_volume = get_master_volume();
    set_master_volume(0); // 볼륨을 0으로 설정 (뮤트)
} else {
    set_master_volume(original_volume); // 원래 볼륨으로 복원
}

결론

위의 예제들을 통해 사운드 시스템의 마스터 볼륨을 효과적으로 제어할 수 있으며, 게임의 사용자 경험을 향상시킬 수 있습니다.