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 的交互，会使交互控件周围模糊。
    • 1. 继续深按，会出现预览视图。
    • 1. 通过视图上的交互控件进行进一步交互。

      

• 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 文件，添加如下项（选择框中并没有，需要我们手工敲上去）。

  	<key>UIApplicationShortcutItems</key>
  	<array>
  		<dict>
  			<key>UIApplicationShortcutItemTitle</key>
  			<string>第一个按钮</string>
  			<key>UIApplicationShortcutItemType</key>
  			<string>com.mycompany.myapp.one</string>
  		</dict>
  		<dict>
  			<key>UIApplicationShortcutItemTitle</key>
  			<string>搜索</string>
  			<key>UIApplicationShortcutItemType</key>
  			<string>com.mycompany.myapp.search</string>
  			<key>UIApplicationShortcutItemIconType</key>
  			<string>UIApplicationShortcutIconTypeSearch</string>
  			<key>UIApplicationShortcutItemSubtitle</key>
  			<string>我是副标题</string>
  			<key>UIApplicationShortcutItemUserInfo</key>
  			<dict>
  				<key>key1</key>
  			<string>value1</string>
  		</dict>
  		</dict>
  	</array>
  

  

• 参数说明

  	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 <NSCopying, NSMutableCopying>
  	// 下面是两个初始化方法 通过设置 type，title 等属性来创建一个标签，这里的 icon 是 UIApplicationShortcutIcon 对象，我们后面再说
  	- (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle
  	                                           localizedSubtitle:(nullable NSString *)localizedSubtitle
  	                                                        icon:(nullable UIApplicationShortcutIcon *)icon
  	                                                    userInfo:(nullable NSDictionary *)userInfo NS_DESIGNATED_INITIALIZER;
  	- (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle;
  	// 下面这是一些只读的属性，获取相应的属性值
  	@property (nonatomic, copy, readonly) NSString *type;
  	@property (nonatomic, copy, readonly) NSString *localizedTitle;
  	@property (nullable, nonatomic, copy, readonly) NSString *localizedSubtitle;
  	@property (nullable, nonatomic, copy, readonly) UIApplicationShortcutIcon *icon;
  	@property (nullable, nonatomic, copy, readonly) NSDictionary<NSString *, id <NSSecureCoding>> *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<NSString *, id <NSSecureCoding>> *userInfo;
  

  	// 这个类创建标签中的 icon
  	@interface UIApplicationShortcutIcon : NSObject <NSCopying>
  	// 创建系统风格的 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 <UIViewControllerPreviewing>)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 <UIViewControllerPreviewing>)previewingContext commitViewController:(UIViewController *)viewControllerToCommit {
   		[self showViewController:viewControllerToCommit sender:self];
  	}
  

  • 效果图：（当用户按下时 cell 周边会虚化，增加压力达到一定值会弹出设定的预览界面，继续增加力按压会跳页至预览界面）

    

• 3、打开预览的视图的 .m 文件，这里是 SearchViewController.m 中加上如下代码

  	- (NSArray<id<UIPreviewActionItem>> *)previewActionItems {
  		// setup a list of preview actions
   		UIPreviewAction *action1 = [UIPreviewAction actionWithTitle:@"Aciton1"
   		                                                      style:UIPreviewActionStyleDefault
   		                                                    handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
      		NSLog(@"Aciton1");
  		}];
  		UIPreviewAction *action2 = [UIPreviewAction actionWithTitle:@"Aciton2"
   		                                                      style:UIPreviewActionStyleDefault
   		                                                    handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
      		NSLog(@"Aciton2");
  		}];
  		UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"Aciton3"
   		                                                      style:UIPreviewActionStyleDefault
   		                                                    handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {
      		NSLog(@"Aciton3");
  		}];
  		NSArray *actions = @[action1,action2,action3];
  		// and return them (return the array of actions instead to see all items ungrouped)
  		return actions;
  	}
  

  • 效果图：（当弹出预览时，上滑预览视图，出现预览视图中快捷选项）

    

5、3DTouch 压力值的运用

• 直接在 SearchViewController.m 加这个方法即可，按压 SearchViewController 中的任何视图都会调用这个方法。

  	// 按住移动 or 压力值改变时的回调
  	- (void)touchesMoved:(NSSet<UITouch *> *)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 会上下移动。