SiriKit 实践

ios 10 给我们带来了很多惊喜的特性，其中很多为开发者提供的。其中一个就是SiriKit。

Sirikit提供给开发者使用了！这听起来是个不错的消息，WWDC上也是响起了雷鸣般的掌声。相信许多开发者和我一样，开始幻想了，Siri现在可以与我自己的应用对话了，我可以写一些好玩的功能，或者新开发一些好玩的应用。

不妙的是，WWDC在后面又说只支持下列6类应用：

语音和视频通话
发送消息
收款或者付款
图片搜索
管理锻炼
行程预约

看样子Siri并没有那么开放。

我的疑问就来了，SiriKit 是怎样限制只能这几种应用呢？

我先来介绍一个重要的概念Intents
字面翻译过来是意图, 意向。Siri说出来的话，不会直接进入到我们的app，而是会先生成一个NSIntent对象。对应6种应用，都有各自的Intents。例如发送消息的应用是INSendMessageIntent，管理锻炼是INStartWorkoutIntent, INEndWorkoutIntent等等。每种Intents都有相关的属性。
例如INSendMessageIntent

public class INSendMessageIntent : INIntent {

    
    public init(recipients: [INPerson]?, content: String?, groupName: String?, serviceName: String?, sender: INPerson?)

    
    // 发送目标对象
    public var recipients: [INPerson]? { get }

    
    // 发送内容
    public var content: String? { get }

    // 发送的群名称，组名称
    public var groupName: String? { get }

    
    // 用什么服务来发
    public var serviceName: String? { get }

    
    // 发送来源对象
    @NSCopying public var sender: INPerson? { get }
}

Siri将说出的话，进行分词分析
1.确定app名称, 你说的话里面要含app名称，比如“微信发送消息给xx”。经过我自己的实践，也不必每次都要带上app名称，siri会聪明的记住你上次唤醒的应用，后面就不用带上app名称，直接“发送消息给xx”就可以了
2.匹配应用类型关键字，确定这些分词是否存在关键字，比如说发送消息应用的关键字就是“发送”，管理锻炼的应用就是“锻炼”

上面两点满足了，才可以进入Sirikit extension
3.对号入座，看其他分词是否能够填充到Intent相应的属性中，你后面只能使用Intent提供的这些属性，其他的分词Siri分析不能填充属性的，都被忽略

可见, 6中应用都有各自的关键字和规定属性，SiriKit就是靠这种规范来限制应用的。

---

SiriKit必备的三个步骤

WWDC上讲了SiriKit必备的三个步骤，这也是开发者需要实现的。

Paste_Image.png

• Resolve阶段：上面说的第三条对号入座就是这个阶段，将语音中的关键信息提取出来并且填充INIntent中对应的属性。这是信息获取阶段，简单说就是“全与不全”
• Confirm阶段：Resolve阶段已经把完整的信息交给了这个阶段，这个阶段就是根据自身App的逻辑判断，这个信息是否允许执行，简单的说就是“能与不能”，如果判定为允许，那么INIntent就会信息就会传递给UI展示
• handle阶段： UI展示后，用户语音或手动确认进入handle阶段，这个时候就可以将INIntent按照自己意愿去处理了，处理之后的结果通过UI反馈给用户

---

SiriKit extension 的创建

这个地方大同小异，请允许我引用其他文章
用开发者账号去下载Xcode8_beta版，然后升级一台设备到ios10
创建一个空白项目，新增一个TARGET

Paste_Image.png

Paste_Image.png

如上图所示，我创建的Intents Extension被我命名为LXDSiriExtension。记住在创建好一个Extension的时候，会询问你是否激活这个扩展，勾选是。另外还会提示你是否连同Intents UI Extension一并创建了，我们同样选是。这样我们在项目下面总共创建了LXDSiriExtension和LXDSiriExtensionUI两个TARGET，这两个文件目录下面分别存在着一个新的info.plist文件，这个文件用来设置intent事件发生时我们设置的处理类。

Paste_Image.png

按图中的层次展开，IntentsSupported和IntentsRestrictedWhileLocked分别是两个字符串数组，每一个字符串表示的是应用扩展处理的intent事件的类名。前者表示支持的事件类型，后者表示在非锁屏状态下执行的事件类型。文件默认是workout类型的事件，在这里笔者改成了发送消息INSendMessageIntent。除此之外，NSExtensionPrincipalClass对应的是INExtension子类类名，这个类用来获取处理intent事件的类。

Paste_Image.png

---

SiriKit extension UI

Paste_Image.png

拿发送信息应用为例
这个是苹果提供Sirikit的demo, 跑出来界面，用来发送信息的。我们所能管辖的UI部分，就是红色圈圈里面的内容，其他都是系统的，不在我们的管辖范围之内。

那么这个红色区域是用来做什么的呢，文档上说，是来展示我们应用的商标的，因为这个界面各种应用的模式都是这个样子，用商标来区分，让用户知道用的是哪个应用。

在siriextensionUI的代码中，主要是靠configure来自定义页面的

// Prepare your view controller for the interaction to handle.
    func configure(with interaction: INInteraction!, context: INUIHostedViewContext, completion: ((CGSize) -> Void)!) {
        // Do configuration here, including preparing views and calculating a desired size for presentation.
        if interaction.intent is INSendMessageIntent {
            let sendMessageIntent:INSendMessageIntent = interaction.intent as! INSendMessageIntent;
            // 如果有收信人就显示红色背景，否则显示黑色背景
            if sendMessageIntent.recipients!.count > 0 {
                view.backgroundColor = UIColor.red()
            } else {
                view.backgroundColor = UIColor.black()
            }
        }
        if let completion = completion {
            completion(self.desiredSize)
        }
    }

INInteraction会包含NSIntent，也就是用户所说的话，我们可以NSIntent属性来表现出不同UI表现

根据文档中描述，有以下注意事项：

• 不能放广告
• 事件，不能添加任何手势，一些有交互的控件
• 界面dissmiss不要保存数据
• 做动画要在 DidAppear 开始，willDissAppear 结束
• UI显示要快

SiriKit 不用 Storyboard

Paste_Image.png

如果不想使用Storyboard

Paste_Image.png

可以用NSExtensionPrincipalClass替换NSExtensionMainStoryboard的key，value写入vc类

---

Siri 返回结果

后补