본문 바로가기

Unity3D/C#

유니티 볼륨 슬라이더 만들기 (AudioMixer.SetFloat, Mathf.Log10)

반응형

대표 그림

웬만한 게임의 설정 화면에는 배경음과 효과음 볼륨을 따로 조절하는 슬라이더가 있습니다. AudioSource마다 volume을 바꿀 수도 있지만, 소리를 내는 오브젝트가 많아지면 하나씩 찾아 바꾸기가 번거로워집니다. Unity의 Audio Mixer를 쓰면 여러 AudioSource의 출력을 그룹으로 모아 한 곳에서 음량을 조절할 수 있습니다. 스크립트에서는 믹서에서 노출(Expose)한 파라미터 이름으로 AudioMixer.SetFloat을 호출해 값을 바꿉니다. 믹서의 볼륨은 데시벨(dB) 단위이기 때문에 슬라이더의 0~1 값을 그대로 넣지 않고 Mathf.Log10으로 바꿔서 넣습니다. 이번 예시에서는 슬라이더 하나로 믹서 그룹의 볼륨을 조절해 보도록 하겠습니다.

C# (UNITY 3D)

실제 Unity 화면이 아닌 코드 설명 도식

슬라이더를 움직이면 믹서 그룹의 볼륨 값이 함께 바뀌는 예시입니다.

using UnityEngine;
using UnityEngine.Audio;
using UnityEngine.UI;

AudioMixer를 사용하기 위해 UnityEngine.Audio를, Slider를 사용하기 위해 UnityEngine.UI를 사용합니다.

먼저 Audio Mixer 에셋을 만들고 Master 그룹을 선택합니다. 인스펙터의 Volume 항목을 오른쪽 클릭해 스크립트에 노출하고, Audio Mixer 창의 Exposed Parameters 목록에서 이름을 MasterVolume으로 바꿉니다. 소리를 낼 AudioSource의 Output에는 이 믹서 그룹을 넣습니다. 그 다음 빈 GameObject에 MixerVolume.cs를 붙이고 믹서와 슬라이더를 할당합니다. ▼

using UnityEngine;
using UnityEngine.Audio;
using UnityEngine.UI;

//CodeFinder 코드파인더
//From https://codefinder.janndk.com/
public class MixerVolume : MonoBehaviour
{
    public AudioMixer mixer_main;
    public Slider slider_volume;
    public string name_parameter = "MasterVolume";

    void Start()
    {
        Init_UI();
    }

    void Init_UI()
    {
        if (slider_volume == null)
            return;

        // 0 은 Log10 계산에 쓸 수 없어 최솟값을 0 보다 크게 둡니다.
        slider_volume.wholeNumbers = false;
        slider_volume.minValue = 0.0001f;
        slider_volume.maxValue = 1f;
        slider_volume.onValueChanged.RemoveAllListeners();
        slider_volume.onValueChanged.AddListener(Set_Volume);
        Set_Volume(slider_volume.value);
    }

    public void Set_Volume(float value)
    {
        if (mixer_main == null)
            return;

        // 슬라이더의 0~1 값을 데시벨 값으로 바꿉니다.
        float volume_db = Mathf.Log10(Mathf.Max(value, 0.0001f)) * 20f;
        if (!mixer_main.SetFloat(name_parameter, volume_db))
            Debug.LogWarning("믹서 파라미터 설정 실패: " + name_parameter);
    }
}

변수(variable)

mixer_main(AudioMixer) : 볼륨을 바꿀 믹서 에셋입니다.

slider_volume(Slider) : 0~1 값을 받는 슬라이더입니다.

name_parameter(string) : 믹서에서 노출한 파라미터 이름입니다.

함수(function)

Init_UI : 슬라이더 범위를 정하고 이벤트를 연결합니다.

Set_Volume : 슬라이더 값을 데시벨로 바꿔 믹서에 넣습니다.

주의

SetFloat은 노출된 파라미터 이름이 정확히 같아야 동작하고, 이름을 찾지 못하거나 스냅샷을 편집 중이면 false를 돌려줍니다. 그래서 반환값을 확인해 경고를 남기도록 했습니다. 슬라이더 값 1은 0dB, 0.1은 -20dB, 0.0001은 -80dB가 됩니다. 이 예제는 볼륨 값을 저장하지 않으므로, 다음 실행에도 쓰려면 PlayerPrefs 같은 저장 처리를 따로 붙여야 합니다.

참고: AudioMixer.SetFloat · Mathf.Log10 · Audio Mixer

이 예제는 글을 위해 작성한 코드입니다. 전용 Unity 프로젝트 검사 결과는 별도로 기록하며, 기기에서의 화면과 플랫폼 동작을 보장하지 않습니다.

반응형

Google Play 및 Google Play 로고는 Google LLC의 상표입니다.