作者:Jameson Quave,原文链接,原文日期:2016-06-20
译者:Crystal Sun;校对:numbbbbb;定稿:CMB

这篇教程写于 2016 年 6 月 20 日,使用 Xcode 8 Beta 1 和 Swift 3 开发。

此文章是 SiriKit 教程系列的第二篇,建议先去阅读第一篇

处理 SiriKit 请求

为了让集成的 Siri 更有用,可以使用 INSendMessageIntentHandling 协议的回调方法增加信息内容。协议有以下可选方法:

resolveRecipients(forSendMessage intent: INSendMessageIntent, with completion: ([INPersonResolutionResult]) -> Swift.Void)

resolveContent(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Swift.Void)

resolveGroupName(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Swift.Void)

resolveServiceName(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Swift.Void)

resolveSender(forSendMessage intent: INSendMessageIntent, with completion: (INPersonResolutionResult) -> Swift.Void)

只要实现这些方法,就可以给 SiriKit 提供更多信息,例如接收者(recipients)、内容(content)、小组名字(group name)、服务名字(service name)或者发送者(sender)。

本例的标题内容使用静态数据,主要是为了展示如何使用上面的方法。

首先实现 resolveContent 协议方法。

func resolveContent(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Void) {
let message = "My message body!"
let response = INStringResolutionResult.success(with: message)
completion(response)
}

这里我们创建了一个字符串并调用 success 函数。你也可以调用 disambiguationconfirmationRequiredunsupported 。后面会详细说明区别,现在先介绍如何使用 Siri 提供的数据。

Siri 传入的 intent 对象包含文字版的消息内容。我们只对 content 属性感兴趣,把它嵌入字符串中。

func resolveContent(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Void) {
let message = "Dictated text: \(content!)"
let response = INStringResolutionResult.success(with: message)

completion(response)
}

内容属性是可选值,如此一来,需要确保 Siri 真的提供了文字内容。如果没有文字,那消息就没什么用,这时需要告知 Siri 当前信息缺失,需要提供内容值。可以调用 INStringResolutionResultneedsValue 类方法来请求值。

func resolveContent(forSendMessage intent: INSendMessageIntent, with completion: (INStringResolutionResult) -> Void) {
if let content = intent.content {
let message = "Dictated text: \(content)"
let response = INStringResolutionResult.success(with: message)
completion(response)
}
else {
let response = INStringResolutionResult.needsValue()
completion(response)
}
}

现在当我们尝试发送消息时,SiriKit 就明白必须要提供内容值。接收方也要实现同样的功能。在本例中,接收方可以有多个值,可以使用多种方法从中查询目标值。如果你有一个聊天应用,那可以检查传入的 INPerson 对象,判断应该发送给哪个用户。

不过这些已经超出本教程的范围,留给你自己实现吧。你可以在自己的应用中实现 resolveRecipients 方法。如果需要示例代码,可以查看苹果的示例

更多 iOS 10 教程

我会继续研究 iOS 10,之后也会继续发布 iOS 10 教程。你可以订阅我们的 newsletter在 Twitter 上关注我

本文由 SwiftGG 翻译组翻译,已经获得作者翻译授权,最新文章请访问 http://swift.gg

文章目录
  1. 1. 处理 SiriKit 请求
  2. 2. 更多 iOS 10 教程