Repository Public License
1// ORIX Arcade2// File: AudioHaptics/HapticsDirector.swift3// Description: Core Haptics patterns for taps, impacts, combos, near misses, success and failure — rate-limited so it never buzzes constantly.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import CoreHaptics8import Foundation910final class HapticsDirector {11 enum Pattern: Equatable {12 case tap13 case select14 /// 0…1 strength, e.g. scaled by collision energy.15 case impact(Float)16 case success17 case failure18 /// Rising with the combo step.19 case combo(Int)20 case nearMiss21 case warning22 }2324 var enabled: Bool25 private var engine: CHHapticEngine?26 private let supported: Bool27 private var lastTime: TimeInterval = 02829 init(enabled: Bool = true) {30 self.enabled = enabled31 supported = CHHapticEngine.capabilitiesForHardware().supportsHaptics32 guard supported, enabled else { return }33 prepare()34 }3536 private func prepare() {37 guard supported, engine == nil else { return }38 guard let created = try? CHHapticEngine() else { return }39 created.isAutoShutdownEnabled = true40 created.playsHapticsOnly = true41 created.resetHandler = { [weak created] in try? created?.start() }42 engine = created43 try? created.start()44 }4546 func play(_ pattern: Pattern) {47 guard enabled, supported else { return }48 let now = ProcessInfo.processInfo.systemUptime49 let minimumGap: TimeInterval = switch pattern {50 case .success, .failure: 051 default: 0.0552 }53 guard now - lastTime >= minimumGap else { return }54 lastTime = now55 prepare()56 guard let engine else { return }57 let events = Self.events(for: pattern)58 guard let haptic = try? CHHapticPattern(events: events, parameters: []),59 let player = try? engine.makePlayer(with: haptic) else { return }60 try? engine.start()61 try? player.start(atTime: CHHapticTimeImmediate)62 }6364 private static func transient(_ intensity: Float, _ sharpness: Float, at time: TimeInterval = 0) -> CHHapticEvent {65 CHHapticEvent(eventType: .hapticTransient,66 parameters: [.init(parameterID: .hapticIntensity, value: intensity), .init(parameterID: .hapticSharpness, value: sharpness)],67 relativeTime: time)68 }6970 private static func events(for pattern: Pattern) -> [CHHapticEvent] {71 switch pattern {72 case .tap: [transient(0.45, 0.6)]73 case .select: [transient(0.3, 0.9)]74 case .impact(let strength): [transient(0.3 + 0.7 * min(max(strength, 0), 1), 0.35 + 0.3 * strength)]75 case .success: [transient(0.5, 0.5), transient(0.7, 0.7, at: 0.09), transient(1, 0.9, at: 0.2)]76 case .failure:77 [transient(1, 0.2),78 CHHapticEvent(eventType: .hapticContinuous,79 parameters: [.init(parameterID: .hapticIntensity, value: 0.6), .init(parameterID: .hapticSharpness, value: 0.1)],80 relativeTime: 0.03, duration: 0.28)]81 case .combo(let step): [transient(min(0.4 + Float(step) * 0.08, 1), min(0.5 + Float(step) * 0.06, 1))]82 case .nearMiss: [transient(0.6, 1), transient(0.35, 1, at: 0.06)]83 case .warning: [transient(0.7, 0.3), transient(0.7, 0.3, at: 0.14)]84 }85 }86}87