一、简介

3D
Touch是指:通过对显示屏施加分裂档次的压力来访问附加功效。应用可以透过彰显菜单、浮现其余情节和播放动画等形式来展现3D
Touch,该效率从6s及其以上机型开端得到帮衬。

3D Touch的紧要突显形式有三种:

  1. 主屏交互(Home Screen Interaction)
  2. 预览和跳转(Peek and Pop)
  3. LivePhoto

明日关键介绍前二种,第两种关系到相册资源,有时间会将其当作一个单独的专题开展教学。文末会附着GitHub地址。

二、提纲

1. 主屏交互(Home Screen Interaction)

  • 静态添加神速操作(Static quick actions)
  • 动态增加火速操作(Dynamic quick actions)

2. 预览和跳转(Peek and Pop)

  • Peek
    ①注册3D Touch
    ②因而代理落成效益
  • pop
    ①经过代理完毕效益

三、实现

1.主屏操作

3D
Touch在主屏交互的表现格局:当用户点击APP的同时并施加一定压力的时候,程序会在适用的职分体现出一个食谱选项列表。操作功能如下图所示:

HomeScreen.gif

1.1.静态急忙操作

①经过静态的措施丰富急忙操作:那种办法重点是在品种的Info.plist文件中添加相关的特性。
首先种在Info.plist文件添加方法:

第一种InfoPlist添加方法.png

第二种在Info.plist文件添加方法:
1.右键Info.plist –>Open As ->Source Code;

第两种InfoPlist添加方法.png

2.在文件中添加以下代码:

<key>UIApplicationShortcutItems</key>
    <array>
        <dict>
            <key>UIApplicationShortcutItemIconType</key>
            <string>UIApplicationShortcutIconTypeShare</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>分享“DM3DTouch”</string>
            <key>UIApplicationShortcutItemType</key>
            <string>cn.damon.DM3DTouchDemo.openShare</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>key2</key>
                <string>value2</string>
            </dict>
        </dict>
        <dict>
            <key>UIApplicationShortcutItemIconFile</key>
            <string>favorite</string>
            <key>UIApplicationShortcutItemTitle</key>
            <string>收藏</string>
            <key>UIApplicationShortcutItemType</key>
            <string>cn.damon.DM3DTouchDemo.openfavorites</string>
            <key>UIApplicationShortcutItemUserInfo</key>
            <dict>
                <key>key1</key>
                <string>value1</string>
            </dict>
        </dict>
    </array>

1.2.动态快速操作

①透过动态的办法丰硕飞速操作:那种艺术主要透过代码的款式把shortcutItems对象数组传递给UIApplication单例对象。我们可以在APP启动方法:

-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

或者在windows.rootViewController的viewDidLoad方法里面添加我们的代码。
代码示例如下:

    NSMutableArray *arrShortcutItem = (NSMutableArray *)[UIApplication sharedApplication].shortcutItems;

    UIApplicationShortcutItem *shoreItem1 = [[UIApplicationShortcutItem alloc] initWithType:@"cn.damon.DM3DTouchDemo.openSearch" localizedTitle:@"搜索" localizedSubtitle:nil icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeSearch] userInfo:nil];
    [arrShortcutItem addObject:shoreItem1];

    UIApplicationShortcutItem *shoreItem2 = [[UIApplicationShortcutItem alloc] initWithType:@"cn.damon.DM3DTouchDemo.openCompose" localizedTitle:@"新消息" localizedSubtitle:@"" icon:[UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeCompose] userInfo:nil];
    [arrShortcutItem addObject:shoreItem2];

    [UIApplication sharedApplication].shortcutItems = arrShortcutItem;

附:参数对象表明

UIApplicationShortcutItem:能够视作是3D
Touch点击后,弹出菜单每行对应的模子,一行对应一个UIApplicationShortcutItem对象。

实例化方法

- (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle localizedSubtitle:(nullable NSString *)localizedSubtitle icon:(nullable UIApplicationShortcutIcon *)icon userInfo:(nullable NSDictionary *)userInfo:

type:对应UIApplicationShortcutItem对象的绝无仅有标识符。
localizedTitle:对应UIApplicationShortcutItem对象的主标题。
localizedSubtitle:对应UIApplicationShortcutItem对象的副标题。
icon:对应要突显的图标,有三种图标:
①系统定义的门类,代码如下:

+ (instancetype)iconWithType:(UIApplicationShortcutIconType)type;

②用户自定义的品种,代码如下:

+ (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;

要专注的是,要是经过第三种自定义情势成立图标,必须使用指定格式的图形,不然显示出来的是一片藏蓝色。开发文档规定格式如下:

Icons should be square, single color, and 35×35 points

图片必须是正方形、单色并且尺寸是35*35像素的图片。(点击下载模板)
userInfo:首若是用来提供APP的版本信息。

万一同时选取静态和动态的措施添加,其丰裕的先后顺序是:先添加静态ShortcutItem对象,要是静态ShortcutItem对象不足4个,则持续添加动态ShortcutItem对象。官方文档提及到最四只能够添加4个ShortcutItem对象,不过一些APP却能添加5个,有艺术添加5个的迎接留言研讨。

1.3.点击菜单选项进入APP的监听

当添加完ShortcutItem对象,大家的下一步职责就是监听用户点击哪一个选项进入到程序。大家只须求在APPDelegate中落实代理方法,如下:

- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {

    //不管APP在后台还是进程被杀死,只要通过主屏快捷操作进来的,都会调用这个方法
    NSLog(@"name:%@\ntype:%@", shortcutItem.localizedTitle, shortcutItem.type);    
}

大家能够通过shortcutItem对象获得到唯一标识符,只须求看清标识符就足以拍卖大家的逻辑任务了。

2.Peek and Pop

Peek and Pop紧若是经过3D
Touch,使用户可以在此时此刻视图预览页面、链接或者文件。即便当前页面控制器注册了3D
Touch,大家只需求点击相应的内容并施加一点压力,就能使近来内容高亮,并且其他内容进入一个歪曲虚化的图景;当我们再施加一点压力,就能预览当前内容对应的页面;借使急需进入到该内容对应的页面,大家只要求有些再施加一点压力直至预览视图放大到全屏,就可以跳转到其相应的页面。其余,假如大家在预览页面的还要,往上拖拽就可以来得出一个像样UIActionsheet界面的火速操作菜单。以上所述效果如下:

PeekAndPod.gif

大家通过demo来对Peek and
Pop进行实例分析,以下是该demo大致逻辑、作用表明:

logic.png

1.导航控制器的根控制器是VC1,通过点击VC1中tableView第X行,跳转到VC2。其中,VC2中有一个办法是把数据源的第X个要素替换成字符串【replace
item】;
2.透过利用3D Touch,在VC1中落到实村长足预览的成效;
3.施用3D Touch,在VC1中跳转进入到VC2;
4.通过疾速菜单中的【替换该因素】选项,替换数据源中的第X个因素

2.1.已毕VC1飞速预览VC2的意义(Peek)

①要使用3D Touch,先向要响应3D Touch作用的视图控制器注册3D
Touch,并点名接收手势的源视图。毫无疑问,要响应的视图是TableView中的Cell。大家在Cell的初步化方法中参加以下代码:

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:reusedId];

    if (!cell) {

        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:reusedId];
    }

    cell.contentView.backgroundColor = [UIColor grayColor];

    NSString *str = [NSString stringWithFormat:@"row [%@]", self.arrData[indexPath.row]];

    cell.textLabel.text = str;

    //注册3D Touch
    /**
     从iOS9开始,我们可以通过这个类来判断运行程序对应的设备是否支持3D Touch功能。
     UIForceTouchCapabilityUnknown = 0,     //未知
     UIForceTouchCapabilityUnavailable = 1, //不可用
     UIForceTouchCapabilityAvailable = 2    //可用
     */
    if ([self respondsToSelector:@selector(traitCollection)]) {

        if ([self.traitCollection respondsToSelector:@selector(forceTouchCapability)]) {

            if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {

                [self registerForPreviewingWithDelegate:(id)self sourceView:cell];
            }
        }
    }

    return cell;
}

因为唯有在6s及其以上的设施才支撑3D
Touch,大家可以透过UITraitCollection那些类的UITraitEnvironment协议属性来判定设备是不是帮忙3D
Touch。
UITraitCollection是UIViewController所听从的里边一个商议,不仅包涵了UI界面环境特点,而且包括了3D
Touch的特征描述。

②在VC1中贯彻UIViewControllerPreviewingDelegate代理,监听3D
Touch手势的触发,示例代码如下:

- (nullable UIViewController *)previewingContext:(id <UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location NS_AVAILABLE_IOS(9_0) {

    NSIndexPath *indexPath = [self.tableView indexPathForCell:(UITableViewCell *)[previewingContext sourceView]];
    NSString *str = [NSString stringWithFormat:@"%@",self.arrData[indexPath.row]];

    //创建要预览的控制器
    DMPresentationViewController *presentationVC = [[DMPresentationViewController alloc] init];
    presentationVC.arrData = (NSMutableArray *)self.arrData;
    presentationVC.index = indexPath.row;
    presentationVC.strInfo = str;

    //指定当前上下文视图Rect
    CGRect rect = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, 300);
    previewingContext.sourceRect = rect;

    return presentationVC;
}

2.2.实现从VC1跳转到VC2的功能(Pop)

要从VC1的迅猛预览视图跳转进去到VC2,咱们需求在VC1中贯彻以下代理方法:

- (void)previewingContext:(id <UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit NS_AVAILABLE_IOS(9_0) {

    [self showViewController:viewControllerToCommit sender:self];
}

2.3.快捷效能菜单的转变

比方大家要求在VC1飞跃预览视图出现时,向上拖拽获得一个很快作用菜单,须求在VC2中落实以下代理方法:

- (NSArray<id<UIPreviewActionItem>> *)previewActionItems {

    NSMutableArray *arrItem = [NSMutableArray array];

    UIPreviewAction *previewAction0 = [UIPreviewAction actionWithTitle:@"取消" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {

        NSLog(@"didClickCancel");
    }];

    UIPreviewAction *previewAction1 = [UIPreviewAction actionWithTitle:@"替换该元素" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {

        //把下标为index的元素替换成preview
        [self replaceItem];

    }];

    [arrItem addObjectsFromArray:@[previewAction0 ,previewAction1]];

    return arrItem;
}

贯彻了那一个代理,大家就可以在VC1中神速预览往上拖拽得到一个便捷功用菜单。而且,我们不须要进入VC2,直接通过点击连忙菜单的【替换该因素】那些选项,就能调用VC2替换元素的不二法门。应用场景:索爱在短信列表页面,通过火速成效菜单快捷回短信。

至今,3D
Touch就介绍落成了。由于技术有限,加之时间匆忙,难免会存在纰漏,欢迎指正。转发请注脚出处,分外感谢。

demon:点击下载

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图