关于SiriKit

在6月14日凌晨的WWDC2016大会上，苹果提出iOS10是一次里程碑并且推出了十个新特性，大部分的特性是基于iPhone自身的原生应用的更新，具体的特性笔者不在这里再次叙述，请看客们移步WWDC2016下载自行观赏。要说里程碑在笔者看来有些夸大其实了，不过新增的通知中心联动3D Touch确实为人机交互带来新的发展，另外一个最大的亮点在于Siri的接口开放。在iOS10中提供了SiriKit框架在用户使用Siri的时候会生成INExtension对象来告知我们的应用，通过实现方法来让Siri获取应用想要展示给用户的内容

Siri服务

在iOS10之后，苹果希望Siri能够给用户带来更多的功能体验，基于这个出发点，新增了SiriKit框架。Siri通过语言处理系统对用户发出的对话请求进行解析之后生成一个用来描述对话内容的Intents事件，然后通过SiriKit框架分发给集成框架的应用程序以此来获取应用的内容，比如完成类似通过文字匹配查找应用聊天记录、聊天对象的功能，此外它还支持为用户使用苹果地图时提供应用内置服务等功能。通过官方文档我们可以看到SiriKit框架支持的六类服务分别是：

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

Siri和Maps通过Intents extension的扩展方式和我们的应用进行交互，其中，类型为INExtension的对象扮演着Intents extension扩展中直接协同Siri对象共同响应用户请求的关键角色。当我们实现了Intents extension扩展并产生了一个Siri请求事件时，一个典型的Intent事件的处理过程中总共有这三个步骤Resolve、Confirm和Handle：

• Resolve阶段。在Siri获取到用户的语音输入之后，生成一个INIntent对象，将语音中的关键信息提取出来并且填充对应的属性。这个对象在稍后会传递给我们设置好的INExtension子类对象进行处理，根据子类遵循的不同服务protocol来选择不同的解决方案

• Confirm阶段。在上一个阶段通过handler(for intent:)返回了处理intent的对象，此阶段会依次调用confirm打头的实例方法来判断Siri填充的信息是否完成。匹配的判断结果包括Exactly one match、Two or more matches以及No match三种情况。这个过程中可以让Siri向用户征求更具体的参数信息

• 在confirm方法执行完成之后，Siri进行最后的处理阶段，生成答复对象，并且向此intent对象确认处理结果然后执显示结果给用户看

创建Intents Extension

SiriKit通过添加App Extension的方式来完成集成，这是一种独立于应用本身运行的代码结构，作为应用的扩展功能，只有在需要的时候系统会唤醒这些Extension代码来执行任务，然后在执行完毕之后将其杀死。另一方面，这些Extension在运行过程中的可占用内存是较少的，并且由于调用时机的限制，我们也无法在运行期间做一些坏事

plist设置

import Intents

class LXDMatch {
    var handle: String?
    var displayName: String?
    var contactIdentifier: String?

    convenience init(handle: String, _ displayName: String, _ contactIdentifier: String) {
        self.init()
        self.handle = handle
        self.displayName = displayName
        self.contactIdentifier = contactIdentifier
    }

    func inPerson() -> INPerson {
        return INPerson(handle: handle!, displayName: displayName, contactIdentifier: contactIdentifier)
    }
}

class LXDAccount {
    private static let instance = LXDAccount()

    private init() {
        print("only call share() to get an instance of LXDAccount")
    }

    class func share() -> LXDAccount {
        return LXDAccount.instance
    }

    func contact(matchingName: String) -> [LXDMatch] {
        return [LXDMatch(handle: NSStringFromClass(LXDSendMessageIntentHandler.classForCoder()), matchingName, matchingName)]
    }

    func send(message: String, to recipients: [INPerson]) -> INSendMessageIntentResponseCode {
        print("Send a message: \"\(message)\" to \(recipients)")
        return .success
    }
}

在完成这些需要的工作之后，我们还需要对应用本身的Info.plist配置文件进行设置，新增一个关键字为NSSiriUsageDescription的字符串对象，对应填写的字符串将在我们征询用户Siri权限的时候显示给用户看。比如Siri想要访问您的应用信息之类的提示语。然后通过INPreferences类方法向用户请求Siri访问权限

import Intents

INPreferences.requestSiriAuthorization {
    switch $0 {
    case .authorized:
        print("用户已授权")
        break
            
    case .notDetermined:
        print("未决定")
        break

    case .restricted:
        print("权限受限制")
        break
            
    case .denied:
        print("拒绝授权")
        break
    }
}

代码实现

首先我们需要一个INExtension的子类，你也可以在默认创建的子类中实现代码。在方法中，我们通过判断intent的类型来创建对应的处理者实例，然后返回。在本文的示例中，假设我们对Siri说出这么一句话 Siri，在微信上告诉我的家人们今天我不回去吃饭了：

class LXDIntentHandler: INExtension {
    override func handler(for intent: INIntent) -> AnyObject? {
    
        if intent is INSendMessageIntent {
            return LXDSendMessageIntentHandler()
        }
        //  这里可以判断更多类型来返回
        return nil
    }
}

通过判断intent事件是发送消息的聊天事件后，笔者创建了一个用来处理事件的LXDSendMessageIntentHandler类对象，并且返回。在对象创建完成之后需要完成Resolve、Confirm和Handle三个步骤，具体操作需要子类遵循实现INSendMessageIntentHandling协议来完成：

• Resolve阶段
  这个阶段需要我们找到消息的具体接收者。在这个过程中，可能会出现三种情况：Exactly one match、Two or more matches以及No matches，对于这三种情况的处理分别如下：

  func resolveRecipients(forSendMessage intent: INSendMessageIntent, with completion: ([INPersonResolutionResult]) -> Void) {
        if let recipients = intent.recipients {
            var resolutionResults = [INPersonResolutionResult]()
            for  recipient in recipients {
                let matches = LXDAccount.share().contact(matchingName: recipient.displayName)
                switch matches.count {
                case 2...Int.max:    //两个或更多匹配结果
                    let disambiguations = matches.map { $0.inPerson() }
                    resolutionResults.append(INPersonResolutionResult.disambiguation(with: disambiguations))
                break
            
                case 1:  //一个匹配结果
                    let recipient = matches[0].inPerson()
                resolutionResults.append(INPersonResolutionResult.success(with: recipient))
                    break
                
                case 0:  //无匹配结果
                    resolutionResults.append(INPersonResolutionResult.unsupported(with: .none))
                    break
  
                default:
                    break
                }
            }
            completion(resolutionResults)
        } else {
            //未从用户语音中提取到信息，需要向用户征询更多关键信息
            completion([INPersonResolutionResult.needsValue()])
        }
    }
  

  上面的代码用来确认出消息中的我的家人们指代的是哪些人，其中每个联系人最终用一个INPerson的对象来表示。接着我们需要匹配消息的内容：
  func resolveContent(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Void) {
  if let text = intent.content where !text.isEmpty {
  completion(INStringResolutionResult.success(with: text))
  } else {
  //向用户征询发送的消息内容
  completion(INStringResolutionResult.needsValue())
  }
  }
  在匹配完消息接收者跟消息内容之后，对于intent事件的处理就会进入第二阶段Confirm确认值是否正确

• Confirm阶段
  在这个阶段intent对象本身的信息预计是已经完成填充的，我们通过获取这些填充值来判断是否符合我们的要求。同时在这个阶段，Siri会尝试唤醒应用来准备完成最后的处理操作。前面说了为了保证在应用和应用拓展之间能够进行通信，最好使用frameworks的方式来标记应用是否被启动，再进行相应操作。
  func confirm(sendMessage intent: INSendMessageIntent, completion: (INSendMessageIntentResponse) -> Void) {
  /// let content = intent.content
  /// let recipients = intent.recipients
  /// do or judge in content & recipients
  completion(INSendMessageIntentResponse(code: .success, userActivity: nil))
  /// Launch your app to do something like store message record
  /// Use a singleton in frameworks to remark if the app has launched
  /// if not launched, use the code following
  /// completion(INSendMessageIntentResponse(code: .failureRequiringAppLaunch, userActivity: nil))
  }
  Confirm阶段是我们最后可以尝试修改intent事件中传递的数值的时候。要记住一点，完全精确的内容固然是最好的答案，但是过多的让Siri询问用户参数的详细信息也会导致用户的抵触

• Handle阶段
  Handle阶段不需要做太多额外的工作，判断一下消息接收者或消息内容是否存在，如果存在，执行类似保存/发送的工作，然后完成。否则告诉Siri本次的intent事件处理处理失败，我们还可以通过配置NSUserActivity对象来告诉Siri失败的原因
  func handle(sendMessage intent: INSendMessageIntent, completion: (INSendMessageIntentResponse) -> Void) {
  if intent.recipients != nil && intent.content != nil {
  /// do some thing success send message
  let success = LXDAccount.share().send(message: intent.content!, to: intent.recipients!)
  completion(INSendMessageIntentResponse(code: success, userActivity: nil))
  } else {
  let userActivity = NSUserActivity(activityType: String(INSendMessageIntent))
  userActivity.userInfo = [NSString(string: "error") : String("AppDidNotLaunch")]
  completion(INSendMessageIntentResponse(code: .failure, userActivity: userActivity))
  }
  }

事件UI

可以看到上面的代码主要集中在事件处理的逻辑上，那么在和Siri交互的过程中，我们同样可以让Siri展示响应的自定义界面：

func configure(with interaction: INInteraction!, context: INUIHostedViewContext, completion: ((CGSize) -> Void)!) {
    //这里执行界面设置的代码，完成之后执行completion代码就会让界面展示出来
    if let completion = completion {
        completion(self.desiredSize)
    }
}

var desiredSize: CGSize {
    return self.extensionContext!.hostedViewMaximumAllowedSize
}

尾言

在观看WWDC2016的新特性的时候，最开始给Siri和应用的交互惊艳到了。但是后来阅读文档发现这种交互仍然存在着过多的限制，整体而言并没有对Siri的使用带来更明显的提升。但是毫无疑问，这种交互如果苹果能继续对其进行补充发展，可以给我们的应用带来更多的新活力。
文集：iOS开发