SPB Git

Repository Public License

AudioDirector.swift 7.7 KB 184 lines swift

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
Files main
Menu

Theme