Skip to content

A library for playing sounds and providing haptic feedback with ease.

License

Notifications You must be signed in to change notification settings

mergesort/FeedbackEffect

Repository files navigation

FeedbackEffect

A μ library for playing sound effects and providing haptic feedback… with ease.

BuddyBuild Pod Version Swift Version License MIT Plaform

Your app should be special. Other people's apps suck. How do we make your app extra awesome? Feedback and sound effects my friend.

Until now there has not been a unified API to allow you to integrate sound effects and haptic feedback with ease. If you're guessing that now there is, then you're right… now there is.


The API couldn't be simpler.

let selectionFeedback = HapticFeedback.notification(.success)
let soundUrl = Bundle.main.url(forResource: "Success", withExtension: "m4a")
FeedbackEffect.play(sound: soundUrl, feedback: selectionFeedback)

Q&A time

Q: Is that all?

A: Yep.

Q: Really?

A: Fine, let's go into more detail.


SoundEmitting

There are two kinds of SoundEmitting. You can provide a URL to any resource that iOS can play (such as an m4a), or use some common sounds from iOS pre-configured.

Three types conform to SoundEmitting out of the box:

  • URL
  • MessageTone
  • SoundEffect

If you'd like to add some more, all you have to do is conform to the protocol. If you find some more that are built into iOS, feel free to file a PR and it'll gladly be accepted.


HapticEmitting

There are two ways to provide a user with haptic feedback. Both HapticFeedback and VibrationFeedback conform to HapticEmitting.

  • HapticFeedback: Uses iOS's built in UIFeedbackGenerator to generate feedback effects. You can use this just how you would normally use UIImpactGenerator, UISelectionGenerator, and UINotificationFeedbackGenerator.

  • VibrationFeedback: For older devices which do not have a taptic engine. It will generate similar vibration patterns to the UIFeedbackGenerator, which unfortunately do not match UIFeedbackGenerator exactly one for one but are rather close.


Q&A part II

Q: Is that it?

A: Yep. You're on your own from here padawan. Let's leave you with a few more examples to make you feel safe though.


Examples

Uses the haptic feedback built into iOS along with the tap sound to make a user feel like they're really tapping a button.

let notificationFeedback = HapticFeedback.selection
let tapSound = SoundEffect.tap
FeedbackEffect.play(sound: tapSound, feedback: notificationFeedback)

Uses the haptic feedback built into iOS along with an success sound to make a user feel they've completed a unit of work successfully.

let selectionFeedback = HapticFeedback.notification(.success)
let soundUrl = Bundle.main.url(forResource: "Success", withExtension: "m4a")
FeedbackEffect.play(sound: soundUrl, feedback: selectionFeedback)

Uses the vibration feedback fallback (for users without 3D Touch devices) built into iOS along with a pre-configured sound effect.

let vibration = VibrationFeedback.notification
let sound = MessageTone.tweet
FeedbackEffect.play(sound: sound, feedback: vibration)

You can use just one at a time too if you wish. Just provide haptics and leave the sound parameter nil. You can also do the opposite and provide a sound with no haptics.

let vibration = HapticFeedback.notification(.error)
FeedbackEffect.play(sound: nil, feedback: vibration)

Requirements

  • iOS 10.0+
  • Xcode 8.0+

Installation

SPM will be the default supported installation method from version 1.5.0 and higher, so please integrate by using SPM.

If you're still using CocoaPods for version 1.5.0 or below you can install FeedbackEffect by adding it to your Podfile:

platform :ios, '10.0'
use_frameworks!

pod 'FeedbackEffect'

Or install it manually by downloading FeedbackEffect.swift and dropping it in your project.

About me

Hi, I'm Joe everywhere on the web, but especially on Twitter.

License

See the license for more information about how you can use TypedNotifications.