3D Touch学习日记

废话不多说,直接上干货!

应用外的3D Touch效果

  • UIApplicationShortcutItems:快捷项对象,即3D Touch的一个相应按钮。
  • UIApplicationShortcutItemType:快捷项的类型,字符串类型,可以用来区分具体操作。
  • UIApplicationShortcutItemTitle :快捷项的主标题,类似于UITableViewCell的title属性。
  • UIApplicationShortcutItemSubtitle:快捷项的子标题,如果设置了会和主标题一同展示,类似于UITableView的subTitle属性。
  • UIApplicationShortcutItemIconType:系统默认提供的快捷项图标。
  • UIApplicationShortcutItemIconFile:使用自己的图标,将图片路径传入即可。注意图片尺寸是35*35。
  • UIApplicationShortcutItemUserInfo:字典类型,包含应用程序的版本信息、程序启动或者更新注意事项。

应用外的3D Touch效果有plist文件代码两种实现方式,下面逐一介绍两种实现方式的具体做法。

  • plist文件:

3D Touch学习日记_第1张图片
plist
效果图1
  • 代码:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    //使用自己的图片,无子标题
    UIApplicationShortcutIcon *firstItemIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@"Chat"];
    UIMutableApplicationShortcutItem *firstItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"myFirst" localizedTitle:@"添加" localizedSubtitle:nil icon:firstItemIcon userInfo:nil];
    
    //使用系统提供的图片
    UIApplicationShortcutIcon *secondItemIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
    UIMutableApplicationShortcutItem *secondItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"mySecond" localizedTitle:@"分享" localizedSubtitle:@"fenxiang" icon:secondItemIcon userInfo:nil];
    
    application.shortcutItems = @[firstItem,secondItem];
    return YES;
}
效果图2

上面分别陈述了两种应用外3D Touch效果的实现方式,下面介绍几点实现过程中的注意事项:

  • 两种方式是可以结合使用的,plist属于静态配置,代码是属于动态配置。我们再实现时,可以将确定不变的快捷项在plist文件中配置,将不确定的的AppDelegate中用代码实现。
  • 虽然两种方式是可以结合使用的,但是最多只允许添加4个快捷项,先添加plist中配置的。也就是说,plist中配置了4个快捷项,那么代码添加的快捷项是无效的。
  • 配置的快捷项是放在数组中的,快捷项展示也是按照数组顺序由下自上展示的。

响应事件

添加快捷项,在AppDelegate.m文件中实现响应事件,我们可以通过以下的几种方式区分点击的快捷项:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    UIApplicationShortcutIcon *firstItemIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@"Chat"];
    UIMutableApplicationShortcutItem *firstItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"myFirst" localizedTitle:@"添加" localizedSubtitle:@"tianjia" icon:firstItemIcon userInfo:nil];
    
    UIApplicationShortcutIcon *secondItemIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
    UIMutableApplicationShortcutItem *secondItem = [[UIMutableApplicationShortcutItem alloc]initWithType:@"mySecond" localizedTitle:@"分享" localizedSubtitle:@"fenxiang" icon:secondItemIcon userInfo:nil];
    
    application.shortcutItems = @[firstItem,secondItem];
    return YES;
}
  • 按照类型判断操作
-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
   
    if ([shortcutItem.type isEqualToString:@"myFirst"]) {
        NSLog(@"执行添加事件");
    }else if ([shortcutItem.type isEqualToString:@"mySecond"]) {
        NSLog(@"执行分享的操作");
    }
}
  • 按照标题判断操作
-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
   
   if ([shortcutItem.localizedTitle isEqualToString:@"添加"]) {
        NSLog(@"执行添加事件");
    }else if ([shortcutItem.localizedTitle isEqualToString:@"分享"]) {
        NSLog(@"执行分享的操作");
    }
}
  • 按照子标题判断操作
-(void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {
   
   if ([shortcutItem.localizedSubtitle isEqualToString:@"tianjia"]) {
        NSLog(@"执行添加事件");
    }else if ([shortcutItem.localizedSubtitle isEqualToString:@"fenxiang"]) {
        NSLog(@"执行分享的操作");
    }
}

应用内3D Touch效果

应用内3D Touch分为peek检测、peek和pop三个阶段,每个阶段的按压力度也是逐渐增大的,首先需要遵守UIViewControllerPreviewingDelegate协议,下面对三个阶段分别进行代码实现:

实例代码是我自己封装的一个图片选择器。

  • peek检测
- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath {
    PhotoCollectionCell *cell = [collectionView dequeueReusableCellWithReuseIdentifier:@"PhotoCollectionCell" forIndexPath:indexPath];
    
    // 在资源的集合中获取第一个集合,并获取其中的图片
    PHAsset *asset = self.album[indexPath.item];
    cell.photoImageView.image = [self.photoAPI getImageWithAsset:asset targetSize:_targetSize synchronous:YES completionHandler:nil];
    cell.asset = asset;
    
    if (self.selectedArr.count > 0) {
        cell.selectBtn.selected = [_selectedArr containsObject:cell.asset] ? YES : NO;
    }else {
        cell.selectBtn.selected = NO;
    }
    
    //检测3D Touch的可用性,如果可用,将self设置为代理,按压cell响应3D Touch效果。
    if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) {
        [self registerForPreviewingWithDelegate:self sourceView:cell];
    }
    
    return cell;
}
  • peek
#pragma mark - UIViewControllerPreviewingDelegate
- (UIViewController *)previewingContext:(id)previewingContext viewControllerForLocation:(CGPoint)location {
    //坐标转换,将手指按在屏幕上的坐标转换成为collectionView的坐标。
    CGPoint cellLocation = [self.photoCollectionView convertPoint:location fromView:[previewingContext sourceView]];
    
    //根据触摸点获取按压的cell
    NSIndexPath *cellIndex = [self.photoCollectionView indexPathForItemAtPoint:cellLocation];
    PhotoCollectionCell *cell = (PhotoCollectionCell *)[self.photoCollectionView cellForItemAtIndexPath:cellIndex];
    
    //返回一个VC,被peek的控制器
    MXBrowserPhotoController *browser = [[MXBrowserPhotoController alloc] initWithSelectedAssets:@[cell.asset] pageControl:NO];
    return browser;
}
peek

peek预览阶段可以上滑显示更多操作,操作项添加方法在返回的MXBrowserPhotoController.m文件中实现。

- (NSArray> *)previewActionItems {
    UIPreviewAction *like = [UIPreviewAction actionWithTitle:@"喜欢" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
        NSLog(@"点击了喜欢");
    }];
    
    UIPreviewAction *selec = [UIPreviewAction actionWithTitle:@"选中" style:UIPreviewActionStyleSelected handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
        NSLog(@"点击选中");
    }];
    
    UIPreviewAction *cancle = [UIPreviewAction actionWithTitle:@"取消" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
        NSLog(@"点击取消");
    }];
    return @[like, selec, cancle];
}
peek 操作
  • pop
#pragma mark - UIViewControllerPreviewingDelegate
- (void)previewingContext:(id)previewingContext commitViewController:(UIViewController *)viewControllerToCommit {
    //pop阶段展示的VC
    [self presentViewController:viewControllerToCommit animated:YES completion:nil];
}
pop

你可能感兴趣的:(3D Touch学习日记)