简介
3D Touch是一种立体触控技术，被苹果称为新一代多点触控技术，是在Apple Watch上采用的Force Touch，屏幕可感应不同的感压力度触控。3D Touch，苹果iPhone 6s的新功能。有Peek和Pop两种新手势。3D-Touch技术，相对于多点触摸在平面二维空间的操作，3D-Touch技术增加了对力度和手指面积的感知，可以通过长按快速预览/查看你想要的短信/图片/超链接等内容，Peek和Pop手势的响应时间可迅捷到10ms和15ms。
注意事项
3D Touch 只在 iOS 9 及以上版本得到支持，之前版本的 iOS 并不支持该功能； 3D Touch 只在 iPhone 6s 及以后型号的 iPhone 或 iPad Pro 上可用，更早的设备并不支持该功能。 具体可通过如下代码进行判断：
- (void)check3dtouch{
if(self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable){
NSLog(@"支持 3D Touch");
}else{
NSLog(@"不支持 3D Touch");
}
}
添加方式
给应用图标添加 3D Touch 的菜单一共有2种方式: 静态添加 和 动态添加
静态添加
菜单字段 UIApplicationShortcutItems 数组, 可以设置多个 item.
每个item可以包含以下字段:
- UIApplicationShortcutItemType
设置标签 icon 类型，当用户调用相应的 Quick Action 的时候，会将该字符串传递给你 App,标签的唯一标识（必填） - UIApplicationShortcutItemTitle
标题（必填） - UIApplicationShortcutItemSubtitle
副标题（可选） - UIApplicationShortcutItemIconType
如果使用系统图标的话使用这个（可选） - UIApplicationShortcutItemIconFile
自定义图标图片名称，指定 App Bundle 中的文件图片或者是在 Asset Catalog 里面的文件名。自定义的 icon 必须是 35 * 35 的 正方形 单色 的图片。如果你指定了这个值，系统便会忽略掉对 UIApplicationShortcutItemIconType 的设置，因为这两个值是冲突的，而且开发者自己指定的图片优先级比系统图标更高。（可选） - UIApplicationShortcutItemUserInfo
该值用来提供 App 的版本信息,字典信息，如传值使用（可选）
点击工程中的 info.plist 文件，添加代码
<key>UIApplicationShortcutItems</key>
<array>
<dict>
// 系统图标类型
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeShare</string>
// 标题 key
<key>UIApplicationShortcutItemTitle</key>
<string>分享</string>
// 标识符 (用于判断哪个 item 被点击)
<key>UIApplicationShortcutItemType</key>
<string>share</string>
</dict>
<dict>
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeAdd</string>
<key>UIApplicationShortcutItemTitle</key>
<string>添加</string>
<key>UIApplicationShortcutItemType</key>
<string>add</string>
</dict>
</array>
详情.png
注意：实际的按钮显示时和 info.plist 中定义的顺序是反的。
动态添加
- 通过 UIApplicationShortcutIcon 创建图标.
- 通过 UIApplicationShortcutItem 来创建菜单 item 对象.
- 把 item 数组赋值给 [UIApplication sharedApplication].shortcutItems
/**
添加 items
*/
- (void)addShortcutItems {
// 添加系统自带图标
// share
UIApplicationShortcutIcon *shareIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeShare];
UIApplicationShortcutItem *shareItem = [[UIApplicationShortcutItem alloc] initWithType:@"Share" localizedTitle:@"Share" localizedSubtitle:nil icon:shareIcon userInfo:nil];
// add
UIApplicationShortcutIcon *addIcon = [UIApplicationShortcutIcon iconWithType:UIApplicationShortcutIconTypeAdd];
UIApplicationShortcutItem *addItem = [[UIApplicationShortcutItem alloc] initWithType:@"Add" localizedTitle:@"Add" localizedSubtitle:nil icon:addIcon userInfo:nil];
// 自定义图标
UIApplicationShortcutIcon *icon1 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"pic1"];
UIApplicationShortcutIcon *icon2 = [UIApplicationShortcutIcon iconWithTemplateImageName:@"pic2"];
// 创建带着有自定义图标item
UIMutableApplicationShortcutItem *item1 = [[UIMutableApplicationShortcutItem alloc] initWithType:@"pic1" localizedTitle:@"进入pic1" localizedSubtitle:@"自定义图标pic1" icon:icon1 userInfo:nil];
UIMutableApplicationShortcutItem *item2 = [[UIMutableApplicationShortcutItem alloc] initWithType:@"pic2" localizedTitle:@"进入pic2" localizedSubtitle:@"自定义图标pic2" icon:icon2 userInfo:nil];
[UIApplication sharedApplication].shortcutItems = @[shareItem, addItem,item1,item2];
}
UIMutableApplicationShortcutItem初始化方法介绍如下:
- (instancetype)initWithType:(NSString *)type
localizedTitle:(NSString *)localizedTitle
localizedSubtitle:(nullable NSString *)localizedSubtitle
icon:(nullable UIApplicationShortcutIcon *)icon
userInfo:(nullable NSDictionary *)userInfo
- type ：item的唯一标识
- localizedTitle ：是item的标题
- localizedSubtitle ：item的副标题
- icon ：item icon设置的图片
- userInfo ：item所包含的信信息，类型是字典
然后在 application: didFinishLaunchingWithOptions: 中调用 addShortcutItems 方法.
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//首先判断是否支持3DTouch
[self addShortcutItems];
return YES;
}
系统提供的图标种类:
typedef NS_ENUM(NSInteger, UIApplicationShortcutIconType) {
UIApplicationShortcutIconTypeCompose,
UIApplicationShortcutIconTypePlay,
UIApplicationShortcutIconTypePause,
UIApplicationShortcutIconTypeAdd,
UIApplicationShortcutIconTypeLocation,
UIApplicationShortcutIconTypeSearch,
UIApplicationShortcutIconTypeShare,
UIApplicationShortcutIconTypeProhibit NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeContact NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeHome NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMarkLocation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeFavorite NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeLove NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCloud NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeInvitation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeConfirmation NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMail NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeMessage NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeDate NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTime NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCapturePhoto NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeCaptureVideo NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTask NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeTaskCompleted NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeAlarm NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeBookmark NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeShuffle NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeAudio NS_ENUM_AVAILABLE_IOS(9_1),
UIApplicationShortcutIconTypeUpdate NS_ENUM_AVAILABLE_IOS(9_1)
} NS_ENUM_AVAILABLE_IOS(9_0) __TVOS_PROHIBITED;
对应图标.jpeg
添加功能代码
判断 item 被点击只需要判断给 item 设置的 item.type 并做相应操作即可.
- (void)application:(UIApplication *)application performActionForShortcutItem:(nonnull UIApplicationShortcutItem *)shortcutItem completionHandler:(nonnull void (^)(BOOL))completionHandler {
// 根据 shortcutItem.type 判断点击的是哪个 item
if ([shortcutItem.type isEqualToString:@"Add"]) {
...
}
}
说明
- 静态添加 和 动态添加 可以同时使用, 但是系统会先加载 静态 items, 然后再加载 动态 items.
- 开发者自定义的最多只能添加 4 个 item, 最新的 iOS 10 系统会给所有的 App 额外添加一个 3D Touch 分享按钮，点击后不打开 App 而是调用系统分享该应用的 App Store 下载地址.
