天天看点

Siri Shortcuts intent 扩展开发import "ViewController.h"import "SiriIntent.h"import <IntentsUI/IntentsUI.h>

直接开始

第一步: 添加文件Sirikit Intent Definition File

截屏2020-12-18 下午2.26.15.png

第二步:编辑文件

截屏2020-12-18 下午2.27.52.png

选择处理类别 generic 是直接运行 项目,其他的需要操作

截屏2020-12-18 下午2.28.42.png

如果选择了这个按钮也是需要点击后才开始执行,不选择则会直接运行

截屏2020-12-18 下午2.29.55.png

这里添加你想要跟业务相关的字段

截屏2020-12-18 下午2.32.34.png

在这里直接设置 可以在添加快捷指令页面显示

截屏2020-12-18 下午2.33.22.png

编译运行,会在右侧编辑栏看到

截屏2020-12-18 下午2.40.36.png

siriintent 就是你接下来需要用到的类

第二步:

添加intent ,创建intent 时候会提示是否同时创建intent UI,如果需要页面展示选择是

截屏2020-12-18 下午2.38.32.png

这块就是你创建好之后的文件目录

截屏2020-12-18 下午2.42.03.png

网上大多在讲解在intentHandler类中 导入你的intent文件头文件,你会发现此时会报头文件找不到

截屏2020-12-18 下午2.42.55.png

注意:此时你就需要在targets-》build phases 中添加第一步你所创建的intentdefinition文件,这样你在intent文件导入头文件时,就不会报错了,intent UI 中也需要这么做

截屏2020-12-18 下午2.44.56.png

第三步,代码处理

在intenthandler中根据intent业务类型不同判断处理逻辑

  • (id)handlerForIntent:(INIntent *)intent {

    if ([intent isKindOfClass:[SiriIntent class]]) {

    SiriIntentHandler * siriHander = [[SiriIntentHandler alloc]init];
    return siriHander;           

    }

    // This is the default implementation. If you want different objects to handle different intents,

    // you can override this and return the handler you want for that particular intent.

    return self;

第四步,在你的intentViewController 类中 修改定制你的UI

  • (void)configureViewForParameters:(NSSet )parameters ofInteraction:(INInteraction )interaction interactiveBehavior:(INUIInteractiveBehavior)interactiveBehavior context:(INUIHostedViewContext)context completion:(void (^)(BOOL success, NSSet *configuredParameters, CGSize desiredSize))completion {

    // Do configuration here, including preparing views and calculating a desired size for presentation.

    SiriIntentResponse rsp = (SiriIntentResponse ) interaction.intentResponse;

    SiriIntent intent = (SiriIntent )interaction.intent;

    if (rsp.code == SiriIntentResponseCodeSuccess) {

    self.name.text = @"成功";           
    if (completion) {
    completion(YES, parameters, [self desiredSize]);           
    }else{
    self.name.text = @"开始";
    if (completion) {
        completion(YES, parameters, [self desiredSize]);
    }           

在这个类中 添加你的业务逻辑

再次注意: 如果你的的业务逻辑也需要涉及到http请求,在 intent UI或者 intent 中的 info.plist文件中 添加

Allow Arbitrary Loads ---- yes

允许http请求

第五步,开始在你的主项目使用siri shourtcuts的地方添加调起代码

//

// ViewController.m

// siri-intents

// Created by david on 2020/11/27.

// Copyright © 2020 david. All rights reserved.

import "ViewController.h"

import "SiriIntent.h"

#import <Intents/Intents.h>

import <IntentsUI/IntentsUI.h>

@interface ViewController ()< INUIEditVoiceShortcutViewControllerDelegate,INUIAddVoiceShortcutViewControllerDelegate>

@property(nonatomic,strong) INUIAddVoiceShortcutViewController *customShortCutViewController;

@property(nonatomic,strong) SiriIntent *testIntent;

@property(nonatomic,strong) SiriIntentResponse *testIntentResponse;

@property(nonatomic,strong) INInteraction *interaction;

@property(nonatomic,strong) INShortcut *shortcut;

@end

@implementation ViewController

  • (void)viewDidLoad {

    [super viewDidLoad];

    self.title = @"SiriTest";

    if (@available(iOS 12.0, *)) {
          
          [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;
              }
              
          }];
      }           

    UIButton *_addSiriBtn = [[UIButton alloc] initWithFrame:CGRectMake(30, 151, 200, 50)];

    [_addSiriBtn setTitle:@"编辑siri" forState:UIControlStateNormal];

    [_addSiriBtn setTitleColor:UIColor.blueColor forState:UIControlStateNormal];

    [_addSiriBtn addTarget:self action:@selector(buildShortcutInCurrentViewController) forControlEvents:UIControlEventTouchUpInside];

    [self.view addSubview:_addSiriBtn];

    // Do any additional setup after loading the view.

-(void)buildShortcutInCurrentViewController

{

self.testIntent = [[SiriIntent alloc] init];           

// self.testIntent.suggestedInvocationPhrase = @"";

self.testIntent.name = @"张冲冲";


self.interaction = [[INInteraction alloc] initWithIntent:self.testIntent response:nil];
[self.interaction donateInteractionWithCompletion:^(NSError * _Nullable error) {
    if(error)
    {
        NSLog(@"%@",error);
    }
    else
    {
        NSLog(@"donate success");
    }
}];

if (@available(iOS 12.0, *)) {
       [[INVoiceShortcutCenter sharedCenter] getAllVoiceShortcutsWithCompletion:^(NSArray<INVoiceShortcut *> * _Nullable voiceShortcuts, NSError * _Nullable error) {
           
           dispatch_async(dispatch_get_main_queue(), ^{
               BOOL tempAddedShortcut = NO;
               for (INVoiceShortcut *voiceShortcut in voiceShortcuts) {
                   NSLog(@"voiceShortcut.identifier = %@",voiceShortcut.identifier);
                   NSLog(@"voiceShortcut.invocationPhrase = %@",voiceShortcut.invocationPhrase);
                   NSLog(@"voiceShortcut.shortcut = %@",voiceShortcut.shortcut.userActivity.title);
                   NSLog(@"voiceShortcut.shortcut = %@",voiceShortcut.shortcut.userActivity.userInfo);

                   
                   if ([voiceShortcut.shortcut.intent isKindOfClass:[SiriIntent class]]) {
                       tempAddedShortcut = YES;           

// break;

}
               }
                if (tempAddedShortcut) {
                    
                   INUIEditVoiceShortcutViewController *editVoiceShortcutViewController = [[INUIEditVoiceShortcutViewController alloc] initWithVoiceShortcut:voiceShortcuts[0]];
                   editVoiceShortcutViewController.delegate = self;
                   [self presentViewController:editVoiceShortcutViewController animated:YES completion:nil];
               } else {
                  INShortcut *shortCut = [[INShortcut alloc] initWithIntent:self.testIntent];
                    
                      self.customShortCutViewController = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortCut];
                       self.customShortCutViewController.delegate = self;
                      [self presentViewController:self.customShortCutViewController animated:YES completion:nil];
               }
           });
       }];
   }           

-(void)addVoiceShortcutViewControllerDidCancel:(INUIAddVoiceShortcutViewController *)controller

[controller dismissViewControllerAnimated:YES completion:nil];           

-(void)addVoiceShortcutViewController:(INUIAddVoiceShortcutViewController )controller didFinishWithVoiceShortcut:(INVoiceShortcut )voiceShortcut error:(NSError *)error

[controller dismissViewControllerAnimated:YES completion:nil];           
  • (void)editVoiceShortcutViewController:(INUIEditVoiceShortcutViewController )controller didUpdateVoiceShortcut:(nullable INVoiceShortcut )voiceShortcut error:(nullable NSError *)error{

    [controller dismissViewControllerAnimated:YES completion:nil];

/*!

@abstract Called if the user deletes the voice shortcut.

@discussion Your implementation of this method should dismiss the view controller.

*/

  • (void)editVoiceShortcutViewController:(INUIEditVoiceShortcutViewController )controller didDeleteVoiceShortcutWithIdentifier:(NSUUID )deletedVoiceShortcutIdentifier{

*/

  • (void)editVoiceShortcutViewControllerDidCancel:(INUIEditVoiceShortcutViewController *)controller{

这一小部分可以判断本地是否已经添加了快捷方式,如果添加就需要进入编辑页面,如果没有添加进入到添加页面

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

dispatch_async(dispatch_get_main_queue(), ^{
               BOOL tempAddedShortcut = NO;
               for (INVoiceShortcut *voiceShortcut in voiceShortcuts) {
                   NSLog(@"voiceShortcut.identifier = %@",voiceShortcut.identifier);
                   NSLog(@"voiceShortcut.invocationPhrase = %@",voiceShortcut.invocationPhrase);
                   NSLog(@"voiceShortcut.shortcut = %@",voiceShortcut.shortcut.userActivity.title);
                   NSLog(@"voiceShortcut.shortcut = %@",voiceShortcut.shortcut.userActivity.userInfo);

                   
                   if ([voiceShortcut.shortcut.intent isKindOfClass:[SiriIntent class]]) {
                       tempAddedShortcut = YES;           
}
               }
                if (tempAddedShortcut) {
                    
                   INUIEditVoiceShortcutViewController *editVoiceShortcutViewController = [[INUIEditVoiceShortcutViewController alloc] initWithVoiceShortcut:voiceShortcuts[0]];
                   editVoiceShortcutViewController.delegate = self;
                   [self presentViewController:editVoiceShortcutViewController animated:YES completion:nil];
               } else {
                  INShortcut *shortCut = [[INShortcut alloc] initWithIntent:self.testIntent];
                    
                      self.customShortCutViewController = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortCut];
                       self.customShortCutViewController.delegate = self;
                      [self presentViewController:self.customShortCutViewController animated:YES completion:nil];
               }
           });           

最重要的一点 开启siri权限,而且需要具有开发者证书才可以开始siri,自己的没有缴费的开发者证书是开启不了的

,然后在主项目的info.list中添加

Privacy - Siri Usage Description 权限

继续阅读