概述

iOS10系統登錄中國,在系統中對3D Touch的使用需求更頻繁,所以對iOS9中便引入的3D Touch功能做一些了解是很有必要的

在日常開發中,我們經常需要使用3D Touch中的兩個功能

1. 在主屏幕上對應用圖標使用3DTouch操作

2. 在應用程序內對某一控件使用3DTouch操作

ShortcutItem

概述

ShortcutItem功能允許用戶在主屏幕上對應用圖標使用3DTouch操作,如果本次操作有效,則會給出幾個快捷可選項允許用戶進行操作

靜態添加

在info.plist中添加UIApplicationShortcutItems關鍵字,以如下方式配置即可

其中各個關鍵字釋義如下:

UIApplicationShortcutItemType: 快捷可選項的特定字符串(必填)
UIApplicationShortcutItemTitle: 快捷可選項的標題(必填)
UIApplicationShortcutItemSubtitle: 快捷可選項的子標題(可選)
UIApplicationShortcutItemIconType: 快捷可選項的圖標(可選)
UIApplicationShortcutItemIconFile: 快捷可選項的自定義圖標(可選)
UIApplicationShortcutItemUserInfo: 快捷可選項的附加信息(可選)

動態添加

UIApplicationShortcutItem

每一個快捷可選項是一個UIApplicationShortcutItem對象,其指定初始化器(NS_DESIGNATED_INITIALIZER)如下

- (instancetype)initWithType:(NSString *)type localizedTitle:(NSString *)localizedTitle localizedSubtitle:(nullable NSString *)localizedSubtitle icon:(nullable UIApplicationShortcutIcon *)icon userInfo:(nullable NSDictionary *)userInfo;

其中各個參數釋義如下:

type: 快捷可選項的特定字符串(必填)
localizedTitle: 快捷可選項的標題(必填)
localizedSubtitle: 快捷可選項的子標題(可選)
icon: 快捷可選項的圖標(可選)
userInfo: 快捷可選項的附加信息(可選)

UIApplicationShortcutIcon

每一個快捷可選項圖標為一個UIApplicationShortcutIcon對象,我們可以使用系統提供的多個圖標,也可以自定義我們自己的圖標

// 使用系統提供的圖標
+ (instancetype)iconWithType:(UIApplicationShortcutIconType)type;

// 自定義圖標
+ (instancetype)iconWithTemplateImageName:(NSString *)templateImageName;

系統提供的圖標樣式如下:

注: 自定義圖標需要使用镂空圖標,同時建議1倍圖標大小為35*35

示例

// 以"動態添加四個快捷可選項"為例
UIApplicationShortcutIcon *searchShortcutIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeSearch];
UIApplicationShortcutItem *searchShortcutItem = [[UIApplicationShortcutItem alloc] initWithType:@"com.liupeng.search" localizedTitle:@"Search" localizedSubtitle:@"Search Subtitle" icon:searchShortcutIcon userInfo:nil];

UIApplicationShortcutIcon *playShortcutIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypePlay];
UIApplicationShortcutItem *playShortcutItem = [[UIApplicationShortcutItem alloc] initWithType:@"com.liupeng.play" localizedTitle:@"Play" localizedSubtitle:@"Play Subtitle" icon:playShortcutIcon userInfo:nil];

UIApplicationShortcutIcon *qrShortcutIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@"shortcut_QR"];
UIApplicationShortcutItem *qrShortcutItem = [[UIApplicationShortcutItem alloc] initWithType:@"com.liupeng.qr" localizedTitle:@"QR" localizedSubtitle:@"QR Subtitle" icon:qrShortcutIcon userInfo:nil];

UIApplicationShortcutIcon *payShortcutIcon = [UIApplicationShortcutIcon iconWithTemplateImageName:@"shortcut_pay"];
UIApplicationShortcutItem *payShortcutItem = [[UIApplicationShortcutItem alloc] initWithType:@"com.liupeng.pay" localizedTitle:@"Pay" localizedSubtitle:@"Pay Subtitle" icon:payShortcutIcon userInfo:nil];

[UIApplication sharedApplication].shortcutItems = @[searchShortcutItem, playShortcutItem, qrShortcutItem, payShortcutItem];

觸發回調

當用戶通過點擊快捷可選項進入應用程序會回調如下方法,我們可以在這裡通過快捷可選項的type來加以區分,以便進行不同的操作

- (void)application:(UIApplication *)application performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler
{
   if ([shortcutItem.type isEqualToString:@"com.liupeng.search"])
   {
       // do something ...
   }
   else if ([shortcutItem.type isEqualToString:@"com.liupeng.play"])
   {
       // do something ...
   }
   // ...
}

注意

在動態添加快捷可選項前,需要用判斷是否支持3D Touch功能,以免在不支持的設備上運行程序導致閃退

if ([self respondsToSelector:@selector(traitCollection)])
{
   if ([self.traitCollection respondsToSelector:@selector(forceTouchCapability)])
   {
       if (self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable)
       {
           // 支持3D Touch
       }
       else
       {
           // 不支持3D Touch
       }
   }
}

注: 在支持3D Touch的設備上,用戶可以在程序運行期間通過設置 -> 通用 -> 輔助功能 -> 3D Touch來關閉3D Touch功能,所以我們有必要通過重寫-traitCollectionDidChange:方法隨時處理

Peek & Pop

概述

Peek和Pop是應用內的一種全新交互模式,當用戶不斷增加力量在控件上按壓,會依次進入四個階段

• 輕按控件,除觸發Peek的控件外,其他區域全部虛化

• 繼續用力Peek被觸發,展示Pop界面快照

• 向上滑動展示快捷選項

• 繼續用力跳轉進入Pop界面

使用

以"從ViewController中的UILabel控件通過Peek & Pop進入DetailViewController"為例,對Peek & Pop的使用進行一下講解

• 需要實現Peek & Pop交互的控件所在的控制器遵守UIViewControllerPreviewingDelegate協議

@interface ViewController () 
@end

• 在控制器內為需要實現Peek & Pop交互的控件注冊Peek & Pop功能

[self registerForPreviewingWithDelegate:self sourceView:label];

• 當進入Peek狀態時,系統會回調如下方法

- (nullable UIViewController *)previewingContext:(id )previewingContext viewControllerForLocation:(CGPoint)location
{
   // previewingContext.sourceView: 觸發Peek & Pop操作的視圖
   // previewingContext.sourceRect: 設置觸發操作的視圖的不被虛化的區域

   DetailViewController *detailVC = [[DetailViewController alloc] init];

   // 預覽區域大小(可不設置)
   detailVC.preferredContentSize = CGSizeMake(0, 300);

   return detailVC;
}

• 當進入Pop狀態時,系統會回調如下方法

- (void)previewingContext:(id )previewingContext commitViewController:(UIViewController *)viewControllerToCommit
{
   [self.navigationController pushViewController:viewControllerToCommit animated:YES];
}

• 在Peek時希望提供一些快捷選項,需要在DetailViewController中重寫previewActionItems的getter方法

- (NSArray> *)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) {

   }];

   UIPreviewAction *action3 = [UIPreviewAction actionWithTitle:@"選項三" style:UIPreviewActionStyleDestructive handler:^(UIPreviewAction * _Nonnull action, UIViewController * _Nonnull previewViewController) {

   }];

   UIPreviewActionGroup *actionGroup = [UIPreviewActionGroup actionGroupWithTitle:@"選項組" style:UIPreviewActionStyleDefault actions:@[action1, action2]];

   return @[action1, action2, action3, actionGroup];
}