3D Touch大法

2016/9/11 comments

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信息

<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数组

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事件的源视图

//注册
registerForPreviewingWithDelegate(self, sourceView: userVCBtn)
//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数组就行了。

//目标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中重写二个方法就行了

//UIViewController+PeekCycle.swift
/**
 Peek生命周期
**/
extension UIViewController {
    //开始peek,VC为Peek显示做初始化
    func beginPeek(){}
    //结束peek,VC为真正显示做初始化
    func endPeek(){}
}
//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)
}
//目标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