iOS12新特性-捷径 Siri ShortCuts（用户自定义语音指令）

具体步骤：

1、修改项目的info.plist文件

添加key:"NSUserActivityTypes"
添加value:类型为"array",用于存储多个"唯一标识符",类型为"string"

例如：

    NSUserActivityTypes


    
        XXXXXX.XXXXXX.SiriShortcuts.SendTask
    

info.plist设置效果图

2、为界面或者控制器添加UserActivity方法

// 捷径：编辑新任务
#import 
#import 
#import 
NSString * const viewMenuActivityTypeSendTask = @"XXXXXX.xxxxxx.SiriShortcuts.SendTask";

- (void)addUserActivity {

    // 经测试，“Siri与搜索”权限的开关不会影响“捷径（语音命令）”的设置
    // 其设置影响的是系统搜索是否显示该“捷径”，锁屏时是否推送该“捷径”的建议。
    /*
    if (@available(iOS 10.0, *)) { 
        
        INSiriAuthorizationStatus siriStatus = [INPreferences siriAuthorizationStatus];
        if (siriStatus != INSiriAuthorizationStatusAuthorized) { // 未授权
            [INPreferences requestSiriAuthorization:^(INSiriAuthorizationStatus status) {
                switch (status) {
                    case INSiriAuthorizationStatusNotDetermined:
                        NSLog(@"用户尚未对该应用程序作出选择。");
                        break;
                    case INSiriAuthorizationStatusRestricted:
                        NSLog(@"此应用程序无权使用Siri服务");
                        break;
                    case INSiriAuthorizationStatusDenied:
                        NSLog(@"用户已明确拒绝此应用程序的授权");
                        break;
                    case INSiriAuthorizationStatusAuthorized:
                        NSLog(@"用户可以使用此应用程序的授权");
                        break;
                    default:
                        break;
                }
            }];
        } else {
            NSLog(@"用户可以使用此应用程序的授权");
        }
    }
     */
    
    //根据plist文件的值，创建 UserActivity
    NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:viewMenuActivityTypeSendTask];
    
    // 捷径语音输入界面标题
    userActivity.title = @"捷径语音输入界面标题";
    // 设置 YES，通过系统的搜索，可以搜索到该 UserActivity
    userActivity.eligibleForSearch = YES;
    
    if (@available(iOS 12.0, *)) {
        
        // 允许系统预测用户行为，并在合适的时候给出提醒。（提醒将会出现在搜索界面，屏锁界面等）
        // 根据用户对此捷径的使用频次和时间点来预测用户行为。如用户经常用捷径订餐，系统根据用户习惯预测某个时间点用户可能会订餐并显示出来
        userActivity.eligibleForPrediction = YES;
        
        // "您可以像这样说..."下方的引导语。用户可能对着捷径语音设置界面不知所措
        // 引导语可引导用户完成语音命令绑定操作,用来直接提示用户该怎么说
        userActivity.suggestedInvocationPhrase = @"这是一条引导语";
    }
    
    CSSearchableItemAttributeSet *attributes = [[CSSearchableItemAttributeSet alloc] init];
    attributes.thumbnailData = UIImagePNGRepresentation([UIImage imageNamed:@"application_baoxiao"]);
    attributes.keywords = @[@"搜索",@"关键词",@"试试看"];
    // 捷径语音输入界面子标题
    attributes.contentDescription = @"捷径语音输入界面子标题";
    
    userActivity.contentAttributeSet = attributes;
    
    if (@available(iOS 12.0, *)) {
        
        INShortcut *shortCuts = [[INShortcut alloc] initWithUserActivity:userActivity];
        INUIAddVoiceShortcutViewController *addvc = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortCuts];
        addvc.delegate = self;
        [self presentViewController:addvc animated:YES completion:^{
            NSLog(@"跳往设置语音界面！");
        }];
    }
}

/*
    签订协议，实现代理方法
*/
#pragma mark - INUIAddVoiceShortcutViewControllerDelegate
- (void)addVoiceShortcutViewController:(INUIAddVoiceShortcutViewController *)controller didFinishWithVoiceShortcut:(nullable INVoiceShortcut *)voiceShortcut error:(nullable NSError *)error API_AVAILABLE(ios(12.0)); {
    if (!error) {
        [controller dismissViewControllerAnimated:YES completion:nil];
    }
}

- (void)addVoiceShortcutViewControllerDidCancel:(INUIAddVoiceShortcutViewController *)controller API_AVAILABLE(ios(12.0)); {
    [controller dismissViewControllerAnimated:YES completion:nil];
}

3、使用添加UserActivity的方法

if (@available(iOS 12.0, *)) {
        // 获取已注册的voiceShortcuts
        [[INVoiceShortcutCenter sharedCenter] getAllVoiceShortcutsWithCompletion:^(NSArray * _Nullable voiceShortcuts, NSError * _Nullable error) {
            NSLog(@"已向系统注册的voiceShortcuts: %@", voiceShortcuts);
            if (voiceShortcuts.count != 0) {
                for (int i = 0; i < voiceShortcuts.count; i ++) {
                    if ([voiceShortcuts[i].shortcut.userActivity.activityType isEqualToString:viewMenuActivityTypeSendTask]) {
                        NSLog(@"已经被注册了");
                    }
                }
            } else {
                [UIAlertController zly_showSheetAlertViewWithTitle:@{@"内容提示":@0}
                                                           message:@"此功能已支付Siri Shortcut,是否前往设置?"
                                                       actionTitle:@[@{@"取消":@1},@{@"前往":@2}]
                                                    viewController:self
                                                           handler:^(UIAlertAction *action) {
                                                               if ([action.title isEqualToString:@"前往"]) {
                                                                  // 使用UserActivity
                                                                   [self addUserActivity];
                                                               }
                                                           } completion:nil];
            }
        }];
    }

4、添加后效果

1、用户可以通过系统搜索直达目标界面，无论应用是否处于后台
2、用户可以通过Siri语音命令直达目标界面，无论应用是否处于后台

5、效果图

步骤3的效果

使用添加UserActivity的方法效果

步骤2的效果

为界面或者控制器添加UserActivity方法_图1

为界面或者控制器添加UserActivity方法_图2

为界面或者控制器添加UserActivity方法_图3

6、其它

因为已经将此Siri ShortCuts加入了搜索建议，所以在完成语音录制后，搜索语音录制命令，会直接出现在搜索结果下方。

Siri ShortCuts 搜索结果

• 对于已经完成设置的Siri ShortCuts，我们可以到设置中进行删除或者语音命令更改。
• 对于此代码，如果已经设置了某个Siri ShortCuts，软件内部不再提示设置，若在设置中删除，则会重新提示。根据自己需求更改相关的判断代码。
• 找到已设置的捷径列表：设置->Siri与搜索->我的捷径

语音命令_发布任务

点击上图中需要重新录制语音指令的捷径，则会跳转到语音录制界面；左划，则可删除此捷径。

语音命令_重新设置

参考资料：

1. 苹果官方文档
2. iOS12 SiriKit新特性 shortcuts（一）（Objective-C版本）
3. iOS12 Siri ShortCuts 应用 （一）