Repository Public License
1// ORIX Arcade2// File: AudioHaptics/AudioDirector.swift3// Description: Audio playback — pooled SFX voices with pitch control and a looping music bed, with separate volumes, on an ambient session.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import AVFoundation89private nonisolated final class BufferBox: @unchecked Sendable {10 let buffers: [String: AVAudioPCMBuffer]11 init(_ buffers: [String: AVAudioPCMBuffer]) { self.buffers = buffers }12}1314final class AudioDirector {15 enum Cue: String, CaseIterable, Sendable {16 case tap, confirm, back, coin, star, win, record, fail17 case knock, thud, crash, boom, whoosh, launch18 case horn, siren, tick, pass, combo, engine19 case upgrade, warning, drill, crumble, hiss, gem20 }2122 enum Music: String, Sendable { case lobby, domino, dig, traffic }2324 private let enabled: Bool25 private let engine = AVAudioEngine()26 private let sfxMixer = AVAudioMixerNode()27 private let musicMixer = AVAudioMixerNode()28 private let musicPlayer = AVAudioPlayerNode()29 private var voices: [(player: AVAudioPlayerNode, speed: AVAudioUnitVarispeed)] = []30 private var nextVoice = 031 private var effects: [Cue: AVAudioPCMBuffer] = [:]32 private var musicCache: [Music: AVAudioPCMBuffer] = [:]33 private var currentMusic: Music?34 private var lastPlayed: [Cue: TimeInterval] = [:]35 private var musicOn = true, sfxOn = true36 private var musicVolume: Float = 0.6, sfxVolume: Float = 0.8537 private var started = false38 private var observers: [NSObjectProtocol] = []3940 private nonisolated static let format = AVAudioFormat(standardFormatWithSampleRate: Synth.sampleRate, channels: 2)!4142 init(enabled: Bool = true) {43 self.enabled = enabled44 guard enabled else { return }45 // Ambient: obeys the silent switch and never interrupts the player's own music.46 try? AVAudioSession.sharedInstance().setCategory(.ambient, options: [.mixWithOthers])47 engine.attach(sfxMixer)48 engine.attach(musicMixer)49 engine.attach(musicPlayer)50 engine.connect(sfxMixer, to: engine.mainMixerNode, format: Self.format)51 engine.connect(musicMixer, to: engine.mainMixerNode, format: Self.format)52 engine.connect(musicPlayer, to: musicMixer, format: Self.format)53 for _ in 0..<10 {54 let player = AVAudioPlayerNode(), speed = AVAudioUnitVarispeed()55 engine.attach(player)56 engine.attach(speed)57 engine.connect(player, to: speed, format: Self.format)58 engine.connect(speed, to: sfxMixer, format: Self.format)59 voices.append((player, speed))60 }61 let center = NotificationCenter.default62 observers.append(center.addObserver(forName: AVAudioSession.interruptionNotification, object: nil, queue: .main) { [weak self] note in63 let ended = (note.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt) == AVAudioSession.InterruptionType.ended.rawValue64 MainActor.assumeIsolated { if ended { self?.resume() } }65 })66 observers.append(center.addObserver(forName: .AVAudioEngineConfigurationChange, object: engine, queue: .main) { [weak self] _ in67 MainActor.assumeIsolated { self?.restart() }68 })69 start()70 Task.detached(priority: .userInitiated) {71 var rendered: [String: AVAudioPCMBuffer] = [:]72 for cue in Cue.allCases { rendered[cue.rawValue] = Self.buffer(from: Synth.effect(cue)) }73 let box = BufferBox(rendered)74 await MainActor.run { [weak self] in75 for cue in Cue.allCases { self?.effects[cue] = box.buffers[cue.rawValue] }76 }77 }78 }7980 private nonisolated static func buffer(from mono: [Float]) -> AVAudioPCMBuffer? {81 guard let buffer = AVAudioPCMBuffer(pcmFormat: format, frameCapacity: AVAudioFrameCount(mono.count)),82 let channels = buffer.floatChannelData else { return nil }83 buffer.frameLength = AVAudioFrameCount(mono.count)84 let delay = Int(Synth.sampleRate * 0.013)85 for i in 0..<mono.count {86 channels[0][i] = mono[i]87 // A touch of width: the right channel blends in a slightly delayed copy.88 channels[1][i] = i >= delay ? 0.8 * mono[i] + 0.2 * mono[i - delay] : mono[i]89 }90 return buffer91 }9293 // MARK: Lifecycle9495 private func start() {96 guard enabled, !engine.isRunning else { return }97 try? AVAudioSession.sharedInstance().setActive(true)98 engine.prepare()99 guard (try? engine.start()) != nil else { return }100 started = true101 applyVolumes()102 for voice in voices { voice.player.play() }103 if let music = currentMusic { currentMusic = nil; setMusic(music) }104 }105106 private func restart() {107 guard enabled else { return }108 engine.stop()109 start()110 }111112 func suspend() {113 guard enabled, engine.isRunning else { return }114 engine.pause()115 }116117 func resume() {118 guard enabled else { return }119 if engine.isRunning { return }120 try? AVAudioSession.sharedInstance().setActive(true)121 if (try? engine.start()) == nil { restart(); return }122 for voice in voices where !voice.player.isPlaying { voice.player.play() }123 if currentMusic != nil, !musicPlayer.isPlaying { musicPlayer.play() }124 }125126 func apply(musicOn: Bool, sfxOn: Bool, musicVolume: Float, sfxVolume: Float) {127 self.musicOn = musicOn128 self.sfxOn = sfxOn129 self.musicVolume = musicVolume130 self.sfxVolume = sfxVolume131 applyVolumes()132 }133134 private func applyVolumes() {135 guard enabled else { return }136 sfxMixer.outputVolume = sfxOn ? sfxVolume : 0137 musicMixer.outputVolume = musicOn ? musicVolume * 0.55 : 0138 }139140 // MARK: Playback141142 /// Plays a sound effect. `pitch` 0.5…2 retunes it (rising combos, varied knocks); bursts of the same cue are rate-limited.143 func play(_ cue: Cue, pitch: Float = 1, volume: Float = 1) {144 guard enabled, started, sfxOn, engine.isRunning, let buffer = effects[cue] else { return }145 let now = ProcessInfo.processInfo.systemUptime146 if let last = lastPlayed[cue], now - last < 0.035 { return }147 lastPlayed[cue] = now148 let voice = voices[nextVoice]149 nextVoice = (nextVoice + 1) % voices.count150 voice.speed.rate = min(max(pitch, 0.5), 2)151 voice.player.volume = min(max(volume, 0), 1)152 voice.player.scheduleBuffer(buffer, at: nil, options: .interrupts)153 if !voice.player.isPlaying { voice.player.play() }154 }155156 /// Switches the looping music bed; `nil` stops it. Loops are rendered off the main thread on first use.157 func setMusic(_ music: Music?) {158 guard enabled, music != currentMusic else { return }159 currentMusic = music160 guard started else { return }161 musicPlayer.stop()162 guard let music else { return }163 if let cached = musicCache[music] {164 schedule(cached)165 return166 }167 Task.detached(priority: .utility) {168 guard let buffer = Self.buffer(from: Synth.musicLoop(music)) else { return }169 let box = BufferBox([music.rawValue: buffer])170 await MainActor.run { [weak self] in171 guard let self, let rendered = box.buffers[music.rawValue] else { return }172 self.musicCache = [music: rendered]173 if self.currentMusic == music { self.schedule(rendered) }174 }175 }176 }177178 private func schedule(_ buffer: AVAudioPCMBuffer) {179 guard engine.isRunning else { return }180 musicPlayer.scheduleBuffer(buffer, at: nil, options: [.loops, .interrupts])181 musicPlayer.play()182 }183}184