转载

iOS12 Siri Shortcuts初探

简述

开发者期待的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动作

iOS12 Siri Shortcuts初探

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

正文到此结束