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 <Intents/Intents.h> 头文件，添加如下代码

- (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 SiriExtensionIntentHandlerResolve - 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转账页面底部的UIINPaymentRecord *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 <Intents/Intents.h>@interface IntentViewController ()<INUIHostedViewSiriProviding>
@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 <INParameter *> *)parameters ofInteraction:(INInteraction *)interaction interactiveBehavior:(INUIInteractiveBehavior)interactiveBehavior context:(INUIHostedViewContext)context completion:(void (^)(BOOL success, NSSet <INParameter *> *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