反馈效果 1.5.0

反馈效果 1.5.0

测试测试
Lang语言 SwiftSwift
许可 MIT
发布最后发布2019年7月
SPM支持SPM

Joe Fabisevich维护。



FeedbackEffect

一个易于播放音效并轻松提供触觉反馈的μ库。

BuddyBuild Pod Version Swift Version License MIT Plaform

你的应用应该特别。其他人的应用都很差。我们如何让你的应用更加出色?反馈和音效,我的朋友。

到目前为止,还没有一个统一的API允许你轻松地集成音效和触觉反馈。如果你猜测现在有了,那么你是对的……现在有了。


API再简单不过了。

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

问答时间

问:这只是全部吗?

答:是的。

问:真的吗?

答:好吧,让我们更详细地介绍一下。


声音发射

有两种《声音发射》:您可以为 iOS 可以播放的任何资源(如 m4a)提供 URL,或使用 iOS 预配置的一些常用声音。

有三种类型符合《声音发射》

  • URL
  • 消息音
  • 声音效果

如果您想添加更多,只需要遵守协议即可。如果您发现更多内置在 iOS 中的内容,请随时提交 PR,我们将热情地接受。


触觉发射

有两种方式提供给用户触觉反馈。两者 HapticFeedbackVibrationFeedback 都符合 HapticEmitting

  • 触觉反馈:使用 iOS 内置的 UIFeedbackGenerator 来生成反馈效果。您可以像通常使用 UIImpactGeneratorUISelectionGeneratorUINotificationFeedbackGenerator 一样使用它。

  • 振动反馈:用于没有触觉引擎的较旧设备。它将生成与 UIFeedbackGenerator 非常相似的振动模式,遗憾的是,它们并不完全符合 UIFeedbackGenerator,而是相当接近。


问答第二部分

问:那就是全部吗?

答:是的。从现在起,就由你自己去探索了,但我会给你一些例子,让你放心。


例子

使用内置在 iOS 中的触觉反馈和点击声音,让用户感觉像是在真正点击按钮。

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

使用内置在iOS中的触觉反馈以及成功音效,使用户感受到他们已成功完成了一个工作单元。

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

使用iOS内置的振动反馈降级(用于没有3D Touch设备的用户)以及预配置的音效。

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

如果您愿意,也可以一次只使用一个。只需要提供触觉反馈,并留空声音参数。您也可以相反地提供带有无触觉的声音。

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

需求

  • iOS 10.0+
  • Xcode 8.0+

安装

您可以使用 CocoaPods 在您的 Podfile 中添加 FeedbackEffect 来安装它。

platform :ios, '10.0'
use_frameworks!

pod 'FeedbackEffect'

或者手动安装,下载 FeedbackEffect.swift 并将其拖放到您的项目中。

关于我

嗨,我在网络上到处都可以找到我,尤其是在 Twitter 上。

许可证

有关如何使用TypedNotifications的更多信息,请参阅许可证