Repository Public License
1//2// ORIX Audio3// File: ORIXAudio/Services/PlaybackEngine.swift4// Description: Playback with seeking, variable speed (pitch preserved), selection looping, marker navigation and Now Playing integration.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8//9import AVFoundation10import Foundation11import MediaPlayer12import Observation1314@MainActor @Observable15final class PlaybackEngine {16 private(set) var isPlaying = false17 private(set) var currentTime: Double = 018 private(set) var duration: Double = 019 private(set) var loadedURL: URL?20 private(set) var title = ""21 var rate: Float = 1 { didSet { timePitch.rate = rate; updateNowPlaying() } }22 /// When set, playback wraps from the end of the range back to its start.23 var loopRange: ClosedRange<Double>? { didSet { if isPlaying { restart(at: currentTime) } } }24 static let rates: [Float] = [0.5, 0.75, 1, 1.25, 1.5, 2]2526 private let engine = AVAudioEngine()27 private let player = AVAudioPlayerNode()28 private let timePitch = AVAudioUnitTimePitch()29 private var file: AVAudioFile?30 private var segmentStart: Double = 031 private var generation = 032 private var ticker: Task<Void, Never>?33 private var observers: [NSObjectProtocol] = []34 private var remoteCommandsInstalled = false3536 init() {37 engine.attach(player); engine.attach(timePitch)38 observers.append(NotificationCenter.default.addObserver(forName: AVAudioSession.interruptionNotification, object: nil, queue: .main) { [weak self] note in39 let began = (note.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt) == AVAudioSession.InterruptionType.began.rawValue40 Task { @MainActor in if began { self?.pause() } }41 })42 observers.append(NotificationCenter.default.addObserver(forName: AVAudioSession.routeChangeNotification, object: nil, queue: .main) { [weak self] note in43 // Headphones unplugged: pause rather than blast the speaker.44 let reason = (note.userInfo?[AVAudioSessionRouteChangeReasonKey] as? UInt).flatMap(AVAudioSession.RouteChangeReason.init)45 Task { @MainActor in if reason == .oldDeviceUnavailable { self?.pause() } }46 })47 }4849 func load(url: URL, title: String) throws {50 if loadedURL == url, file != nil { return }51 stop()52 let f = try AVAudioFile(forReading: url)53 file = f; loadedURL = url; self.title = title54 duration = Double(f.length) / f.processingFormat.sampleRate55 currentTime = 0; loopRange = nil56 engine.disconnectNodeOutput(player); engine.disconnectNodeOutput(timePitch)57 engine.connect(player, to: timePitch, format: f.processingFormat)58 engine.connect(timePitch, to: engine.mainMixerNode, format: f.processingFormat)59 timePitch.rate = rate60 }6162 func unload() { stop(); file = nil; loadedURL = nil; duration = 0; currentTime = 0 }6364 func play() {65 guard let file, !isPlaying else { return }66 AudioSessionManager.shared.activateForPlayback()67 var start = currentTime68 if start >= duration - 0.02 { start = 0 }69 if let loopRange, !(loopRange.contains(start)) { start = loopRange.lowerBound }70 schedule(file: file, from: start)71 do { if !engine.isRunning { try engine.start() }; player.play() } catch { return }72 isPlaying = true73 installRemoteCommands()74 startTicker(); updateNowPlaying()75 }7677 func pause() {78 guard isPlaying else { return }79 currentTime = playerTime()80 generation += 181 player.stop()82 isPlaying = false83 ticker?.cancel(); updateNowPlaying()84 }8586 func stop() {87 generation += 188 player.stop(); engine.stop()89 isPlaying = false90 ticker?.cancel()91 }9293 func togglePlay() { isPlaying ? pause() : play() }9495 func seek(to time: Double) {96 let t = max(0, min(duration, time))97 if isPlaying { restart(at: t) } else { currentTime = t; updateNowPlaying() }98 }99100 func skip(_ seconds: Double) { seek(to: currentTime + seconds) }101102 private func restart(at time: Double) {103 guard let file else { return }104 generation += 1105 player.stop()106 schedule(file: file, from: time)107 player.play()108 updateNowPlaying()109 }110111 private func schedule(file: AVAudioFile, from start: Double) {112 let fs = file.processingFormat.sampleRate113 let end = loopRange.map { min($0.upperBound, duration) } ?? duration114 let startFrame = AVAudioFramePosition(max(0, min(start, end)) * fs)115 let count = AVAudioFrameCount(max(0, AVAudioFramePosition(end * fs) - startFrame))116 segmentStart = Double(startFrame) / fs117 currentTime = segmentStart118 generation += 1119 let token = generation120 guard count > 0 else { return }121 player.scheduleSegment(file, startingFrame: startFrame, frameCount: count, at: nil, completionCallbackType: .dataPlayedBack) { [weak self] _ in122 Task { @MainActor in self?.segmentFinished(token) }123 }124 }125126 private func segmentFinished(_ token: Int) {127 guard token == generation, let file else { return }128 if let loopRange {129 schedule(file: file, from: loopRange.lowerBound)130 player.play()131 } else {132 player.stop()133 isPlaying = false134 currentTime = duration135 ticker?.cancel(); updateNowPlaying()136 }137 }138139 private func playerTime() -> Double {140 guard let file, let nodeTime = player.lastRenderTime, nodeTime.isSampleTimeValid, let t = player.playerTime(forNodeTime: nodeTime) else { return currentTime }141 // The player node counts source frames consumed; the time-pitch unit downstream changes how fast they are pulled.142 return min(duration, segmentStart + Double(max(0, t.sampleTime)) / file.processingFormat.sampleRate)143 }144145 private func startTicker() {146 ticker?.cancel()147 ticker = Task { [weak self] in148 while !Task.isCancelled {149 guard let self, self.isPlaying else { return }150 self.currentTime = self.playerTime()151 try? await Task.sleep(for: .milliseconds(33))152 }153 }154 }155156 // MARK: Now Playing157158 private func updateNowPlaying() {159 guard loadedURL != nil else { MPNowPlayingInfoCenter.default().nowPlayingInfo = nil; return }160 MPNowPlayingInfoCenter.default().nowPlayingInfo = [161 MPMediaItemPropertyTitle: title, MPMediaItemPropertyArtist: "ORIX Audio", MPMediaItemPropertyPlaybackDuration: duration,162 MPNowPlayingInfoPropertyElapsedPlaybackTime: currentTime, MPNowPlayingInfoPropertyPlaybackRate: isPlaying ? Double(rate) : 0,163 ]164 }165166 private func installRemoteCommands() {167 guard !remoteCommandsInstalled else { return }168 remoteCommandsInstalled = true169 let c = MPRemoteCommandCenter.shared()170 c.playCommand.addTarget { [weak self] _ in Task { @MainActor in self?.play() }; return .success }171 c.pauseCommand.addTarget { [weak self] _ in Task { @MainActor in self?.pause() }; return .success }172 c.togglePlayPauseCommand.addTarget { [weak self] _ in Task { @MainActor in self?.togglePlay() }; return .success }173 c.skipForwardCommand.preferredIntervals = [15]; c.skipBackwardCommand.preferredIntervals = [15]174 c.skipForwardCommand.addTarget { [weak self] _ in Task { @MainActor in self?.skip(15) }; return .success }175 c.skipBackwardCommand.addTarget { [weak self] _ in Task { @MainActor in self?.skip(-15) }; return .success }176 c.changePlaybackPositionCommand.addTarget { [weak self] event in177 let position = (event as? MPChangePlaybackPositionCommandEvent)?.positionTime ?? 0178 Task { @MainActor in self?.seek(to: position) }179 return .success180 }181 }182}183