作者: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
函数。你也可以调用 disambiguation
、confirmationrequired
或 unsupported
。后面会详细说明区别,现在先介绍如何使用 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 当前信息缺失,需要提供内容值。可以调用 INStringResolutionResult
的 needsValue
类方法来请求值。
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。