关于Taptic Engine震动反馈

What has Happened?

上周，leader 拿着 iPhone 7 打开了网易新闻，问我：『你看，你这里的下拉刷新是短震动，我们的手机数周遥控电视的时候只有长震动，产品那边问能不能用短震动』。

然后博主就去查看了一下关于短震动的方式，整个过程可以描述为——『资料真少!』。

不过最后通过一下午的搜集，最终还是总结整理出来了这份文档，也补充了自己对 iPhone 6s 之后对 Taptic Engine 的了解。

Taptic Engine

先了解一个概念——Taptic Engine

Taptic Engine 是苹果产品上推出的全新震动模块，该元件最早出现在 Apple Watch 中。iPhone 6s 和 iPhone 6s Plus 中，也同样内置了Taptic Engine，在设计上有所升级。

Taptic Engine 振动模块为 Apple Watch 以及 iPhone 6s、iPhone 7 提供了 Force Touch 以及 3D Touch，不同的屏幕操作，可以感受到不同的振动触觉效果，带来更好的用户体验。

短震方法一 AudioServicesPlaySystemSound

常用调用：

  
  


   
   
AudioServicesPlaySystemSound(kSystemSoundID_Vibrate); 
  
  

以上代码在各个型号手机中反应为长震

API 系统版本支持：

  
  


   
   
__OSX_AVAILABLE_STARTING(__MAC_10_5,__IPHONE_2_0); 
  
  

APPLE 公开的 SystemSoundID 有：

  
  


   
   
CF_ENUM(SystemSoundID) 

   
   
{ 

   
   
kSystemSoundID_UserPreferredAlert = 0x00001000, 

   
   
kSystemSoundID_FlashScreen = 0x00000FFE, 

   
   
// this has been renamed to be consistent 

   
   
kUserPreferredAlert = kSystemSoundID_UserPreferredAlert 

   
   
}; 

   
   
  

   
   
CF_ENUM(SystemSoundID) 

   
   
{ 

   
   
kSystemSoundID_Vibrate = 0x00000FFF 

   
   
};  
  
  

以上类型 没有短震动 。

但通过以下代码，可以得到更多类型的震动：

  
  


   
   
// 普通短震，3D Touch 中 Pop 震动反馈 

   
   
AudioServicesPlaySystemSound(1520);  
  
  

  
  


   
   
// 普通短震，3D Touch 中 Peek 震动反馈 

   
   
AudioServicesPlaySystemSound(1519);  
  
  

  
  


   
   
// 连续三次短震 

   
   
AudioServicesPlaySystemSound(1521);  
  
  

但以上 ID 均未在 Apple 的 Documents 中描述。显然，这是调用了一些私有一些属性 。

关于是否调用了私有 API，也有一些讨论，可以查看这里(https://forums.developer.apple.com/thread/45628)。

短震方法二 获取 _tapticEngine

这种方法是从这里(https://unifiedsense.com/development/using-taptic-engine-on-ios.html)搜集到的。

  
  


   
   
id tapticEngine = [[UIDevice currentDevice] performSelector: NSSelectorFromString(@"_tapticEngine") 

   
   
withObject:nil]; 

   
   
[tapticEngine performSelector: NSSelectorFromString(@"actuateFeedback:") 

   
   
withObject:@(0)];  
  
  

或者：

  
  


   
   
id tapticEngine = [[UIDevice currentDevice] performSelector: NSSelectorFromString(@"_tapticEngine") 

   
   
withObject:nil]; 

   
   
  

   
   
SEL selector = NSSelectorFromString(@"actuateFeedback:"); 

   
   
int32_t arg = 1001; 

   
   
  

   
   
NSInvocation *inv = [NSInvocation invocationWithMethodSignature:[tapticEngine methodSignatureForSelector:selector]]; 

   
   
[inv setTarget:tapticEngine]; 

   
   
[inv setSelector:selector]; 

   
   
[inv setArgument:&arg atIndex:2]; 

   
   
[inv invoke];  
  
  

显然， 这是调用了私有 API 。

这些方法，在实际测试的时候发现，在 iPhone 7 上调用没有震动反馈，在 iPhone 6S Plus 上调用有震动反馈，在 iPhone 6 上调用 无反馈。

短震方法三 UIImpactFeedbackGenerator

iOS10 引入了一种新的、产生触觉反馈的方式， 帮助用户认识到不同的震动反馈有不同的含义 。这个功能的核心就是由 UIFeedbackGenerator 提供。Apple 对于 UIImpactFeedbackGenerator 有一篇介绍文档。

UIFeedbackGenerator 可以帮助你实现 haptic feedback。它的要求是：

• 支持 Taptic Engine 机型 (iPhone 7 以及 iPhone 7 Plus).
• app 需要在前台运行
• 系统 Haptics setting 需要开启

Apple 曾表示公开了 Taptic Engine 的 API，但是鲜有文档。在搜罗了各种资料后，可以认为 UIImpactFeedbackGenerator 即 Taptic Engine 的 公开 API。

它的调用方式是：

  
  


   
   
UIImpactFeedbackGenerator *generator = [[UIImpactFeedbackGenerator alloc] initWithStyle: UIImpactFeedbackStyleLight]; 

   
   
[generator prepare]; 

   
   
[generator impactOccurred];  
  
  

Others

观察 UIImpactFeedbackGenerator 你会发现它继承于 UIFeedbackGenerator。除了 UIImpactFeedbackGenerator 还有三种 FeedbackGenerator：

1. UIImpactFeedbackGenerator
2. UISelectionFeedbackGenerator
3. UINotificationFeedbackGenerator

详情可参考 Apple 的 这篇 Reference(https://developer.apple.com/reference/uikit/uifeedbackgenerator?language=objc) 。

对于震动反馈的应用，Apple 也给出了示例场景：

  
  


   
   
- (IBAction)gestureHandler:(UIPanGestureRecognizer *)sender { 

   
   
  

   
   
switch (sender.state) { 

   
   
case UIGestureRecognizerStateBegan: 

   
   
  

   
   
// Instantiate a new generator. 

   
   
self.feedbackGenerator = [[UISelectionFeedbackGenerator alloc] init]; 

   
   
  

   
   
// Prepare the generator when the gesture begins. 

   
   
[self.feedbackGenerator prepare]; 

   
   
  

   
   
break; 

   
   
  

   
   
case UIGestureRecognizerStateChanged: 

   
   
  

   
   
// Check to see if the selection has changed... 

   
   
if ([self myCustomHasSelectionChangedMethodWithTranslation:[sender translationInView: self.view]]) { 

   
   
  

   
   
// Trigger selection feedback. 

   
   
[self.feedbackGenerator selectionChanged]; 

   
   
  

   
   
// Keep the generator in a prepared state. 

   
   
[self.feedbackGenerator prepare]; 

   
   
  

   
   
} 

   
   
  

   
   
break; 

   
   
  

   
   
case UIGestureRecognizerStateCancelled: 

   
   
case UIGestureRecognizerStateEnded: 

   
   
case UIGestureRecognizerStateFailed: 

   
   
  

   
   
// Release the current generator. 

   
   
self.feedbackGenerator = nil; 

   
   
  

   
   
break; 

   
   
  

   
   
default: 

   
   
  

   
   
// Do nothing. 

   
   
break; 

   
   
} 

   
   
}  
  
  

三种方法在测试机上不同的反馈结果

总结一下，希望同样的代码能在更多的机型上实现短振，建议使用 AudioServicesPlaySystemSound(1519)。不过可能会涉及到调用私有 API。安全起见，可以使用 UIImpactFeedbackGenerator。