简述
开发者期待的2018 WWDC如期开始，然而今年并没有什么特别大的功能亮点，主要是进行一些bug修复和性能提升，而少之又少的功能里面最让我期待的还是Shortcuts,粗略的了解了下功能就是可以通过自定义一个短语，能过Siri来唤起特定的功能，可以在应用中添加“添加到Siri”按钮，点击后会把这个动作列到 My Shortcuts列表里面，还会有一个Shortcuts应用，用这个应用可以把一连串动作连接起来执行，也就是workflow的效果；这也是之前苹果收购workflow的原因。
大概了解了它的功能，下面就带大家看看如何开发一个这样的功能
创建事件
1.使用NSUserActivity
NSUserActivity提供了一个轻量级的方法实现donation功能，它还集成了其他苹果功能，如Handoff和Spotlight search, 要使用NSUserAcgivity首先在Info.plist里面定义NSUserActivityTypes类别，然后就可以定义NSUserActivity实例了，设置activityType、title、userInfo等属性, 还可以设置suggestedInvocationPhrase属性给用户Siri建议短语，最后调用 becomeCurrent()方法，这会使它加入Siri中
2.使用自定义 INIntent
系统提供的INIntent功能有限，iOS12之前系统并没有给我们提供自定义INIntent的功能，通过查看官方Demo发现可以使用Intents.intentdefinition文件添加自定义类型的INObject动作
Custom Intent
- Category为intent的类别，内部的选项基本包括常用的所有操作，如果没有对应的功能，还能选择通用类别
- Title 标题，会显示在My Shortcuts列表内
- Description 描述信息
在Parameters类别中可以添加这个Intent对应的参数，最后还可以通过这些参数来显示不同的Title和Subtitle，之后编辑器会通过这个文件自动生成对应的INIntent类
public class OrderSoupIntent: INIntent {
@NSManaged public var soup: INObject?
@NSManaged public var quantity: NSNumber?
@NSManaged public var options: [INObject]?
}
然后就可以通过这个类来创建动作对象
public var intent: OrderSoupIntent {
let orderSoupIntent = OrderSoupIntent()
orderSoupIntent.quantity = quantity as NSNumber
orderSoupIntent.soup = INObject(identifier: menuItem.itemNameKey, display: menuItem.localizedString)
//可以设置图片，显示在shortcuts列表上
if let image = UIImage(named: menuItem.iconImageName),
let data = image.pngData() {
orderSoupIntent.setImage(INImage(imageData: data), forParameterNamed: "soup")
}
orderSoupIntent.options = menuItemOptions.map { (option) -> INObject in
return INObject(identifier: option.rawValue, display: option.localizedString)
}
let comment = "Suggested phrase for ordering a specific soup"
let phrase = NSLocalizedString("ORDER_SOUP_SUGGESTED_PHRASE", bundle: Bundle.soupKitBundle, comment: comment)
orderSoupIntent.suggestedInvocationPhrase = String(format: phrase, menuItem.localizedString)
return orderSoupIntent
}
创建完后通过INInteraction的donate方法就可以把对应的动作写进Shortcuts
let interaction = INInteraction(intent: order.intent, response: nil)
interaction.donate { (error) in
if error != nil {
if let error = error as NSError? {
os_log("Interaction donation failed: %@", log: OSLog.default, type: .error, error)
}
} else {
os_log("Successfully donated interaction")
}
}
添加Siri短语
我们可以在应用对应的位置添加“添加到Siri”按钮，引导用户把对应的动作用Siri短语来执行(苹果建议当用户完成一个动作后，引导用户把这个动作加入Siri, 而不是没进行过这个动作直接添加到Siri)，当然，用户也可以主动到设置中去设置。
添加和编辑主要用到INUIAddVoiceShortcutViewController和INUIEditVoiceShortcutViewController类，都有对应的代理回调设置后的结果
//添加
let addVoiceShortcutVC = INUIAddVoiceShortcutViewController(shortcut: shortcut)
addVoiceShortcutVC.delegate = self
present(addVoiceShortcutVC, animated: true, completion: nil)
//如果之前已经添加过，编辑Siri短语
let editVoiceShortcutViewController = INUIEditVoiceShortcutViewController(voiceShortcut: shortcut)
editVoiceShortcutViewController.delegate = self
present(editVoiceShortcutViewController, animated: true, completion: nil)
处理Shortcuts事件
添加完事件，当然最重要的还是回调处理，通过在AppDelegate代理就可以直接接收到进入到APP内的对应动作，代理中可以判断对应的动作，然后实现对应的功能就可以了
func application(_ application: UIApplication,
continue userActivity: NSUserActivity,
restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
if let intent = userActivity.interaction?.intent as? OrderSoupIntent {
handle(intent)
return true
} else if userActivity.activityType == NSUserActivity.viewMenuActivityType {
handleUserActivity()
return true
}
return false
}
Shortcuts管理
苹果提供INVoiceShortcutCenter类对象对应用所有的Shortcuts进行管理，它是一个单例对象,提供设置和获取INShortcut的方法
func getAllVoiceShortcuts(completion: ([INVoiceShortcut]?, Error?) -> Void)
func getVoiceShortcut(with: UUID, completion: (INVoiceShortcut?, Error?) -> Void)
func setShortcutSuggestions([INShortcut])
参考
https://developer.apple.com/documentation/sirikit#2979425
