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 대상 채널 지정에 사용.