Table of Contents

Namespace Framework.Systems.Audio

Classes

AudioHandle

IAudioHandle 구현체. AudioSourcePool 에서 꺼낸 AudioSource 를 래핑한다.

AudioInstaller

Audio System VContainer DI 등록. RootScope.Configure() 에서 AudioInstaller.Install(builder) 를 호출한다.

AudioKeys

AudioSystem Addressable 키 상수. 매직 스트링 직접 사용 금지. Game 프로젝트에서는 별도 GameAudioKeys 클래스로 확장한다.

AudioSourcePool

AudioSource 오브젝트 풀. SFX 재생마다 new AudioSource 생성 금지. 풀 부족 시 가장 오래된 Source 재사용.

AudioSystem

IAudioSystem 구현체. Unity AudioMixer + AudioSourcePool + IAssetSystem 기반.

UISoundService

IUISoundService 구현체. IAudioSystem 에 UI 편의 메서드가 통합됐으므로 내부적으로 위임한다.

Interfaces

IAudioHandle

개별 SFX 제어 핸들 계약. PlaySFXAsync / PlayUIAsync 반환값.

IAudioSystem

Audio System 단일 진입점 계약. Gameplay 개발자는 이 인터페이스만 알면 된다.

IUISoundService

UI 사운드 편의 서비스. Button, Popup 등에서 직접 호출 가능. 내부적으로 IAudioSystem.PlayUIAsync 를 사용한다.

Enums

AudioChannel

오디오 채널 구분. AudioMixer Group 과 1:1 대응. SetVolume 대상 채널 지정에 사용.