본문으로 건너뛰기

AudioManager

BGM 및 SFX 재생, 페이드, 뮤트, 3D 공간 음향을 통합 관리하는 매니저입니다. 초기화 시 DontDestroyOnLoad GameObject를 자동으로 생성하고 BGM용 AudioSource 1개와 SFX용 8채널 풀을 구성합니다.

DI 등록​

// AchManagerInstaller가 자동으로 등록합니다.
// 선택 등록이 필요한 경우:
public class MyInstaller : AchManagerInstaller
{
    public override void Install(IServiceBuilder builder)
    {
        builder.Register<AudioManager>();
    }
}

접근할 때는 ServiceLocator를 사용합니다.

using AchEngine.DI;
using AchEngine.Managers;

var audio = ServiceLocator.Resolve<AudioManager>();

API​

멤버설명
BgmVolumeBGM 볼륨 (0 ~ 1). 뮤트 상태에서 변경해도 내부 값만 갱신됩니다.
SfxVolumeSFX 볼륨 (0 ~ 1). 뮤트 상태에서 변경해도 내부 값만 갱신됩니다.
PlayBgm(clip)BGM을 즉시 재생합니다. 동일 클립이 이미 재생 중이면 무시합니다.
PlayBgm(clip, fadeDuration)현재 BGM을 페이드 아웃한 뒤 새 클립을 페이드 인합니다. fadeDuration은 전체 전환 시간(초)이며 기본값은 0.5입니다.
StopBgm()BGM을 즉시 정지합니다.
StopBgm(fadeDuration)BGM을 페이드 아웃 후 정지합니다. 기본값은 0.5초입니다.
SetBgmVolume(volume, fadeDuration)BGM 볼륨을 지정한 시간 동안 서서히 변경합니다. fadeDuration이 0이면 즉시 적용됩니다.
MuteBgm(bool)BGM 뮤트 상태를 설정합니다. 언뮤트 시 이전 볼륨이 복원됩니다.
MuteSfx(bool)SFX 뮤트 상태를 설정합니다. 언뮤트 시 이전 볼륨이 복원됩니다.
MuteAll(bool)BGM과 SFX를 모두 뮤트/언뮤트합니다.
PlaySfx(clip)SFX를 2D로 재생합니다.
PlaySfxAt(clip, worldPosition, volumeScale)지정한 월드 좌표에서 3D 공간 음향으로 SFX를 재생합니다. volumeScale 기본값은 1.0입니다.

SFX 채널 풀​

SFX는 내부적으로 8개의 AudioSource 채널로 구성된 풀을 사용합니다.

  • 재생 요청 시 비어 있는 채널을 우선 탐색합니다.
  • 모든 채널이 사용 중이면 라운드로빈 방식으로 가장 오래된 채널을 덮어씁니다.
  • 채널 풀은 씬 전환 후에도 유지됩니다(DontDestroyOnLoad).

뮤트 동작​

MuteBgm / MuteSfx는 내부 볼륨 값(BgmVolume, SfxVolume)을 변경하지 않습니다. AudioSource의 실제 출력만 0으로 만들기 때문에 언뮤트하면 뮤트 이전 볼륨으로 즉시 복원됩니다.

audio.BgmVolume = 0.8f;
audio.MuteBgm(true);   // 실제 출력: 0, 내부 값: 0.8
audio.MuteBgm(false);  // 실제 출력: 0.8 복원

코드 예시​

BGM 크로스페이드​

var audio = ServiceLocator.Resolve<AudioManager>();

// 씬 진입 시 1초 페이드로 BGM 전환
audio.PlayBgm(lobbyBgmClip, fadeDuration: 1f);

// 보스 전투 구간 — 빠른 전환 (0.3초)
audio.PlayBgm(bossBgmClip, fadeDuration: 0.3f);

// 2초에 걸쳐 볼륨을 낮춤 (컷씬 연출 등)
audio.SetBgmVolume(0.3f, fadeDuration: 2f);

// 씬 종료 시 페이드 아웃
audio.StopBgm(fadeDuration: 1.5f);

SFX 3D 재생​

var audio = ServiceLocator.Resolve<AudioManager>();

// 폭발 위치에서 3D 사운드 재생
audio.PlaySfxAt(explosionClip, explosionObject.transform.position);

// 볼륨을 절반으로 줄여 재생
audio.PlaySfxAt(footstepClip, transform.position, volumeScale: 0.5f);

// 2D UI 효과음 재생
audio.PlaySfx(buttonClickClip);

뮤트 토글 (옵션 화면)​

var audio = ServiceLocator.Resolve<AudioManager>();

// BGM만 음소거
audio.MuteBgm(true);

// SFX만 음소거
audio.MuteSfx(true);

// 전체 음소거 해제
audio.MuteAll(false);
최종 수정: 에