3D Touch 开发

一. 3D Touch开发 官方文档给出的应用介绍主要有两块:

 - 用户现在可以按主屏幕图标立即访问应用程序提供的功能。
 - 在您的应用程序中，用户现在可以按照视图来查看其他内容的预览，并加快对功能的访问。

简单来说 3d touch 就是通过区分轻按和重按来进行不同的用户交互

• 第一部分的应用是我们可以通过3D手势，在主屏幕上的应用图标处，直接进入应用的响应功能模块。这个功能就，会在图标旁边出现一个菜单，点击菜单我们可以进入相应的功能单元。

• 第二部分是对应用的一个优化，用户可以通过3D Touch手势在视图上来预览一些预加载信息，这样的设计可以使应用程序更加简洁大方，交互性也更强。

二. 3DTouch开发支持

- 系统支持：3d Touch 是iOS9的新特性
- 手机支持:  6s以上的版本支持
- 开发支持: xcode 7 以上才支持3d touch开发

三. 主要应用模块

1、Home Screen Quick Actions
通过重压主屏幕的应用icon 呼出快捷菜单， 可以快速定位功能

2.peek and pop 可以进行页面预览

IMG_0758副本.png IMG_0757.PNG

在腾讯QQ中 通过重压消息中的cell 就会出现预览 如上图

3. force properties
   iOS 9 为我们提供了一个交互的力度值，这是iOS出现的新的交互参数

四.实现

• Home Screen Quick Actions

  • 静态：通过添加info.plist

    
    • UIApplicationShortcutItems：数组中的元素就是我们的那些快捷选项标签。
    • UIApplicationShortcutItemTitle：标签标题（必填）
    • UIApplicationShortcutItemType：标签的唯一标识（必填）
    • UIApplicationShortcutItemIconType：使用系统图标的类型，如搜索、定位、home等（可选）
    • UIApplicationShortcutItemIconFile：使用项目中的图片作为标签图标（可选）
    • UIApplicationShortcutItemSubtitle：标签副标题（可选）
    • UIApplicationShortcutItemUserInfo：字典信息，如传值使用（可选）

  • 动态：通过代码添加
    在AppDelegate.m文件中加如下代码：

//创建应用图标上的3D touch快捷选项
    [self creatShortcutItem];
    
    UIApplicationShortcutItem *shortcutItem = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey];
    //如果是从快捷选项标签启动app，则根据不同标识执行不同操作，然后返回NO，防止调用- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler
    if (shortcutItem) {
        //判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
        if([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]){
            NSArray *arr = @[@"hello 3D Touch"];
            UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil];
            [self.window.rootViewController presentViewController:vc animated:YES completion:^{
            }];
        } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) {//进入搜索界面
            SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
            [mainNav pushViewController:childVC animated:NO];
        } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) {//进入分享界面
            SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"];
            [mainNav pushViewController:childVC animated:NO];
        }
        return NO;
    }

//创建应用图标上的3D touch快捷选项
- (void)creatShortcutItem {
    //创建系统风格的icon
    UIApplicationShortcutIcon *icon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
    
//    //创建自定义图标的icon
//    UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"分享.png"];
    
    //创建快捷选项
    UIApplicationShortcutItem * item = [[UIApplicationShortcutItem alloc]initWithType:@"com.mycompany.myapp.share" localizedTitle:@"分享" localizedSubtitle:@"分享副标题" icon:icon userInfo:nil];
    
    //添加到快捷选项数组
    [UIApplication sharedApplication].shortcutItems = @[item];
}

• 通过3dTouch唤醒APP
  1 点击快捷标签响应

//如果app在后台，通过快捷选项标签进入app，则调用该方法，如果app不在后台已杀死，则处理通过快捷选项标签进入app的逻辑在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中
- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
    
    UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
    ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"];
    UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView];
    self.window.rootViewController = mainNav;
    [self.window makeKeyAndVisible];
    
    //判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作
    if([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]){
        NSArray *arr = @[@"hello 3D Touch"];
        UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil];
        [self.window.rootViewController presentViewController:vc animated:YES completion:^{
        }];
    } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) {//进入搜索界面
        SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
        [mainNav pushViewController:childVC animated:NO];
    } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) {//进入分享界面
        SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"];
        [mainNav pushViewController:childVC animated:NO];
    }
    
    if (completionHandler) {
        completionHandler(YES);
    }
}

2 修改UIApplicationShortcutItem

//获取第0个shortcutItem
    UIApplicationShortcutItem *shortcutItem0 = [[UIApplication sharedApplication].shortcutItems objectAtIndex:0];
    //将shortcutItem0的类型由UIApplicationShortcutItem改为可修改类型UIMutableApplicationShortcutItem
    UIMutableApplicationShortcutItem * newShortcutItem0 = [shortcutItem0 mutableCopy];
    //修改shortcutItem的标题
    [newShortcutItem0 setLocalizedTitle:@"按钮1"];
    //将shortcutItems数组改为可变数组
    NSMutableArray *newShortcutItems = [[UIApplication sharedApplication].shortcutItems mutableCopy];
    //替换原ShortcutItem
    [newShortcutItems replaceObjectAtIndex:0 withObject:newShortcutItem0];
    [UIApplication sharedApplication].shortcutItems = newShortcutItems;

• peek（展示预览）和pop（跳页至预览的界面）
  1.首先给view注册3DTouch的peek（预览）和pop功能，我这里给cell注册3DTouch的peek（预览）和pop功能

-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"myCell"];
    if (cell == nil) {
        cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"myCell"];
    }
    cell.textLabel.text = _myArray[indexPath.row];
    if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {
        NSLog(@"3D Touch  可用!");
        //给cell注册3DTouch的peek（预览）和pop功能
        [self registerForPreviewingWithDelegate:self sourceView:cell];
    } else {
        NSLog(@"3D Touch 无效");
    }
    return cell;
}

2.需要继承协议UIViewControllerPreviewingDelegate

3.实现UIViewControllerPreviewingDelegate方法

//peek(预览)
- (nullable UIViewController *)previewingContext:(id <UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location
{
    //获取按压的cell所在行，[previewingContext sourceView]就是按压的那个视图
    NSIndexPath *indexPath = [_myTableView indexPathForCell:(UITableViewCell* )[previewingContext sourceView]];
    
    //设定预览的界面
    UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
    SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"];
    childVC.preferredContentSize = CGSizeMake(0.0f,500.0f);
    childVC.str = [NSString stringWithFormat:@"我是%@,用力按一下进来",_myArray[indexPath.row]];
    
    //调整不被虚化的范围，按压的那个cell不被虚化（轻轻按压时周边会被虚化，再少用力展示预览，再加力跳页至设定界面）
    CGRect rect = CGRectMake(0, 0, self.view.frame.size.width,40);
    previewingContext.sourceRect = rect;
    
    //返回预览界面
    return childVC;
}

//pop（按用点力进入）
- (void)previewingContext:(id <UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit {
     [self showViewController:viewControllerToCommit sender:self];
 }