SPB Git

Repository Public License

HapticsDirector.swift 3.4 KB 87 lines swift

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

Theme