iOS - 3DTouch 3D 触摸
1、3DTouch 简介
- 3DTouch 是 iOS9 + 系统下，在 iPhone6s（iPhone6s Plus）+ 手机上才能够使用的功能。
1.1 3DTouch 基本类型
-
1、主屏幕快速选项（Home Screen Quick Action）
-
通过主屏幕的应用图标，通过 3D 手势呼出一个菜单，在主屏幕上的应用 Icon 处，直接进入应用的相应功能模块。
-
-
2、Peek（展示预览）和 Pop（跳页至预览的界面）
是对 App 的一个优化，用户可以通过 3DTouch 手势在 view 上来预览一些预加载信息，这样的设计可以使 App 更加简洁大方，交互性也更强。
-
在使用 3DTouch 时，ViewController 中会有如下三个交互阶段：
- 1) 提示用户这里有 3DTouch 的交互，会使交互控件周围模糊。
- 2) 继续深按，会出现预览视图。
-
3) 通过视图上的交互控件进行进一步交互。
-
3、Force Properties（力度）
- iOS9 + 为我们提供了一个新的交互参数：力度。我们可以检测某一交互的力度值，来做相应的交互处理。例如，我们可以通过力度来控制快进的快慢，音量增加的快慢等。
2、Xcode 模拟器实现测试
插件 SBShortcutMenuSimulator：GitHub
-
打开电脑终端，执行以下命令：
$ git clone https://github.com/DeskConnect/SBShortcutMenuSimulator.git $ cd SBShortcutMenuSimulator $ make -
如果电脑中有多个 Xcode 版本，先做如下操作，如果只有一个 Xcode，则可以跳过。Xcode2.app 是你电脑中 Xcode 的名字，这里如要特别注意，如果名字中有空格，需要修改一下，把空格去掉，否则会影响命令的执行。
$ sudo xcode-select -switch /Applications/Xcode2.app/Contents/Developer/ -
之后在 SBShortcutMenuSimulator 的目录中执行如下操作：
$ xcrun simctl spawn booted launchctl debug system/com.apple.SpringBoard --environment DYLD_INSERT_LIBRARIES=$PWD/SBShortcutMenuSimulator.dylib $ xcrun simctl spawn booted launchctl stop com.apple.SpringBoard -
如果没有报错，我们可以通过向指定端口发送消息的方法来在模拟器上模拟3D Touch的效果：
$ echo 'com.apple.mobilecal' | nc 127.0.0.1 8000-
其中 com.apple.mobilecal 是应用的 Bundle ID ，如果要测试我们的应用，将其改为我们应用的 BundleID 即可。上面的示例应用是系统日历，可以看到模拟器的效果如下：
-
3、主屏幕快速选项创建
- 快捷标签最多可以创建 4 个，包括静态的和动态的。每个标签的题目和 icon 最多两行，多出的会用...省略。
3.1 静态标签添加
-
打开我们项目的 Info.plist 文件，添加如下项（选择框中并没有，需要我们手工敲上去）。
UIApplicationShortcutItems UIApplicationShortcutItemTitle 第一个按钮 UIApplicationShortcutItemType com.mycompany.myapp.one UIApplicationShortcutItemTitle 搜索 UIApplicationShortcutItemType com.mycompany.myapp.search UIApplicationShortcutItemIconType UIApplicationShortcutIconTypeSearch UIApplicationShortcutItemSubtitle 我是副标题 UIApplicationShortcutItemUserInfo key1 value1 
-
参数说明
UIApplicationShortcutItems // 数组中的元素就是我们的那些快捷选项标签。 UIApplicationShortcutItemTitle // 标签标题（必填） UIApplicationShortcutItemType // 标签的唯一标识（必填） UIApplicationShortcutItemIconType // 使用系统图标的类型，如搜索、定位、home等（可选） UIApplicationShortcutItemIconFile // 使用项目中的图片作为标签图标（可选） UIApplicationShortcutItemSubtitle // 标签副标题（可选） UIApplicationShortcutItemUserInfo // 字典信息，如传值使用（可选） // 系统风格 icon 的枚举 UIApplicationShortcutIconTypeCompose // 编辑的图标 UIApplicationShortcutIconTypePlay // 播放图标 UIApplicationShortcutIconTypePause // 暂停图标 UIApplicationShortcutIconTypeAdd // 添加图标 UIApplicationShortcutIconTypeLocation // 定位图标 UIApplicationShortcutIconTypeSearch // 搜索图标 UIApplicationShortcutIconTypeShare // 分享图标
3.2 动态标签添加
-
在 AppDelegate.m 文件中加如下代码
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 加载主界面 UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil]; ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"]; UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView]; self.window.rootViewController = mainNav; [self.window makeKeyAndVisible]; // 创建应用图标上的 3D touch 快捷选项，会和 Info.plist 中静态添加的一起创建 [self creatShortcutItem]; // 如果是从快捷选项标签启动 app，则根据不同标识执行不同操作，然后返回 NO，止处理逻辑被反复回调。 UIApplicationShortcutItem *shortcutItem = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey]; if (shortcutItem) { // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作 if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]) { // 进入第一个按钮界面，执行操作 NSArray *arr = @[@"hello 3D Touch"]; UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil]; [self.window.rootViewController presentViewController:vc animated:YES completion:^{ }]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) { // 进入搜索界面，执行操作 SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"]; [mainNav pushViewController:childVC animated:NO]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) { // 进入分享界面，执行操作 SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"]; [mainNav pushViewController:childVC animated:NO]; } return NO; } return YES; } // 创建应用图标上的 3DTouch 快捷选项 - (void)creatShortcutItem { // 创建系统风格的 icon UIApplicationShortcutIcon *icon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare]; // // 创建自定义图标的 icon // UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"分享.png"]; // 创建快捷选项 UIApplicationShortcutItem *item = [[UIApplicationShortcutItem alloc] initWithType:@"com.mycompany.myapp.share" localizedTitle:@"分享" localizedSubtitle:@"分享副标题" icon:icon userInfo:nil]; // 添加到快捷选项数组 [UIApplication sharedApplication].shortcutItems = @[item]; } -
相关方法属性说明
@interface UIApplicationShortcutItem : NSObject> *userInfo; // 这个类继承于 UIApplicationShortcutItem，创建的标签可变 @interface UIMutableApplicationShortcutItem : UIApplicationShortcutItem @property (nonatomic, copy) NSString *type; @property (nonatomic, copy) NSString *localizedTitle; @property (nullable, nonatomic, copy) NSString *localizedSubtitle; @property (nullable, nonatomic, copy) UIApplicationShortcutIcon *icon; @property (nullable, nonatomic, copy) NSDictionary> *userInfo; // 这个类创建标签中的 icon @interface UIApplicationShortcutIcon : NSObject// 创建系统风格的 icon + (instancetype)iconWithType:(UIApplicationShortcutIconType)type; // 创建自定义的图片 icon + (instancetype)iconWithTemplateImageName:(NSString *)templateImageName; -
静态标签 + 动态标签 效果
3.3 响应标签的行为
如果 App 在后台，通过快捷选项标签进入 App，则调用方法
- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler。如果 App 不在后台已杀死，则处理通过快捷选项标签进入 App 的逻辑在
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中。在 launchOptions 中有 UIApplicationLaunchOptionsShortcutItemKey 这样一个键，通过它，我们可以区别是否是从标签进入的 App，如果是则处理结束逻辑后，返回 NO，防止处理逻辑被反复回调。-
在 AppDelegate.m 文件中加如下代码
-
App 在后台响应
- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler { // 加载主界面 UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil]; ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"]; UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView]; self.window.rootViewController = mainNav; [self.window makeKeyAndVisible]; // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作 if([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]){ // 进入第一个按钮界面，执行操作 NSArray *arr = @[@"hello 3D Touch"]; UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil]; [self.window.rootViewController presentViewController:vc animated:YES completion:^{ }]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) { // 进入搜索界面，执行操作 SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"]; [mainNav pushViewController:childVC animated:NO]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) { // 进入分享界面，执行操作 SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"]; [mainNav pushViewController:childVC animated:NO]; } if (completionHandler) { completionHandler(YES); } } -
App 不在后台响应
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 加载主界面 UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil]; ViewController *mainView = [storyboard instantiateViewControllerWithIdentifier:@"mainController"]; UINavigationController *mainNav = [[UINavigationController alloc] initWithRootViewController:mainView]; self.window.rootViewController = mainNav; [self.window makeKeyAndVisible]; // 如果是从快捷选项标签启动 app，则根据不同标识执行不同操作，然后返回 NO，止处理逻辑被反复回调。 UIApplicationShortcutItem *shortcutItem = [launchOptions valueForKey:UIApplicationLaunchOptionsShortcutItemKey]; // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作 if (shortcutItem) { // 判断先前我们设置的快捷选项标签唯一标识，根据不同标识执行不同操作 if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.one"]) { // 进入第一个按钮界面，执行操作 NSArray *arr = @[@"hello 3D Touch"]; UIActivityViewController *vc = [[UIActivityViewController alloc]initWithActivityItems:arr applicationActivities:nil]; [self.window.rootViewController presentViewController:vc animated:YES completion:^{ }]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.search"]) { // 进入搜索界面，执行操作 SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"]; [mainNav pushViewController:childVC animated:NO]; } else if ([shortcutItem.type isEqualToString:@"com.mycompany.myapp.share"]) { // 进入分享界面，执行操作 SharedViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"sharedController"]; [mainNav pushViewController:childVC animated:NO]; } return NO; } return YES; }
-
3.4 动态修改快捷标签内容
-
修改UIApplicationShortcutItem
// 获取第 0 个 shortcutItem UIApplicationShortcutItem *shortcutItem0 = [[UIApplication sharedApplication].shortcutItems objectAtIndex:0]; // 将 shortcutItem0 的类型由 UIApplicationShortcutItem 改为可修改类型 UIMutableApplicationShortcutItem UIMutableApplicationShortcutItem * newShortcutItem0 = [shortcutItem0 mutableCopy]; // 修改 shortcutItem 的标题 [newShortcutItem0 setLocalizedTitle:@"按钮1"]; // 将 shortcutItems 数组改为可变数组 NSMutableArray *newShortcutItems = [[UIApplication sharedApplication].shortcutItems mutableCopy]; // 替换原 ShortcutItem [newShortcutItems replaceObjectAtIndex:0 withObject:newShortcutItem0]; [UIApplication sharedApplication].shortcutItems = newShortcutItems;
4、Peek 和 Pop 创建
-
1、首先给 view 注册 3DTouch 的 Peek（展示预览）和 Pop（跳页至预览的界面）功能，这里给 cell 注册 3DTouch 的 peek 和 pop 功能。
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"myCell"]; if (cell == nil) { cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"myCell"]; } cell.textLabel.text = _myArray[indexPath.row]; // 判断 3D Touch 是否可用 if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable) { NSLog(@"3D Touch 可用!"); // 给 cell 注册 3DTouch 的 peek 和 pop 功能 [self registerForPreviewingWithDelegate:self sourceView:cell]; } else { NSLog(@"3D Touch 无效"); } return cell; } -
2、遵守协议 UIViewControllerPreviewingDelegate 并实现其方法
// peek（预览） - (nullable UIViewController *)previewingContext:(id)previewingContext viewControllerForLocation:(CGPoint)location { // 获取按压的 cell 所在行，[previewingContext sourceView] 就是按压的那个视图 NSIndexPath *indexPath = [_myTableView indexPathForCell:(UITableViewCell* )[previewingContext sourceView]]; // 设定预览的界面 UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil]; SearchViewController *childVC = [storyboard instantiateViewControllerWithIdentifier:@"searchController"]; childVC.preferredContentSize = CGSizeMake(0.0f, 500.0f); childVC.str = [NSString stringWithFormat:@"我是%@, 用力按一下进来", _myArray[indexPath.row]]; // 调整不被虚化的范围，按压的那个 cell 不被虚化（轻轻按压时周边会被虚化，再少用力展示预览，再加力跳页至设定界面） CGRect rect = CGRectMake(0, 0, self.view.frame.size.width, 40); previewingContext.sourceRect = rect; // 返回预览界面 return childVC; } // pop（按用点力进入） - (void)previewingContext:(id )previewingContext commitViewController:(UIViewController *)viewControllerToCommit { [self showViewController:viewControllerToCommit sender:self]; } -
效果图：（当用户按下时 cell 周边会虚化，增加压力达到一定值会弹出设定的预览界面，继续增加力按压会跳页至预览界面）
-
-
3、打开预览的视图的 .m 文件，这里是 SearchViewController.m 中加上如下代码
- (NSArray-
效果图：（当弹出预览时，上滑预览视图，出现预览视图中快捷选项）
-
5、3DTouch 压力值的运用
-
直接在 SearchViewController.m 加这个方法即可，按压 SearchViewController 中的任何视图都会调用这个方法。
// 按住移动 or 压力值改变时的回调 - (void)touchesMoved:(NSSet*)touches withEvent:(UIEvent *)event { NSArray *arrayTouch = [touches allObjects]; UITouch *touch = (UITouch *)[arrayTouch lastObject]; // 通过 tag 确定按压的是哪个 view，注意：如果按压的是 label，将 label 的 userInteractionEnabled 属性设置为 YES if (touch.view.tag == 105) { NSLog(@"move压力 ＝ %f", touch.force); // 红色背景的 label 显示压力值 _lbForce.text = [NSString stringWithFormat:@"压力%f", touch.force]; // 红色背景的 label 上移的高度＝压力值*100 _bottom.constant = ((UITouch *)[arrayTouch lastObject]).force * 100; } } -
用不同力度按压那个蓝色背景的 label，随着力度的变化红色背景的 label 会上下移动。
