3D Touch学习笔记

2015年，苹果发布了iOS9以及iphone6s及iphone6s Plus。其中最吸引大家的就是新的触控方式3D Touch。临近年底工作不忙，学习了一下3D Touch的简单使用，在这儿和大家分享一下。

参考苹果官方文档3D Touch APIS

1.Home Screen Quick Actions

主屏幕快速操作，当按压桌面图标时，会出现如下图所示菜单（以QQ为例）：

Quick Actions.png

想要实现这种菜单，有静态和动态两种设置方法。静态添加方法就是在info.plist中添加如下字段：

静态添加.png

可以现实如下效果：

静态添加实现效果.png

动态添加需要Application在iOS9之后新增的一个属性：

@property (nullable, nonatomic, copy) NSArray<UIApplicationShortcutItem *> *shortcutItems NS_AVAILABLE_IOS(9_0) __TVOS_PROHIBITED;

然后在项目中添加代码：

UIApplicationShortcutIcon *icon1 = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePlay];
UIMutableApplicationShortcutItem *item1 = [[UIMutableApplicationShortcutItem alloc] initWithType:@"playItem" localizedTitle:@"play" localizedSubtitle:@"打开" icon:icon1 userInfo:nil];

UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
UIMutableApplicationShortcutItem *item2 = [[UIMutableApplicationShortcutItem alloc]initWithType:@"shareItem" localizedTitle:@"share" localizedSubtitle:@"分享" icon:icon2 userInfo:nil];

[UIApplication sharedApplication].shortcutItems = @[item1,item2];

效果如下图所示：

动态添加效果.png

接下来为大家列举一下UIApplicationShortcutItem每个参数的含义：

UIApplicationShortcutItem.png
通过以上方法，就可以设置符合自己需求的快捷菜单了,不过要注意的是：
动态添加方法需要代码执行过一次才会被加载,静态方法比动态方法优先加载。并且最多只能有4个shortcutItems。

OK，快捷菜单已经设置完毕，然后为shortcutItem添加回调就可以了：
- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler{

if ([shortcutItem.type isEqualToString:@"playItem"]) {
    
    FirstViewController *fvc = [[FirstViewController alloc] init];
    [self.window.rootViewController showViewController:fvc sender:nil];
    
}
if ([shortcutItem.type isEqualToString:@"shareItem"]) {
    SecondViewController *svc = [[SecondViewController alloc] init];
    [self.window.rootViewController showViewController:svc sender:nil];
}
}

---

2.Peek and Pop

经过授权的应用的试图控制器可以响应用户不同的按压力量，随着按压力量的增加，会有三个交互阶段：
1.暗示预览功能可用，会有一个虚化的效果。
2.Peek：展示预览的视图以及快捷选项菜单（peek quick action）。
3.Pop：跳转到预览的视图控制器。

首先是检测设备是否支持3D Touch,可以放在viewWillAppear中：
- (void)viewWillAppear:(BOOL)animated{

[super viewWillAppear:animated];
if(self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable){
    
    self.isOpen3DTouch = YES;
}
}

为了防止用户在程序运行过程中修改3D Touch设置，还要添加另一处检测：
- (void)traitCollectionDidChange:(UITraitCollection *)previousTraitCollection{

if(self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable){
    
    self.isOpen3DTouch = YES;
 
}
}

如果设备支持3D Touch,下一步是对需要响应Peek&Pop手势的视图进行注册,我的demo里模拟的是对tableViewCell添加手势,注册放在了table:cellForRowAtIndexPath函数里：
[self registerForPreviewingWithDelegate:self sourceView:cell];

然后视图控制器接受代理<UIViewControllerPreviewingDelegate>

Peek代理方法：返回需要预览的视图控制器
- (UIViewController *)previewingContext:(id<UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location{

//通过预览上下文获取到当前按压的视图,判断indexPath值
NSIndexPath *indexPath = [self.tableView indexPathForCell:(UITableViewCell *)previewingContext.sourceView];

//通过上下文可以调整不被虚化的范围
previewingContext.sourceRect = CGRectMake(10, 10, 10, 10);

if (indexPath.row == 0) {
    FirstViewController *FVC = [[FirstViewController alloc]init];
    //可以调整预览视图的大小
    FVC.preferredContentSize = CGSizeMake([UIScreen mainScreen].bounds.size.width, 200);
    return FVC;
}
if (indexPath.row == 1) {
    SecondViewController *SVC = [[SecondViewController alloc] init];
    return SVC;
}
if (indexPath.row == 2) {
    ThirdViewController *tvc = [[ThirdViewController alloc] init];
    return tvc;
}
return nil;
}

也可以根据location的位置来判断按压的是哪个控件,进而做出响应。

Pop代理方法：相当于push操作
- (void)previewingContext:(id<UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit{

[self showViewController:viewControllerToCommit sender:self];
}

在弹出预览视图而没有触发Pop操作的时候，向上滑动预览视图,在视图下方可以展示一些选项去操作，可以通过在预览视图控制器中添加previewActionItems来实现，需要实现以下方法,然后再Block中去实现操作就可以了：
- (NSArray<id<UIPreviewActionItem>> *)previewActionItems
{

// 生成UIPreviewAction
UIPreviewAction *action1 = [UIPreviewAction actionWithTitle:@"Action 1" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
    NSLog(@"Action 1 selected");
}];

UIPreviewAction *action2 = [UIPreviewAction actionWithTitle:@"Action 2" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
    NSLog(@"Action 2 selected");
}];

UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"Action 3" style:UIPreviewActionStyleSelected handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
    NSLog(@"Action 3 selected");
}];

NSArray *actions = @[action1, action2, action3];

return actions;
}

效果如下图所示：

previewActionItems.png

也可以把这些item放到一个组中，再把不同的group放到一个数组中就可以了。大家可以根据自己的需求去实现：

UIPreviewActionGroup *group1 = [UIPreviewActionGroup actionGroupWithTitle:@"Action Group" style:UIPreviewActionStyleDefault actions:actions];

这样3D Touch简单的使用就基本上实现了，如果以上有什么理解错误的地方，欢迎大家交流讨论。