一、简介
3D Touch是指:通过对屏幕施加不同程度的压力来访问附加功能。应用可以通过显示菜单、展示其他内容和播放动画等形式来表现3D Touch,该功能从6s及其以上机型开始得到支持。
3D Touch的主要提现方式有三种:
- 主屏交互 (Home Screen Interaction)
- 预览和跳转 (Peek and Pop)
- LivePhoto
二、提纲
1.主屏交互 (Home Screen Interaction)
- 静态添加快捷操作
- 动态添加快捷操作
2.预览和跳转 (Peek and Pop)
- Peek
1.注册3D Touch
2.通过代理实现功能 - Pop
1.通过代理实现功能
三、实现
1.主屏操作
3D Touch在主屏交互的表现形式:当用户点击APP的同时并施加一定压力的时候,程序会在适当的位置展示出一个菜单选项列表。操作效果如下图所示
其中添加快捷操作有两种
- 通过 "静态" 的方式添加快捷操作
- 通过 "动态" 的方式添加快捷操作
其中 "静态" 快捷操作主要是在项目的info.plist
文件中添加相关的属性,这个网上资料很多,我就不介绍了。我们重点介绍动态快捷操作
1.1. 动态快捷操作
通过动态的方式添加快捷操作:这种方式主要通过代码的形式把UIApplicationShortcutItem
对象数组传给UIApplication
单例对象。我们可以在APP启动方法
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
里面添加我们的代码
PS: 我是为AppDelegate
添加了一个叫PressTouch
的分类,把所有关于3DTouch的代码全部写在了这个分类里,APPdelegate只需要调用.h中暴露的方法就行,算是简化了APPDelegate
中的代码吧~~
附:参数对象说明
UIApplicationShortcutItem
可以看作是3D Touch点击后,弹出菜单每行对应的模型,一行对应一个UIApplicationShortcutItem对象。
实例化方法:
- (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle localizedSubtitle:(nullable NSString *)localizedSubtitle icon:(nullable UIApplicationShortcutIcon *)icon userInfo:(nullable NSDictionary *)userInfo NS_DESIGNATED_INITIALIZER;
type : 对应UIApplicationShortcutItem
对象的唯一标识符。
localizedTitle : 对应UIApplicationShortcutItem
对象的主标题
localizedSubtitle : 对应UIApplicationShortcutItem
对象的副标题
icon : 对应要显示的图标,有两种图标:
- 系统自带的类型,代码如下:
+ (instancetype)iconWithType:(UIApplicationShortcutIconType)type;
2.用户自定义的图片,代码如下
+ (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;
要注意的是,如果通过第二种自定义方式创建图标,必须使用指定格式的图片,不然显示出来的是一片黑色。开发文档规定格式如下:
The provided image named will be loaded from the app's bundle and will be masked to conform to the system-defined icon style.
userInfo : 主要是用来提供APP的版本信息
至此主屏幕icon上的快捷标签创建就介绍完了,而他们点击进入页面的实现就有点类似消息通知的实现方式了,只要增加两处代码就好:首次启动APP和APP没被杀死从后台启动
1.2. APP没有启动的情况下点击3DTouch快速启动
其中这个调用方法上图已经给出来了,
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
就是在这个方法中调用的
其中ABGlobaiAPP
是自定义的全局的视图控制转换器,负责处理root根视图的切换
处理难点 : 这个需要判断 "跳转" 的界面处于
tabBar
的第几个HomeController
比如我四个一级界面分别叫做
HomeViewController
、MemberHomeViewController
、MessageHomeViewController
、MineHomeViewController
四个一级界面。
因为APP默认启动时都是展示HomeViewController
,如果选择的是HomeViewController
的子ViewController,则此时的NavigationController
刚好是以HomeViewController
为根视图的,可以直接用self.navigation跳转,但是如果点击的是MineHomeViewController
的子ViewController,则跳转之前需要先切换tabBar的selectedViewController,找到以MineHomeViewController
为根视图的nav,然后再执行跳转
ps:因为这只是在程序未启动的时候才走这个方法,所以并不存在无限压栈的情况,所以这种解决起来也比较简单。
1.3. APP没被杀死,还存在于后台,点击3D Touch对应的跳转
如果程序没有被杀死,只是存活在后台,点击3D Touch会执行这个方法
点击3D Touch时因为还存在于后台,并不会走
didFinishLaunchingWithOptions
这个方法的,所以我采用的是通知
,以通知的形式告诉APP我点击了3D Touch,需要执行对应的跳转操作
这里发送完通知后,需要手动调用completionHandler,告诉系统你已经执行完此次操作。
这里我选择的是在HomeViewController也就是首页接受3D Touch的通知
- (void)pressTouchAction:(NSNotification *)notifi {
if ([UserAccountModel userLogin]) { // 如果已经登录,跳转到对应的VC
// 将要push的VC的name
NSString *destinationVCName = [notifi.userInfo objectForKey:@"VCName"];
if ([destinationVCName isEqualToString:@"MCSettingViewController"]) { // 点击的是个人中心的设置
// 先将之前的其他tabBar的跳转到首页(如果不这样做,有可能上一次执行这个方法时,首页已经跳转到二级界面,那个你点击下面的tabBar时,他跳转的是二级界面,而不是首页)
BaseNavigationController *homeNav = [self.tabBarController.viewControllers firstObject];
[homeNav popToRootViewControllerAnimated:NO]; // 静默跳转,否则肉眼可见跳转动画
[self.tabBarController setSelectedIndex:3]; //先跳转tabBar
// 取出以MCMineHomeViewController为根视图的nav,以后就用这个nav去实现跳转
BaseNavigationController *nav = [self.tabBarController.viewControllers lastObject];
// 当前navigationVC下的topviewController的name
NSString *currentVCName = NSStringFromClass([nav.topViewController class]);
if ([currentVCName isEqualToString:@"MCMineHomeViewController"]) {
// 当前的navigationVC下的topViewController是rootVC, 可以直接push,不存在无限入栈的情况
BaseViewController *destinationVC = [NSClassFromString(destinationVCName) new];
[nav pushViewController:destinationVC animated:YES];
}else { // 如果当前的navigationVC下的topViewController不是rootVC,pop到rootVC
[nav popToRootViewControllerAnimated:NO];
BaseViewController *destinationVC = [NSClassFromString(destinationVCName) new];
[nav pushViewController:destinationVC animated:YES];
}
}else { //点击的是首页中的几个选项
// 先将之前的其他tabBar的跳转到首页
BaseNavigationController *mineNav = [self.tabBarController.viewControllers lastObject];
[mineNav popToRootViewControllerAnimated:NO];
[self.tabBarController setSelectedIndex:0];
// 取出以HomeViewController为根视图的nav,以后就用这个nav去实现跳转
BaseNavigationController *nav = [self.tabBarController.viewControllers firstObject];
// 当前navigationVC下的topviewController的name
NSString *currentVCName = NSStringFromClass([nav.topViewController class]);
if ([currentVCName isEqualToString:NSStringFromClass([HomeViewController class])]) {
// 当前的navigationVC下的topViewController是rootVC, 可以直接push,不存在无限入栈的情况
if ([destinationVCName isEqualToString:@"QRCodeViewController"]) {
QRCodeViewController *qrCodeVC = [[QRCodeViewController alloc] init];
qrCodeVC.qrcodeType = MemberDetaill;
[nav pushViewController:qrCodeVC animated:YES];
}else {
BaseViewController *destinationVC = [NSClassFromString(destinationVCName) new];
[nav pushViewController:destinationVC animated:YES];
}
}else { // 如果当前的navigationVC下的topViewController不是rootVC,pop到rootVC
[nav popToRootViewControllerAnimated:NO];
if ([destinationVCName isEqualToString:@"QRCodeViewController"]) { //如果是QRCodeViewController
QRCodeViewController *qrCodeVC = [[QRCodeViewController alloc] init];
qrCodeVC.qrcodeType = MemberDetaill;
[nav pushViewController:qrCodeVC animated:YES];
}else {
BaseViewController *destinationVC = [NSClassFromString(destinationVCName) new];
[nav pushViewController:destinationVC animated:YES];
}
}
}
}else {
// 如果没有登录,跳转到登录界面
[[ABGlobaiAPP sharedInstance] gotoSiginViewController];
}
}
处理难点
- 跳转时需要考虑其他界面是否处于一级界面,如果没有则需要将其他界面先跳转到一级界面。
- 需要考虑到当前界面 是否是rootVC,然后处理无限入栈的问题。
2.Peek and Pop
Peek and Pop主要是通过3D Touch,使用户可以在当前视图预览页面、链接或者文件。如果当前页面控制器注册了3D Touch,我们只需要点击相应的内容并施加一点压力,就能使当前内容高亮,并且其他内容进入一个模糊虚化的状态;当我们再施加一点压力,就能预览当前内容对应的页面;如果需要进入到该内容对应的页面,我们只需要稍微再施加一点压力直至预览视图放大到全屏,就可以跳转到其对应的页面。另外,如果我们在预览页面的同时,往上拖拽就可以显示出一个类似UIActionsheet界面的快捷操作菜单,效果如下面几张图片:
2.1. 实现VC1商品评论列表
快速预览VC2商品评论详情
的功能(peek)
2.1.1. 要使用3D Touch,先向要响应3D Touch功能的视图控制器注册3D Touch,并指定接收手势的源视图。
毫无疑问,要响应的视图是TableView中的Cell。我们在Cell的初始化方法中加入以下代码
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
ProductCommentTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"ProductCommentTableViewCell" forIndexPath:indexPath];
cell.model = [self.dataSource objectAtIndex:indexPath.row];
// 注册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。
UITraitEnvironment是UIViewController所遵守的其中一个协议,不仅包含了UI界面环境特征,而且包含了3D Touch的特征描述。
2.1.2 VC1 中实现UIViewControllerPreviewingDelegate代理,监听3D Touch手势的触发
示例代码如下:
#pragma mark - UIViewControllerPreviewingDelegate
// 3D Touch时预览的界面
- (nullable UIViewController *)previewingContext:(id <UIViewControllerPreviewing>)previewingContext viewControllerForLocation:(CGPoint)location {
// 找到点击的是哪个Cell
NSIndexPath *indexPath = [self.tableView indexPathForCell:(ProductCommentTableViewCell *)[previewingContext sourceView]];
// 创建要预览的控制器
GoodCommentDetailViewController *commentDetailVC = [[GoodCommentDetailViewController alloc] init];
commentDetailVC.model = [self.dataSource objectAtIndex:indexPath.row];
// 指定当前上下文视图rect
CGRect rect = CGRectMake(0, 0, kScreenWidth, 300);
previewingContext.sourceRect = rect;
return commentDetailVC;
}
2.2. 实现从VC1跳转到VC2的功能(Pop)
// 深度按压之后跳转的界面
- (void)previewingContext:(id<UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit {
[self showViewController:viewControllerToCommit sender:self];
}
2.3. 快捷功能菜单的生成
如果我们需要在VC1快速预览视图出现时,向上拖拽得到一个快捷功能菜单,需要在VC2中实现以下代理方法:
// 预览界面时需要实现的功能
- (NSArray<id<UIPreviewActionItem>> *)previewActionItems {
UIPreviewAction *action1 = [UIPreviewAction actionWithTitle:@"选项一" style:UIPreviewActionStyleDefault handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
}];
UIPreviewAction *action2 = [UIPreviewAction actionWithTitle:@"使用自己名字替换用户名字" style:UIPreviewActionStyleSelected handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
kWeakSelf;
weakSelf.model.userName = @"涛昇依旧";
[weakSelf.dataSource replaceObjectAtIndex:weakSelf.indexPath withObject:weakSelf.model];
[ZYNotification postNotificationName:@"changeCommentUserName" object:nil];
}];
UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"选项三" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
}];
return @[action1, action2, action3];
}
当然了,既然发送通知,我们就需要在商品评论列表界面
接收通知,刷新界面
[ZYNotification addObserver:self selector:@selector(reloadTableViewDataIfChangedData) name:@"changeCommentUserName" object:nil];
- (void)reloadTableViewDataIfChangedData {
[self.tableView reloadData];
}
实现了这个代理,我们就可以在VC1中快速预览往上拖拽得到一个快捷功能菜单。而且,我们不需要进入VC2,直接通过点击快捷菜单的【替换该元素】这个选项,就能调用VC2替换元素的方法。应用场景:iPhone在短信列表页面,通过快捷功能菜单快速回短信。
本文参考
- iOS 3D Touch超详细入门 作者:DamonMok