SoundManager 클래스

SoundManager 클래스 개요

Unity 프로젝트에서 배경음악과 효과음을 관리하기 위해 설계된 SoundManager 클래스

이 클래스는 싱글톤 패턴을 사용하여 프로젝트 어디에서든 접근 가능하고, 음악과 효과음을 별도로 관리한다.

SoundManager.cs

using System;
using System.Collections.Generic;
using UnityEngine;

public enum SoundType
{
    HIT,
    DEAD,
    //TODO..
}

public class SoundManager : MonoBehaviour
{
    private Dictionary<string, AudioSource> musicSources = new Dictionary<string, AudioSource>();
    private Dictionary<string, AudioSource> effectSources = new Dictionary<string, AudioSource>();

    private bool isMusicMuted = false;
    private bool isEffectsMuted = false;

    private static SoundManager _instance;
    public static SoundManager Instance
    {
        get
        {
            if (_instance == null)
            {
                _instance = FindObjectOfType<SoundManager>();
            }
            return _instance;
        }
    }

    // 배경음악 재생
    public void PlayMusic(SoundType key, bool loop = true)
    {
        Debug.Log(gameObject);
        if (!musicSources.TryGetValue(Enum.GetName(typeof(SoundType), key), out AudioSource musicSource))
        {
            Main.Resource.LoadAsync<AudioClip>(Enum.GetName(typeof(SoundType), key), clip =>
            {
                if (clip != null)
                {
                    musicSource = GetOrCreateAudioSource(musicSources, Enum.GetName(typeof(SoundType), key), loop);
                    musicSource.clip = clip;
                    musicSource.Play();
                }
                else
                {
                    Debug.LogError("로드하지 못함 : " + Enum.GetName(typeof(SoundType), key));
                }
            });
        }
        else
        {
            if (!musicSource.isPlaying)
            {
                musicSource.Play();
            }
        }
    }

    // 효과음 재생
    public void PlayEffect(SoundType key)
    {
        if (!effectSources.TryGetValue(Enum.GetName(typeof(SoundType), key), out AudioSource effectSource))
        {
            Main.Resource.LoadAsync<AudioClip>(Enum.GetName(typeof(SoundType), key), clip =>
            {
                if (clip != null)
                {
                    effectSource = GetOrCreateAudioSource(effectSources, Enum.GetName(typeof(SoundType), key), false);
                    effectSource.clip = clip;
                    effectSource.PlayOneShot(clip);
                }
                else
                {
                    Debug.LogError("로드하지 못함 : " + Enum.GetName(typeof(SoundType), key));
                }
            });
        }
        else
        {
            effectSource.PlayOneShot(effectSource.clip);
        }
    }

    private AudioSource GetOrCreateAudioSource(Dictionary<string, AudioSource> sources, string key, bool loop)
    {
        if (!sources.TryGetValue(key, out AudioSource source))
        {
            source = gameObject.AddComponent<AudioSource>();
            source.loop = loop;
            sources[key] = source;
        }
        return sources[key];
    }

}

주요 기능과 메서드 설명

1. 싱글톤 패턴 (Singleton Pattern)

private static SoundManager _instance;
public static SoundManager Instance
{
    get
    {
        if (_instance == null)
        {
            _instance = FindObjectOfType<SoundManager>();
        }
        return _instance;
    }
}

SoundManager는 싱글톤 패턴으로 구현되어 있다. 이를 통해 하나의 인스턴스만 유지되며, Instance 프로퍼티를 통해 접근할 수 있다.
인스턴스가 없을 경우 FindObjectOfType 메서드로 찾아 생성한다.

2. 배경음악 재생 (PlayMusic)

 public void PlayMusic(SoundType key, bool loop = true)
    {
        Debug.Log(gameObject);
        if (!musicSources.TryGetValue(Enum.GetName(typeof(SoundType), key), out AudioSource musicSource))
        {
            Main.Resource.LoadAsync<AudioClip>(Enum.GetName(typeof(SoundType), key), clip =>
            {
                if (clip != null)
                {
                    musicSource = GetOrCreateAudioSource(musicSources, Enum.GetName(typeof(SoundType), key), loop);
                    musicSource.clip = clip;
                    musicSource.Play();
                }
                else
                {
                    Debug.LogError("로드하지 못함 : " + Enum.GetName(typeof(SoundType), key));
                }
            });
        }
        else
        {
            if (!musicSource.isPlaying)
            {
                musicSource.Play();
            }
        }
    }

PlayMusic 메서드는 SoundType을 인자로 받아 해당하는 배경음악을 재생한다.
musicSources 딕셔너리를 사용하여 음악을 관리하며, 이미 로드된 음악은 즉시 재생되고, 그렇지 않은 경우 비동기로 로드한다.
loop 파라미터는 음악이 반복 재생될지 여부를 결정한다.

3. 효과음 재생 (PlayEffect)

public void PlayEffect(SoundType key)
    {
        if (!effectSources.TryGetValue(Enum.GetName(typeof(SoundType), key), out AudioSource effectSource))
        {
            Main.Resource.LoadAsync<AudioClip>(Enum.GetName(typeof(SoundType), key), clip =>
            {
                if (clip != null)
                {
                    effectSource = GetOrCreateAudioSource(effectSources, Enum.GetName(typeof(SoundType), key), false);
                    effectSource.clip = clip;
                    effectSource.PlayOneShot(clip);
                }
                else
                {
                    Debug.LogError("로드하지 못함 : " + Enum.GetName(typeof(SoundType), key));
                }
            });
        }
        else
        {
            effectSource.PlayOneShot(effectSource.clip);
        }
    }

PlayEffect는 SoundType을 인자로 받아 해당하는 효과음을 재생한다.
effectSources 딕셔너리를 통해 효과음을 관리하며, 로드되지 않은 경우 비동기로 로드하여 PlayOneShot 메서드로 재생한다.
PlayOneShot()은 단 한번만 재생한다는 뜻이다.

4. 오디오 소스 생성 및 관리 (GetOrCreateAudioSource)

 private AudioSource GetOrCreateAudioSource(Dictionary<string, AudioSource> sources, string key, bool loop)
    {
        if (!sources.TryGetValue(key, out AudioSource source))
        {
            source = gameObject.AddComponent<AudioSource>();
            source.loop = loop;
            sources[key] = source;
        }
        return sources[key];
    }

GetOrCreateAudioSource 메서드는 주어진 key에 맞는 AudioSource를 찾거나 새로 생성한다.
이 메서드는 배경음악과 효과음 관리에 모두 사용되며, 필요한 경우 새로운 AudioSource 컴포넌트를 추가하여 생성한다.

5.예시

SoundManager.Instance.PlayMusic(SoundType.MUSIC_LEVEL1);
SoundManager.Instance.PlayEffect(SoundType.HIT);
SoundManager.Instance.PlayEffect(SoundType.DEAD);