iOS-Siri唤起银行类app (语音转账)

前言

最近公司App要实现下图这样一个功能，对iPhone手机喊 " 嘿，Siri，余额 ”或者 " 嘿，Siri，转账 ” 出现下面的列表，结果列表中展示我们的APP。

列表.png

百度了很久，没有找到这个是什么功能，有大佬指点我到官网查询一下，通过查阅发现官网有一个这样的文档 Adding User Interactivity with Siri Shortcuts and the Shortcuts App ，但是通过查阅配置步骤，貌似感觉讲的像是设置如何捷径，感觉自己这个需求又不像是Siri Shortcuts(捷径)功能。最后有一个朋友给我指点，应该是Siri语音转账类。

image.png

至此，找对了方向开始调研。

步骤：

一、工程基本配置

创建一个普通的xcode工程，然后进行如下配置
1、在工程的 Signing&Capabilities 中，点击 +Capability ，添加Siri

image01.png

image02.png

2、添加siri权限申请
Privacy - Siri Usage Description
使用siriKit，进行快捷转账

image03.png

3、在 AppDelegate 中，导入 #import 头文件，添加如下代码

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    [INPreferences requestSiriAuthorization:^(INSiriAuthorizationStatus status) {
        NSLog(@"%ld", (long)status);
    }];
    
    return YES;
}

此时运行工程，会出现下图申请权限的界面

image04.png

点击好，至此，基本工程配置完毕。

二、添加Siri扩展

1、点击 Xcode -> File -> New -> Target ，选择 iOS -> Intents Extension 。

image05.png

image06.png

image07.png

填写 Product Name 点击 Finish 完成操作, 此时会弹出提示框，选择 Active 。

image08.png

至此，会新增两个 Target ， SiriExtension 和 SiriExtensionUI

image09.png

三、 Target ， `SiriExtension` 和 `SiriExtensionUI` 配置

1、对 SiriExtension -> info.plist -> NSExtension -> NSExtensionAttributes 中的键值对进行调整，调整前和调整后如下所示：

image10.png

调整后为：INSendPaymentIntent

image11.png

2、对 SiriExtensionUI 也进行相同的配置， SiriExtensionUI 只需要配置 IntentsSupported ，调整后如下：

image12.png

调整后为：INSendPaymentIntent

image13.png

基本准备完成，接下来进入代码编写。

四、 SiriExtension 编写代码

1、在SiriExtension目录下，创建一个SiriExtensionIntentHandler : NSObject的类。

image14.png

2、接下来我们编写 SiriExtensionIntentHandler类中的代码

@implementation SiriExtensionIntentHandler

////Resolve - payee 解析收款人 iOS10.0
//- (void)resolvePayeeForSendPayment:(INSendPaymentIntent *)intent withCompletion:(void (^)(INPersonResolutionResult * _Nonnull))completion {
//    if (intent.payee == nil || !intent.payee.displayName.length) {
//        //如果收款人为空，那么请求siri，需要收款人
//        INPersonResolutionResult *resolutionResult = [INPersonResolutionResult notRequired];
//        completion(resolutionResult);
//    }
//    else {
//        //收款人不为空，确认收款人信息
//        INPersonResolutionResult *resolutionResult = [INPersonResolutionResult successWithResolvedPerson:intent.payee];
//        completion(resolutionResult);
//    }
//}

////Resolve - payee 解析收款人 iOS11.0
//- (void)resolvePayeeForSendPayment:(INSendPaymentIntent *)intent completion:(void (^)(INSendPaymentPayeeResolutionResult * _Nonnull))completion  API_AVAILABLE(ios(11.0)){
//    if (intent.payee == nil) {
//        INSendPaymentPayeeResolutionResult *resolutionResult = [INSendPaymentPayeeResolutionResult needsValue];
//        completion(resolutionResult);
//    }
//    else {
//        INSendPaymentPayeeResolutionResult *resolutionResult = [INSendPaymentPayeeResolutionResult successWithResolvedPerson:intent.payee];
//        completion(resolutionResult);
//    }
//}
//

//Resolve - currency 解析货币 iOS10.0
- (void)resolveCurrencyAmountForSendPayment:(INSendPaymentIntent *)intent withCompletion:(void (^)(INCurrencyAmountResolutionResult * _Nonnull))completion {
    INCurrencyAmount *currencyAmount = intent.currencyAmount;
    if (currencyAmount == nil) {
        //金额为空，请求siri，需要转账金额
        INCurrencyAmountResolutionResult *resolutionResult = [INCurrencyAmountResolutionResult needsValue];
        completion(resolutionResult);
    }
    else if ([currencyAmount.currencyCode isEqualToString:@"CNY"]) {
        //如果币种不是人民币，将接收到的币种转化为人民币
        INCurrencyAmount *newCurrencyAmount = [[INCurrencyAmount alloc] initWithAmount:currencyAmount.amount currencyCode:@"CNY"];
        INCurrencyAmountResolutionResult *resolutionResult = [INCurrencyAmountResolutionResult successWithResolvedCurrencyAmount:newCurrencyAmount];
        completion(resolutionResult);
    }
    else {
        INCurrencyAmountResolutionResult *resolutionResult = [INCurrencyAmountResolutionResult successWithResolvedCurrencyAmount:currencyAmount];
        completion(resolutionResult);
    }
}

//Resolve - currency 解析货币单位 iOS11.0
- (void)resolveCurrencyAmountForSendPayment:(INSendPaymentIntent *)intent completion:(void (^)(INSendPaymentCurrencyAmountResolutionResult * _Nonnull))completion  API_AVAILABLE(ios(11.0)){
    INCurrencyAmount *currencyAmount = intent.currencyAmount;
    if (currencyAmount == nil || currencyAmount.amount == nil) {
        INSendPaymentCurrencyAmountResolutionResult *resolutionResult = [INSendPaymentCurrencyAmountResolutionResult needsValue];
        completion(resolutionResult);
    }
    else if (![currencyAmount.currencyCode isEqualToString:@"CNY"]) {
        //货币格式转化为人民币
        INCurrencyAmount *newCurrencyAmount = [[INCurrencyAmount alloc] initWithAmount:currencyAmount.amount currencyCode:@"CNY"];
        INSendPaymentCurrencyAmountResolutionResult *resolutionResult = [INSendPaymentCurrencyAmountResolutionResult successWithResolvedCurrencyAmount:newCurrencyAmount];
        completion(resolutionResult);
    } else {
        INSendPaymentCurrencyAmountResolutionResult *resolutionResult = [INSendPaymentCurrencyAmountResolutionResult successWithResolvedCurrencyAmount:currencyAmount];
        completion(resolutionResult);
    }
}

//Confirm - 确认金额信息
- (void)confirmSendPayment:(INSendPaymentIntent *)intent completion:(void (^)(INSendPaymentIntentResponse * _Nonnull))completion {
    NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:NSStringFromClass([INSendPaymentIntent class])];
    userActivity.title = @"转账";
    userActivity.userInfo = @{@"displayName": intent.payee.displayName?:@"",
                              @"amount": intent.currencyAmount.amount};
    
    //确认支付货币，否则系统会默认展示USD(美元)
    INPaymentMethod *paymentMethod = [INPaymentMethod applePayPaymentMethod];
    //status字段决定了siri转账页面底部的UI
    INPaymentRecord *paymentRecord = [[INPaymentRecord alloc] initWithPayee:intent.payee payer:nil currencyAmount:intent.currencyAmount paymentMethod:paymentMethod note:intent.note status:(INPaymentStatusPending)];
    INSendPaymentIntentResponse *sendPaymentIntentResponse = [[INSendPaymentIntentResponse alloc] initWithCode:(INSendPaymentIntentResponseCodeReady) userActivity:userActivity];
    sendPaymentIntentResponse.paymentRecord = paymentRecord;
    completion(sendPaymentIntentResponse);
}

//Handle - 转账处理
- (void)handleSendPayment:(INSendPaymentIntent *)intent completion:(void (^)(INSendPaymentIntentResponse * _Nonnull))completion {
    NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:NSStringFromClass([INSendPaymentIntent class])];
    userActivity.title = @"转账";
    userActivity.userInfo = @{@"displayName": intent.payee.displayName?:@"",
                              @"amount": intent.currencyAmount.amount};
    INSendPaymentIntentResponse *sendPaymentIntentResponse = [[INSendPaymentIntentResponse alloc] initWithCode:(INSendPaymentIntentResponseCodeInProgress) userActivity:userActivity];
    completion(sendPaymentIntentResponse);
}

@end

3、编写SiriExtensionUI --> IntentViewController 类中代码的实现
3.1 首先编写SiriExtensionUI --> MainInterface.storyboard的UI界面

image15.png

3.2 编写IntentViewController类中代码的实现：

#import "IntentViewController.h"
#import 

@interface IntentViewController ()
@property (weak, nonatomic) IBOutlet UILabel *amountLabel;
@end

@implementation IntentViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view.
}

#pragma mark - INUIHostedViewSiriProviding

- (BOOL)displaysPaymentTransaction {
    return YES;;
}

#pragma mark - INUIHostedViewControlling
- (void)configureWithInteraction:(INInteraction *)interaction context:(INUIHostedViewContext)context completion:(void (^)(CGSize))completion {
    
    if ([interaction.intent isKindOfClass:[INSendPaymentIntent class]] && (interaction.intentHandlingStatus == INIntentHandlingStatusReady)) {
        INSendPaymentIntent *sendPaymentIntent = (INSendPaymentIntent *)interaction.intent;
        self.amountLabel.text = [NSString stringWithFormat:@"￥%.2f", sendPaymentIntent.currencyAmount.amount.doubleValue];
        if (completion) {
            completion(CGSizeMake([self desiredSize].width, 200));
        }
    } else {
        if (completion) {
            completion(CGSizeZero);
        }
    }
}

// Prepare your view controller for the interaction to handle.
- (void)configureViewForParameters:(NSSet  *)parameters ofInteraction:(INInteraction *)interaction interactiveBehavior:(INUIInteractiveBehavior)interactiveBehavior context:(INUIHostedViewContext)context completion:(void (^)(BOOL success, NSSet  *configuredParameters, CGSize desiredSize))completion  API_AVAILABLE(ios(11.0)){
    // Do configuration here, including preparing views and calculating a desired size for presentation.

    if ([interaction.intent isKindOfClass:[INSendPaymentIntent class]] &&
        (interaction.intentHandlingStatus == INIntentHandlingStatusReady) &&
        [[parameters anyObject].parameterKeyPath isEqualToString:@"currencyAmount"]) {
        INSendPaymentIntent *sendPaymentIntent = (INSendPaymentIntent *)interaction.intent;
        self.amountLabel.text = [NSString stringWithFormat:@"￥%.2f", sendPaymentIntent.currencyAmount.amount.doubleValue];
        completion(YES, parameters, CGSizeMake([self desiredSize].width, 200));
    } else {
        completion(YES, parameters, CGSizeZero);
    }
}

- (CGSize)desiredSize {
    return [self extensionContext].hostedViewMaximumAllowedSize;
}

@end

至此，所有代码的编写已经完成，此时我们跑一下真机，可以看到APP已经安装到我们手机，对iPhone手机喊 " 嘿，Siri，余额 ”或者 " 嘿，Siri，转账 ” 出现下面的列表，结果列表中展示我们的APP了。

image16.png

Demo下载

注意：

我们的Demo中有 SiriExtension 和 SiriExtensionUI扩展，所以这两个扩展的bundleID要和主工程保持一样的规范。
例：
主工程bundleID: com.ddq.siriextension
SiriExtension扩展的bundleID: com.ddq.siriextension.SiriExtension
SiriExtensionUI扩展的bundleID: com.ddq.siriextension.SiriExtensionUI
要在主工程的后面，添加对应的点 “.”后缀名。
证书的创建亦是如此：

image.png

2.主工程的bundleID需要开启证书的Siri功能；

image.png

3.如果小伙伴下载我的demo运行报错，需要替换主工程和target为你们自己的bundleID。

iOS-Siri唤起银行类app (语音转账)

前言

步骤：

一、 工程基本配置

二、 添加Siri扩展

三、 Target ， SiriExtension 和 SiriExtensionUI 配置

四、 SiriExtension 编写代码

你可能感兴趣的:(iOS-Siri唤起银行类app (语音转账))

一、工程基本配置

二、添加Siri扩展

三、 Target ， `SiriExtension` 和 `SiriExtensionUI` 配置