一、简介

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界面环境特点,而且蕴藏了3D2018正版葡京赌侠诗
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:点击下载

发表评论

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

网站地图xml地图