Haptica - SwiftGit

Framework UI Components

Haptica

September 10, 2023

Haptica is an easy haptic feedback generator.


                                              
                                                $ pod try Haptica

Requirements

iOS 9.0+
Xcode 8.0+
Swift 5 (Haptica 3.x), Swift 4 (Haptica 2.x), Swift 3 (Haptica 1.x)

Haptic Feedback Requirements:

A device with a supported Taptic Engine.
App is running in the foreground.
System Haptics setting is enabled.

Usage

Generate using a haptic feedback type.


                                              
                                                Haptic.impact(.light).generate()

Feedback Types

Impact: (UIImpactFeedbackStyle) – Use impact feedback generators to indicate that an impact has occurred. For example, you might trigger impact feedback when a user interface object collides with something or snaps into place.
- light
- medium
- heavy
Notification: (UINotificationFeedbackType) – Use notification feedback to communicate that a task or action has succeeded, failed, or produced a warning of some kind.
- success
- warning
- error
Selection – Use selection feedback to communicate movement through a series of discrete values.

Vibration Patterns

Play a custom vibration pattern:


                                              
                                                Haptic.play(“..oO-Oo..”, delay: 0.1)

Use pattern symbols to represent custom vibrations.

O – heavy impact
o – medium impact
. – light impact
X – rigid impact
x – soft impact
- – wait 0.1 second

Or play a symphony of notes:


                                              
                                                Haptic.play([.haptic(.impact(.light)), .haptic(.impact(.heavy)), .wait(0.1), .haptic(.impact(.heavy)), .haptic(.impact(.light))])

UIButton Extension

To enable haptic feedback on buttons, set these properties:

isHaptic – enables haptic feedback
hapticType – haptic feedback type


                                              
                                                button.isHaptic = true

button.hapticType = .impact(.light)

or use these functions to set the haptic feedback type for control events:

addHaptic() – add haptic feedback for control events
removeHaptic() – remove haptic feedback for control events


                                              
                                                button.addHaptic(.selection, forControlEvents: .touchDown)

button.removeHaptic(forControlEvents: .touchDown)

Functions/Properties


                                              
                                                var isHaptic: Bool // enables haptic feedback

var hapticType: Haptic? // haptic feedback type

var hapticControlEvents: UIControl.Event? // haptic feedback control events

func addHaptic(_ haptic: Haptic, forControlEvents events: UIControl.Event) {} // add haptic feedback for control events

func removeHaptic(forControlEvents events: UIControl.Event) {} // remove haptic feedback for control events

Sound Effects

Add sound effects to Haptica using Peep.


                                              
                                                Peep.play(sound: KeyPress.tap)

Installation

CocoaPods

To install with CocoaPods, simply add this in your Podfile:


                                              
                                                use_frameworks!

pod “Haptica”

Carthage

To install with Carthage, simply add this in your Cartfile:


                                              
                                                github “efremidze/Haptica”

GitHub

View Github

#apple #carthage #cocoapods #feedback #ios #swift #uibutton