美文网首页iOS软件相关
iOS12新特性-捷径 Siri ShortCuts(用户自定义

iOS12新特性-捷径 Siri ShortCuts(用户自定义

作者: 云洋 | 来源:发表于2018-10-14 17:53 被阅读107次

    具体步骤:

    1、修改项目的info.plist文件
    添加key:"NSUserActivityTypes"
    添加value:类型为"array",用于存储多个"唯一标识符",类型为"string"
    
    例如:
    <key>
        NSUserActivityTypes
    </key>
    <array>
        <string>
            XXXXXX.XXXXXX.SiriShortcuts.SendTask
        </string>
    </array>
    
    info.plist设置效果图
    2、为界面或者控制器添加UserActivity方法
    // 捷径:编辑新任务
    #import <Intents/Intents.h>
    #import <IntentsUI/IntentsUI.h>
    #import <CoreSpotlight/CoreSpotlight.h>
    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(@"跳往设置语音界面!");
            }];
        }
    }
    
    /*
        签订协议<INUIAddVoiceShortcutViewControllerDelegate>,实现代理方法
    */
    #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<INVoiceShortcut *> * _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 应用 (一)

    相关文章

      网友评论

        本文标题:iOS12新特性-捷径 Siri ShortCuts(用户自定义

        本文链接:https://www.haomeiwen.com/subject/gunuoftx.html