Class AudioManager

Manages audio playback for the Black Trigram combat game.

Handles music tracks, sound effects, and Korean martial arts audio including technique sounds, trigram stance audio, and vital point hit feedback. Uses an LRU asset cache, pooled HTMLAudioElement instances, and an AudioMonitor for performance tracking.

Example

const audio = new AudioManager({ masterVolume: 0.8 });
await audio.initialize();
await audio.playMusic("dojang_theme");
await audio.playSFX("hit_medium");

Korean

오디오관리자

Implements

IAudioManager

Index

Accessors

currentMusicTrack

get currentMusicTrack(): string | null
Returns string | null
- Defined in audio/AudioManager.ts:135

fallbackMode

get fallbackMode(): boolean
Returns boolean
- Defined in audio/AudioManager.ts:131

initialized

get initialized(): boolean
Returns boolean
- Defined in audio/AudioManager.ts:616

isInitialized

get isInitialized(): boolean
Returns boolean
Whether the audio system has been initialized
Implementation of IAudioManager.isInitialized
- Defined in audio/AudioManager.ts:127

masterVolume

get masterVolume(): number
Returns number
Implementation of IAudioManager.masterVolume
- Defined in audio/AudioManager.ts:139

musicVolume

get musicVolume(): number
Returns number
Implementation of IAudioManager.musicVolume
- Defined in audio/AudioManager.ts:147

muted

get muted(): boolean
Returns boolean
Implementation of IAudioManager.muted
- Defined in audio/AudioManager.ts:151

sfxVolume

get sfxVolume(): number
Returns number
Implementation of IAudioManager.sfxVolume
- Defined in audio/AudioManager.ts:143

Constructors

constructor

new AudioManager(config?: Partial<AudioConfig>): AudioManager
Parameters
- Optionalconfig: Partial<AudioConfig>
Returns AudioManager
- Defined in audio/AudioManager.ts:86

Methods

batchLoadAssets

batchLoadAssets(
    assets: readonly AudioAsset[],
    options?: LoadOptions,
    onProgress?: (loaded: number, total: number) => void,
): Promise<void>
Batch load multiple assets with progress tracking
Parameters
- assets: readonly AudioAsset[]
  Array of audio assets to load
- Optionaloptions: LoadOptions
  Optional load configuration (timeout, retries, etc.)
- OptionalonProgress: (loaded: number, total: number) => void
  Optional callback for progress updates with loaded and total counts
Returns Promise<void>
Promise that resolves when all assets are processed
- Defined in audio/AudioManager.ts:627

clearMemoryWarnings

clearMemoryWarnings(): void
Clear memory warnings

Returns void
- Defined in audio/AudioManager.ts:770

crossfade

crossfade(
    fromTrackId: string,
    toTrackId: string,
    duration?: number,
): Promise<void>
Parameters
- fromTrackId: string
- toTrackId: string
- duration: number = 1000
Returns Promise<void>
- Defined in audio/AudioManager.ts:561

`Private`estimateAudioSize

estimateAudioSize(_asset: AudioAsset): number
Estimate audio asset size in bytes 바이트 단위의 오디오 자산 크기 추정
Parameters
- _asset: AudioAsset
Returns number
Estimated size in bytes
- Defined in audio/AudioManager.ts:268

fadeIn

fadeIn(trackId: string, duration?: number): Promise<void>
Parameters
- trackId: string
- duration: number = 1000
Returns Promise<void>
Implementation of IAudioManager.fadeIn
- Defined in audio/AudioManager.ts:538

fadeOut

fadeOut(duration?: number): Promise<void>
Parameters
- duration: number = 1000
Returns Promise<void>
Implementation of IAudioManager.fadeOut
- Defined in audio/AudioManager.ts:515

getCacheStats

getCacheStats(): {
    lruCache: {
        assetCount: number;
        criticalCount: number;
        evictionCount: number;
        hitCount: number;
        hitRate: number;
        missCount: number;
        totalSize: number;
        utilizationPercent: number;
    };
    poolStats: Map<string, PoolStatistics>;
    soundCache: number;
}
Get cache statistics including LRU cache metrics LRU 캐시 메트릭을 포함한 캐시 통계 가져오기

Returns {
    lruCache: {
        assetCount: number;
        criticalCount: number;
        evictionCount: number;
        hitCount: number;
        hitRate: number;
        missCount: number;
        totalSize: number;
        utilizationPercent: number;
    };
    poolStats: Map<string, PoolStatistics>;
    soundCache: number;
}
Cache statistics
- Defined in audio/AudioManager.ts:693

getFPSImpact

getFPSImpact(): AudioFPSImpact
Get FPS impact analysis showing baseline vs current FPS and detected drops

Returns AudioFPSImpact
FPS impact analysis object
- Defined in audio/AudioManager.ts:734

getLoadedAssets

getLoadedAssets(): ReadonlyMap<string, HTMLAudioElement>
Returns ReadonlyMap<string, HTMLAudioElement>
A snapshot of all currently loaded sound elements
- Defined in audio/AudioManager.ts:573

getLoaderStatistics

getLoaderStatistics(): {
    cached: number;
    loading: number;
    totalAttempts: number;
}
Get loader statistics including cached assets and loading state

Returns { cached: number; loading: number; totalAttempts: number }
Loader statistics object
- Defined in audio/AudioManager.ts:792

getMasterVolume

getMasterVolume(): number
Returns number
- Defined in audio/AudioManager.ts:604

getMemoryStats

getMemoryStats(): AudioMemoryStats
Get memory statistics including total loaded MB, asset count, and warnings

Returns AudioMemoryStats
Memory statistics object
- Defined in audio/AudioManager.ts:718

getMemoryWarnings

getMemoryWarnings(): readonly MemoryWarning[]
Get all memory warnings

Returns readonly MemoryWarning[]
Array of memory warnings
- Defined in audio/AudioManager.ts:763

getMonitoringReport

getMonitoringReport(): {
    fps: AudioFPSImpact;
    memory: AudioMemoryStats;
    performance: AudioPerformanceStats;
    warnings: readonly MemoryWarning[];
}
Get comprehensive monitoring report including memory, performance, FPS, and warnings

Returns {
    fps: AudioFPSImpact;
    memory: AudioMemoryStats;
    performance: AudioPerformanceStats;
    warnings: readonly MemoryWarning[];
}
Comprehensive monitoring report object
- Defined in audio/AudioManager.ts:750

getMusicVolume

getMusicVolume(): number
Returns number
- Defined in audio/AudioManager.ts:608

getPerformanceStats

getPerformanceStats(): AudioPerformanceStats
Get performance statistics including load times and playback latency

Returns AudioPerformanceStats
Performance statistics object
- Defined in audio/AudioManager.ts:726

getPoolStatistics

getPoolStatistics(
assetId?: string,
): PoolStatistics | Map<string, PoolStatistics> | undefined
Get pool statistics for a specific asset or all pools
Parameters
- OptionalassetId: string
  Optional asset ID to get specific pool stats
Returns PoolStatistics | Map<string, PoolStatistics> | undefined
Pool statistics for the specified asset or all pools
- Defined in audio/AudioManager.ts:779

getSfxVolume

getSfxVolume(): number
Returns number
- Defined in audio/AudioManager.ts:612

initialize

initialize(config?: AudioConfig): Promise<void>
Parameters
- Optionalconfig: AudioConfig
Returns Promise<void>
Implementation of IAudioManager.initialize
- Defined in audio/AudioManager.ts:155

loadAsset

loadAsset(asset: AudioAsset, options?: LoadOptions): Promise<void>
Parameters
- asset: AudioAsset
- Optionaloptions: LoadOptions
Returns Promise<void>
Implementation of IAudioManager.loadAsset
- Defined in audio/AudioManager.ts:188

mute

mute(): void
Returns void
Implementation of IAudioManager.mute
- Defined in audio/AudioManager.ts:501

playDojiangAmbience

playDojiangAmbience(): Promise<void>
Returns Promise<void>
Implementation of IAudioManager.playDojiangAmbience
- Defined in audio/AudioManager.ts:599

playKoreanTechniqueSound

playKoreanTechniqueSound(techniqueId: string, archetype: string): Promise<void>
Parameters
- techniqueId: string
- archetype: string
Returns Promise<void>
Implementation of IAudioManager.playKoreanTechniqueSound
- Defined in audio/AudioManager.ts:581

playMusic

playMusic(id: string, volume?: number): Promise<void>
Parameters
- id: string
- Optionalvolume: number
Returns Promise<void>
Implementation of IAudioManager.playMusic
- Defined in audio/AudioManager.ts:361

playSFX

playSFX(id: string, volume?: number): Promise<void>
Alias for playSoundEffect — preferred for explicit volume control.
Parameters
- id: string
  Sound effect identifier
- Optionalvolume: number
  Override volume (defaults to sfxVolume × masterVolume)
Returns Promise<void>
Implementation of IAudioManager.playSFX
- Defined in audio/AudioManager.ts:320

playSoundEffect

playSoundEffect(id: string): Promise<void>
Parameters
- id: string
Returns Promise<void>
Implementation of IAudioManager.playSoundEffect
- Defined in audio/AudioManager.ts:274

playTrigramStanceSound

playTrigramStanceSound(stance: string): Promise<void>
Parameters
- stance: string
Returns Promise<void>
Implementation of IAudioManager.playTrigramStanceSound
- Defined in audio/AudioManager.ts:589

playVitalPointHitSound

playVitalPointHitSound(severity: string): Promise<void>
Parameters
- severity: string
Returns Promise<void>
Implementation of IAudioManager.playVitalPointHitSound
- Defined in audio/AudioManager.ts:594

playVoice

playVoice(id: string): Promise<void>
Parameters
- id: string
Returns Promise<void>
- Defined in audio/AudioManager.ts:577

`Private`releasePooledAudio

releasePooledAudio(id: string, audio: HTMLAudioElement): void
Helper method to release pooled audio back to the pool after playback
Parameters
- id: string
  Asset ID
- audio: HTMLAudioElement
  Audio element to release
Returns void
- Defined in audio/AudioManager.ts:112

setVolume

setVolume(type: "sfx" | "music" | "voice" | "master", volume: number): void
Parameters
- type: "sfx" | "music" | "voice" | "master"
- volume: number
Returns void
Implementation of IAudioManager.setVolume
- Defined in audio/AudioManager.ts:480

stopAll

stopAll(): void
Returns void
- Defined in audio/AudioManager.ts:470

stopMusic

stopMusic(): void
Returns void
Implementation of IAudioManager.stopMusic
- Defined in audio/AudioManager.ts:461

unloadAsset

unloadAsset(assetId: string): boolean
Unload an asset to free memory
Parameters
- assetId: string
  ID of the asset to unload
Returns boolean
true if asset was unloaded, false if asset was not found
- Defined in audio/AudioManager.ts:665

unmute

unmute(): void
Returns void
Implementation of IAudioManager.unmute
- Defined in audio/AudioManager.ts:508

updateFPS

updateFPS(fps: number): void
Update FPS measurement for monitoring
Parameters
- fps: number
  Current frames per second measurement
Returns void
- Defined in audio/AudioManager.ts:742

`Private`waitForMusicLoad

waitForMusicLoad(id: string, maxWaitMs?: number): Promise<void>
Wait for a music asset to finish loading 음악 자산 로드가 완료될 때까지 대기
Parameters
- id: string
  Music track ID
- maxWaitMs: number = 5000
  Maximum time to wait in milliseconds
Returns Promise<void>
- Defined in audio/AudioManager.ts:448

Properties

`Private`_currentMusicTrack

_currentMusicTrack: string | null = null

`Private`_fallbackMode

_fallbackMode: boolean = false

`Private`_isInitialized

_isInitialized: boolean = false

`Private`_masterVolume

_masterVolume: number = 1.0

`Private`_musicVolume

_musicVolume: number = 0.7

`Private`_muted

_muted: boolean = false

`Private`_sfxVolume

_sfxVolume: number = 0.8

`Private`assetLoader

assetLoader: AudioAssetLoader

`Private`audioCache

audioCache: AudioCache

`Private`audioPool

audioPool: AudioElementPool

`Private`currentMusic

currentMusic: HTMLAudioElement | null = null

`Private`frequentSounds

frequentSounds: Set<string> = ...

`Private`loadingMusic

loadingMusic: Set<string> = ...

Music assets currently being loaded — prevents race conditions on concurrent playMusic calls

`Private`monitor

monitor: AudioMonitor

`Private`soundCache

soundCache: Map<string, HTMLAudioElement> = ...

Class AudioManager

Example

Korean

Implements

Index

Accessors

Constructors

Methods

Properties

Accessors

currentMusicTrack

Returns string | null

fallbackMode

Returns boolean

initialized

Returns boolean

isInitialized

Returns boolean

masterVolume

Returns number

musicVolume

Returns number

muted

Returns boolean

sfxVolume

Returns number

Constructors

constructor

Parameters

Returns AudioManager

Methods

batchLoadAssets

Parameters

Returns Promise<void>

clearMemoryWarnings

Returns void

crossfade

Parameters

Returns Promise<void>

PrivateestimateAudioSize

Parameters

Returns number

fadeIn

Parameters

Returns Promise<void>

fadeOut

Parameters

Returns Promise<void>

getCacheStats

Returns { lruCache: { assetCount: number; criticalCount: number; evictionCount: number; hitCount: number; hitRate: number; missCount: number; totalSize: number; utilizationPercent: number; }; poolStats: Map<string, PoolStatistics>; soundCache: number;}

getFPSImpact

Returns AudioFPSImpact

getLoadedAssets

Returns ReadonlyMap<string, HTMLAudioElement>

getLoaderStatistics

Returns { cached: number; loading: number; totalAttempts: number }

getMasterVolume

Returns number

getMemoryStats

Returns AudioMemoryStats

getMemoryWarnings

Returns readonly MemoryWarning[]

getMonitoringReport

Returns { fps: AudioFPSImpact; memory: AudioMemoryStats; performance: AudioPerformanceStats; warnings: readonly MemoryWarning[];}

getMusicVolume

Returns number

getPerformanceStats

Returns AudioPerformanceStats

getPoolStatistics

Parameters

Returns PoolStatistics | Map<string, PoolStatistics> | undefined

getSfxVolume

Returns number

initialize

Parameters

Returns Promise<void>

loadAsset

Parameters

Returns Promise<void>

mute

`Private`estimateAudioSize

Returns {
lruCache: {
assetCount: number;
criticalCount: number;
evictionCount: number;
hitCount: number;
hitRate: number;
missCount: number;
totalSize: number;
utilizationPercent: number;
};
poolStats: Map<string, PoolStatistics>;
soundCache: number;
}

Returns {
fps: AudioFPSImpact;
memory: AudioMemoryStats;
performance: AudioPerformanceStats;
warnings: readonly MemoryWarning[];
}

`Private`releasePooledAudio

`Private`waitForMusicLoad

`Private`_currentMusicTrack

`Private`_fallbackMode

`Private`_isInitialized

`Private`_masterVolume

`Private`_musicVolume

`Private`_muted

`Private`_sfxVolume

`Private`assetLoader

`Private`audioCache

`Private`audioPool

`Private`currentMusic

`Private`frequentSounds

`Private`loadingMusic

`Private`monitor

`Private`soundCache