iOS 3D Touch超详细入门(附带demo示例代码)

一、简介

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 35x35 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替换元素的方法。应用场景:iPhone在短信列表页面,通过快捷功能菜单快速回短信。

至此,3D Touch就介绍完毕了。由于技术有限,加之时间匆忙,难免会存在纰漏,欢迎指正。转载请注明出处,万分感谢。

demon:点击下载

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,829评论 1 331
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,603评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,846评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,600评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,780评论 3 272
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,695评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,136评论 2 293
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,862评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,453评论 0 229
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,942评论 2 233
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,347评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,790评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,293评论 3 221
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,839评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,448评论 0 181
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,564评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,623评论 2 249

推荐阅读更多精彩内容

  • 前言 关于这篇文章 由于iPhone 6S发布不到一年的时间,很多新特性、新技术还未普遍,不管是3D Touch的...
    Tangentw阅读 4,363评论 8 18
  • 1.简单的介绍一下3D Touch 3D Touch的触控技术,被苹果称为新一代多点触控技术。其实,就是此前在Ap...
    Camille_chen阅读 11,964评论 19 33
  • 前言 关于3D touch苹果官方文档是这么开始介绍的: 大意如下:iOS9开始,所有新的手机都增加了一个三维的用...
    VV木公子阅读 2,141评论 3 39
  • 3D Touch介绍 从iPhone 6s开始,产品都添加了一项硬件属性,叫做3D touch。作为屏幕的一部分,...
    歪笔书生_阅读 575评论 0 0
  • 专著:http://www.jianshu.com/p/3443a3b27b2d 1.简单的介绍一下3D Touc...
    violafa阅读 948评论 1 0