具体步骤:
1、修改项目的info.plist文件
添加key:"NSUserActivityTypes"
添加value:类型为"array",用于存储多个"唯一标识符",类型为"string"
例如:
<key>
NSUserActivityTypes
</key>
<array>
<string>
XXXXXX.XXXXXX.SiriShortcuts.SendTask
</string>
</array>
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的效果
步骤2的效果
6、其它
因为已经将此Siri ShortCuts加入了搜索建议,所以在完成语音录制后,搜索语音录制命令,会直接出现在搜索结果下方。
- 对于已经完成设置的Siri ShortCuts,我们可以到设置中进行删除或者语音命令更改。
- 对于此代码,如果已经设置了某个Siri ShortCuts,软件内部不再提示设置,若在设置中删除,则会重新提示。根据自己需求更改相关的判断代码。
- 找到已设置的捷径列表:设置->Siri与搜索->我的捷径
点击上图中需要重新录制语音指令的捷径,则会跳转到语音录制界面;左划,则可删除此捷径。