Siri shortcuts 指北

系统支持iOS 12

工程搭建

开启工程权限

添加新的target

选择File → New → Target，勾选Include UI Extension，能够使用自定义UI扩展。

建立Intent Definition File

方法：File → New → File

新建Intent

建立完后以下界面：

能够看到Intent是一个Category，咱们能够设置类型（标示Intent的做用），添加参数（根据Siri解析命令传入），添加标题，描述（这些会显示在Siri唤醒咱们app的时候）。

编译的时候系统会自动生成一个子类XXXIntent : INIntent，咱们须要找到这个类，使用这个类来进行咱们的其余操做。

点击以下图位置：

开发过程

权限获取

获取当前权限

INSiriAuthorizationStatus siriStatus = [INPreferences siriAuthorizationStatus];
复制代码

请求获取权限

[INPreferences requestSiriAuthorization:^(INSiriAuthorizationStatus status) {
                switch (status) {
                    case INSiriAuthorizationStatusAuthorized: // 成功获取权限
                        NSLog(@"权限获取成功");
                        break;
                    case INSiriAuthorizationStatusDenied: // 成功获取权限
                        NSLog(@"权限获取用户拒绝");
                        break;
                        
                    default:
                        break;
                }
            }];
复制代码

注意添加info.plist（或者多语言）设置提示语，不然权限请求不会弹出。

添加Siri快捷指令页面

调用系统API，调用以下页面。

代码以下：

GotoPageIntent *intent = [[GotoPageIntent alloc] init]; // GotoPageIntent为咱们自定义的Intent，找不到看上面
    intent.suggestedInvocationPhrase = @"打开app"; // 这是建议的提示语，会展现在页面上
    INShortcut *shortcurt = [[INShortcut alloc] initWithIntent:intent];
    
    INUIAddVoiceShortcutViewController *addvc = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortcurt];
    addvc.delegate = self;
    [self presentViewController:addvc animated:YES completion:nil];
复制代码

处理回调：

/*!
 @abstract Called after the user finishes the setup flow for the voice shortcut, with either the successfully-added voice shortcut, or an error.
 @discussion Your implementation of this method should dismiss the view controller.
 */
- (void)addVoiceShortcutViewController:(INUIAddVoiceShortcutViewController *)controller didFinishWithVoiceShortcut:(nullable INVoiceShortcut *)voiceShortcut error:(nullable NSError *)error; {
    if (!error) {
        [controller dismissViewControllerAnimated:YES completion:nil];
    }
}

/*!
 @abstract Called if the user cancels the setup flow; the voice shortcut was not added.
 @discussion Your implementation of this method should dismiss the view controller.
 */
- (void)addVoiceShortcutViewControllerDidCancel:(INUIAddVoiceShortcutViewController *)controller; {
    [controller dismissViewControllerAnimated:YES completion:nil];
}
复制代码

处理Siri Shortcuts触发的回调

• 自定义xxxIntentHandler，继承自NSObject。遵循xxxIntentHandling（这个是咱们Xcode本身生成的，找的方法见上面建立Intent Definition File中），在里面实现咱们须要的逻辑。

- (void)handleGotoPage:(GotoPageIntent *)intent completion:(void (^)(GotoPageIntentResponse *response))completion NS_SWIFT_NAME(handle(intent:completion:)) {
    // GotoPageIntentResponseCodeContinueInApp 打开app
    // GotoPageIntentResponseCodeSuccess 回调成功
    GotoPageIntentResponse *response = [[GotoPageIntentResponse alloc] initWithCode:GotoPageIntentResponseCodeSuccess userActivity:nil];
    completion(response);
}

复制代码

• 打开咱们的Extension，IntentHander方法。处理咱们本身定义的Intent。

- (id)handlerForIntent:(INIntent *)intent {
    if ([intent isKindOfClass:[GotoPageIntent class]]) {
        return [[GotoAppIntentHandler alloc] init];
    }
    
    return self;
}
复制代码

自定义 ExtensionUI

能够自定义Siri呼出app的样式，在IntentViewController中开发。

参考资料

WWDC视频：

developer.apple.com/videos/play…

苹果Demo地址：

developer.apple.com/documentati…

文档： developer.apple.com/documentati…