iOS12 Siri ShortCuts 应用 （一）

本文介绍 Siri ShortCuts 的应用之一，可实现的功能是：
1、通过自定义 siri 短语打开 app , 并完成你想要完成的操作。
2、根据对用户行为的记录，让系统智能预测用户行为，并给出提示。
3、app 内引导用户添加或者修改语音指令。

插个题外话，开发该功能需要下载 Beat版Xcode10 和 iPhone升级到iOS12系统。项目升级后大多数是无法运行的，各种报错，可参考 Xcode10和iOS12踩坑这篇文章，会有很大的帮助。如果还有其他问题，可以在这篇文章或者我的文章下面留言。

先在项目的 plist 文件里定义 属性为 Array 的 NSUserActivityTypes，为其添加对应的属性值，比如：’com.xxxx.xxxx-sports’。

核心代码示例：

//此方法返回一个 NSUserActivity 对象。
- (NSUserActivity *)donateSportActivity{
    //根据plist文件的值，创建 UserActivity
    NSUserActivity *checkInActivity = [[NSUserActivity alloc] initWithActivityType:@"com.xxxx.xxxx-sports"];

    //设置 YES，通过系统的搜索，可以搜索到该 UserActivity
    checkInActivity.eligibleForSearch = YES;

    //允许系统预测用户行为，并在合适的时候给出提醒。（搜索界面，屏锁界面等。）
    if (@available(iOS 12.0, *)) {
        checkInActivity.eligibleForPrediction = YES;
    }

    checkInActivity.title = @"人生在于运动";

    //引导用户新建语音引导（具体效果见下图）
    if (@available(iOS 12.0, *)) {
        checkInActivity.suggestedInvocationPhrase = @"做运动";
    }

    CSSearchableItemAttributeSet * attributes = [[CSSearchableItemAttributeSet alloc] init];

    UIImage *icon = [UIImage imageNamed:@"ic_tool_sport"];
    attributes.thumbnailData = UIImagePNGRepresentation(icon);

    attributes.contentDescription = @"要坚持哦";

    checkInActivity.contentAttributeSet = attributes;

    return checkInActivity;
}

//Donate userActivity
self.userActivity = [self donateSportActivity];

以上代码添加到你需要地方，比如可以放到用户每天开始做运动的时候，这样，如果哪天没有做，系统会智能提示，该做运动了。

接着就是，如果用户通过 siri 短语，或者 系统的智能提示进入 app ,我们要识别出来，做出对应的结果。

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{

    if ([userActivity.activityType containsString:@"com.xxxx.xxxx-"]){
        PXSiriShortCutsManage *manage = [PXSiriShortCutsManage sharedShortCutsManage];
        [manage handleShortCutsActivityTypeType:userActivity.activityType];
    }
    return YES;
}

此处 handleShortCutsActivityTypeType 就是对应的处理方法，比如打开 app 内的某个页面等。

这样做完后，用户可以去系统设置->siri与搜索->更多捷径，去录制自己的个性语言指令。当然，如果觉得成本有点高，你也可以在 app 内引导用户去设置，从而不需要调转到系统设置。

添加语音指令：

INShortcut *shortCuts = [[INShortcut alloc] initWithUserActivity:self.userActivity];

INUIAddVoiceShortcutViewController *vc = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortCuts];

vc.delegate = self;

[self presentViewController:vc animated:YES completion:^{
    NSLog(@"aaa");
}];

修改的话，直接把目标 vc 换成 INUIEditVoiceShortcutViewController 即可。

当然这里有还有一个问题，如何判断用户是否已经添加了语音短语，从而确定去选择 add or edit ？

Intent类早已为我们准备好该方法，拿到结果后，遍历判断就好。

需要注意的是，该方法是不在主线程中执行，所以完成后，如果需要更新UI，请手动回到主线程。

[[INVoiceShortcutCenter sharedCenter] getAllVoiceShortcutsWithCompletion:^(NSArray<INVoiceShortcut *> * _Nullable voiceShortcuts, NSError * _Nullable error) {

 }];

Siri ShortCuts 还有一个 Extension 的功能，不打开 app 也可以做一些简单的事情，这个有机会再说吧，拜拜。