3D Touch大法

Demo同步更新到Swift2.3

3D Touch最先应用在Apple Watch上面,但叫Force Touch,后在iPhone6s上加入了此特性,并改名3D Touch。值得注意的是目前3D Touch只支持iPhone6S以后的机型,包括现有Xcode7中6s的模拟器也不支持,不过Github上的SBShortcutMenuSimulator项目通过Hack方式已经实现了Quick Actions快捷访问,但不能使用Peek&Pop快速预览。

如果你还不知道3D Touch是什么,可以看看官方宣传视频

环境

系统环境: iOS9 or later

开发环境: Swift2.3 & Xcode7.3.1

Demo: 3DTouchDemo

效果:

开始

3D Touch可以分为三种:

  • Quick Actions【可以理解PC桌面的快捷方式】
  • Peek&Pop【应用内快速预览内容】
  • UITouch【自定义3D Touch事件】

Quick Actions 快捷方式

配置Actions可以通过工程Info.plist文件静态配置,也可以在运行时动态添加,两者可以一起使用。

静态配置在Info.plistUIApplicationShortcutItems节点数组下添加相应Actions Item信息

1
2
3
4
5
6
7
8
9
10
11
12
<key>UIApplicationShortcutItems</key>
<array>
<dict>
<key>UIApplicationShortcutItemIconType</key>
<string>UIApplicationShortcutIconTypeSearch</string>
<key>UIApplicationShortcutItemTitle</key>
<string>搜索</string>
<key>UIApplicationShortcutItemType</key>
<string>me.mokai.TouchDemo.action.search</string>
</dict>
...
</array>

动态配置通过UIApplication的shortcutItems添加,shortcutItems是一个UIApplicationShortcutItem数组

1
2
3
4
5
let type = "me.mokai.TouchDemo.action.identify"
let title = "听歌识别"
let shortcutItem = UIApplicationShortcutItem(type: type, localizedTitle: title,
localizedSubtitle: nil, icon: UIApplicationShortcutIcon(templateImageName: "quick_filter"), userInfo: nil)
application.shortcutItems = [shortcutItem]

Note

  • Actions的图标可以使用系统预定的也可以自定义图片
  • 对于每个Actions来说type是必须的,它代表着我们从桌面点击Actions进入到应用调用application(application, performActionForShortcutItem:, completionHandler:)时的唯一标识,另外userInfo可以附加每个actions的数据,如最近听歌的歌曲id
  • 当APP启动时,shortcutItems的值是上次动态添加的,如果是第一次启动则为空数组。
  • Actions最多显示4个,优先显示静态Actions,然后剩余个数显示shortcutItems的前几个。

Peek&POP 快速预览

好了,下面介绍本文重头戏,先上效果

Peek窗口的内容其实是目标VC【ps即将要显示的ViewController】的一个实时快照,但它不可以点击。Peek触发阶段有三种:

  • 长按【显示一个焦点视图,触发Peek的源视图高亮,其它视图都处于模糊状态】
  • 轻压【显示Peek窗口,此时如果Peek窗口支持Quick Actions,往上滑会显示Quick Actions菜单,此时的Peek窗口是不可以点击的】
  • 重压 【进入到真正的ViewController】

Peek由一个可响应事件的View触发,默认是关闭的,我们需要通过控制器的registerForPreviewingWithDelegate: sourceView:方法注册,第一个参数为UIViewControllerPreviewingDelegate的代理,Peek触发轻压时会调用其previewingContext:viewControllerForLocation方法,重压时会调用previewingContext:commitViewController:方法。第二个参数为触发Peek事件的源视图

1
2
//注册
registerForPreviewingWithDelegate(self, sourceView: userVCBtn)
1
2
3
4
5
6
7
8
9
10
//Delegate
//轻压,进入第二阶段,显示Peek窗口
func previewingContext(previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
let userVc = self.storyboard?.instantiateViewControllerWithIdentifier("UserViewController") as! UserViewController
return userVc;
}
//重压,进入第三阶段,显示真正的ViewController
func previewingContext(previewingContext: UIViewControllerPreviewing, commitViewController viewControllerToCommit: UIViewController) {
showViewController(viewControllerToCommit, sender: self)
}

如果Peek窗口需要Quick Actions菜单,在目标VC中重写previewActionItems方法返回一个UIPreviewActionItem或者一个UIPreviewActionGroup数组就行了。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
//目标VC
lazy var previewActions: [UIPreviewActionItem] = {
func previewActionForTitle(title: String, style: UIPreviewActionStyle = .Default) -> UIPreviewAction {
return UIPreviewAction(title: title, style: style) { previewAction, viewController in
print("点击了\(title)") //这里是Actions响应
}
}
let action1 = previewActionForTitle("关注TA",style: .Destructive) //显示红色,代表重要Action
let action2 = previewActionForTitle("私信TA")
//子Actioons
let subAction1 = previewActionForTitle("微博")
let subAction2 = previewActionForTitle("好友圈")
let subAction3 = previewActionForTitle("QQ")
let subAction4 = previewActionForTitle("微信")
let groupedActions = UIPreviewActionGroup(title: "分享…", style: .Default, actions: [subAction1, subAction2, subAction3, subAction4] )
return [action1, action2, groupedActions]
}()
override func previewActionItems() -> [UIPreviewActionItem] {
return previewActions
}

更快速的方法

上面是代码激活Peek的方式,还有更Peek的方式:直接在Storyboard中使用Segue,在Segue属性面板中把Peek & Pop 勾选上就完事了。

使用这种方式指定我们在代码中连注册都不用,所以使用SB的项目适配3D Touch那是分分钟搞定的事,尤其在Xcode7出了Storyboard References后,我大 Swift + Storyboard 组合势必统一iOS界~

好了,有点小激动了,继续回到正文

在正常情况下,Peek窗口默认显示目标VC的整个View,但在实际应用中,可能会有更多的需求,比如说二个Button Push的是同一个VC,但是需要分别显示不同的Peek窗口。

其实也很简单,我们只需要自定义一个Peek的生命周期扩展就行了,previewingContext:viewControllerForLocation:方法中代表Peek的开始,previewingContext:commitViewController代表Peek的结束,然后在目标VC中重写二个方法就行了

1
2
3
4
5
6
7
8
9
10
//UIViewController+PeekCycle.swift
/**
Peek生命周期
**/

extension UIViewController {
//开始peek,VC为Peek显示做初始化
func beginPeek(){}
//结束peek,VC为真正显示做初始化
func endPeek(){}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//Delegate
func previewingContext(previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
let detailVc = self.storyboard?.instantiateViewControllerWithIdentifier("DetailViewController") as! DetailViewController
//指定Peek窗口类型
detailVc.peekType = .Image
//设置Peek的高度
detailVc.preferredContentSize = CGSize(width: 0.0, height: 320);
detailVc.view //先访问一下view,初始化
detailVc.beginPeek() //peek开始
return detailVc;
}
func previewingContext(previewingContext: UIViewControllerPreviewing, commitViewController viewControllerToCommit: UIViewController) {
viewControllerToCommit.endPeek() //peek结束
showViewController(viewControllerToCommit, sender: self)
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
//目标VC
override func beginPeek() {
if(peekType == .Comments){ //如果是评论则只显示评论视图
imageView.hidden = true
}else{ //否则显示图片
commentsView.hidden = true
}
}
override func endPeek() {
if(peekType == .Comments){
imageView.hidden = false
}else{
commentsView.hidden = false
}
}

Note

  • 如果要改变Peek窗口的size可以设置目标VC的preferredContentSize
  • 对于直接使用registerForPreviewingWithDelegate注册VC的self.view,虽然可以自动注册subviews,但是如果说你的VC中不止一种视图要触发Peek,那么它会分分钟教你做人的道理。

UITouch

高级玩法,绘图、游戏,把3D Touch发挥到极致。不过我也唔知玩也暂时没这方面需求,有需求看官方绘图demo

参考

Adopting 3D Touch on iPhone

ApplicationShortcuts Demo

ViewControllerPreviews Demo

小小广告

本人目前是一名自由职业者,接受移动两端的项目开发,如果你有需求或者有资源请速与我联系吧,QQ865425695