一预侯、自己APP添加可由siri喚起的快捷指令
- 首先導(dǎo)入三個系統(tǒng)庫
#import <Intents/Intents.h>
#import <IntentsUI/IntentsUI.h>
#import <CoreSpotlight/CoreSpotlight.h>
- 需要遵循兩個協(xié)議并實現(xiàn)其對應(yīng)的方法
INUIAddVoiceShortcutViewControllerDelegate
INUIEditVoiceShortcutViewControllerDelegate
這兩個協(xié)議分別代表了新增shortcut時彈出的頁面對應(yīng)操作以及編輯已添加shortcut時彈出的頁面對應(yīng)的操作
其對應(yīng)的協(xié)議方法為:
#pragma mark - INUIAddVoiceShortcutViewControllerDelegate
- (void)addVoiceShortcutViewController:(INUIAddVoiceShortcutViewController *)controller didFinishWithVoiceShortcut:(nullable INVoiceShortcut *)voiceShortcut error:(nullable NSError *)error API_AVAILABLE(ios(12.0))
{
}
- (void)addVoiceShortcutViewControllerDidCancel:(INUIAddVoiceShortcutViewController *)controller API_AVAILABLE(ios(12.0))
{
}
#pragma mark- INUIEditVoiceShortcutViewControllerDelegate
- (void)editVoiceShortcutViewController:(INUIEditVoiceShortcutViewController *)controller didUpdateVoiceShortcut:(nullable INVoiceShortcut *)voiceShortcut error:(nullable NSError *)error API_AVAILABLE(ios(12.0))
{
}
- (void)editVoiceShortcutViewController:(INUIEditVoiceShortcutViewController *)controller didDeleteVoiceShortcutWithIdentifier:(NSUUID *)deletedVoiceShortcutIdentifier API_AVAILABLE(ios(12.0))
{
}
- (void)editVoiceShortcutViewControllerDidCancel:(INUIEditVoiceShortcutViewController *)controller
{
}
由于shortcut功能為iOS12以上才可以用的尽爆,因此在集成該功能時需要做系統(tǒng)版本判斷
if (@available(iOS 12.0, *))
1.新增
在添加快捷指令之前,需要先遍歷已經(jīng)存在的指令集合勤揩,確認(rèn)想要添加的指令并沒有被添加,用以下方法可以獲取到所以已添加的shortcut
[[INVoiceShortcutCenter sharedCenter] getAllVoiceShortcutsWithCompletion:^(NSArray<INVoiceShortcut *> * _Nullable voiceShortcuts, NSError * _Nullable error) {}];
查看INVoiceShortcut
類文件有三個屬性invocationPhrase
、shortcut
琅关、identifier
前兩個分別表示指令的命令文案
啦租、捷徑對象(INShortcut
類),該對象中擁有兩個重要的屬性intent
哗伯、userActivity
前者后面第二部分內(nèi)容再講,后者中的activityType
篷角、title
屬性分別代表我們進行辨別快捷指令的id以及可由用戶編輯的命令文案
焊刹。
將想要添加的userActivity
在指令集合中遍歷對應(yīng)的voiceShortcut.shortcut.userActivity.activityType
所有都不相同,則可以配置新指令內(nèi)容進行添加
if (!isExist)
{
NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:activityType];
userActivity.title = defaultCommand;
userActivity.eligibleForSearch = YES;
if (@available(iOS 12.0, *))
{
userActivity.eligibleForPrediction = YES;
userActivity.suggestedInvocationPhrase = editableCommand;
}
CSSearchableItemAttributeSet *attributes = [[CSSearchableItemAttributeSet alloc] init];
if (thumbnailData) attributes.thumbnailData = thumbnailData;
attributes.contentDescription = editableCommand;
userActivity.contentAttributeSet = attributes;
dispatch_async(dispatch_get_main_queue(), ^{
// UI更新代碼
INShortcut *shortCuts = [[INShortcut alloc] initWithUserActivity:userActivity];
INUIAddVoiceShortcutViewController *addvc = [[INUIAddVoiceShortcutViewController alloc] initWithShortcut:shortCuts];
addvc.delegate = self;
self.addShortcutCompletion = completion;
self.defaultTitle = [self defaultTitleOfActivityType:activityType];
[[UIViewController sy_TopViewController] presentViewController:addvc animated:YES completion:^{
NSLog(@"跳往設(shè)置語音界面恳蹲!");
}];
});
}
2.編輯
編輯已存在的快捷指令時虐块,同樣需要先遍歷一遍已存在指令集合,找到與指定userActivity
一致的那一項開始調(diào)起編輯頁面
// 獲取已注冊的voiceShortcuts
[[INVoiceShortcutCenter sharedCenter] getAllVoiceShortcutsWithCompletion:^(NSArray<INVoiceShortcut *> * _Nullable voiceShortcuts, NSError * _Nullable error) {
for (int i = 0; i < voiceShortcuts.count; i++)
{
INVoiceShortcut *voiceShortcut = voiceShortcuts[i];
self.lastTitle = voiceShortcut.invocationPhrase;
self.defaultTitle = [self defaultTitleOfActivityType:activityType];
if ([voiceShortcut.shortcut.userActivity.activityType isEqualToString:activityType])
{
[self jumpToSiriEditViewControllerWithVoiceShortcut:voiceShortcut];break;
}
else if (voiceShortcut.shortcut.intent && [activityType isEqualToString:NSStringFromClass([voiceShortcut.shortcut.intent class])])
{
[self jumpToSiriEditViewControllerWithVoiceShortcut:voiceShortcut];break;
}
}
}];
/// 跳轉(zhuǎn)到編輯頁面
- (void)jumpToSiriEditViewControllerWithVoiceShortcut:(INVoiceShortcut *)voiceShortcut
API_AVAILABLE(ios(12.0)){
dispatch_async(dispatch_get_main_queue(), ^{
INUIEditVoiceShortcutViewController *editVC = [[INUIEditVoiceShortcutViewController alloc] initWithVoiceShortcut:voiceShortcut];
editVC.delegate = self;
[[UIViewController sy_TopViewController] presentViewController:editVC animated:YES completion:^{
NSLog(@"跳往設(shè)置語音界面嘉蕾!");
}];
});
}
二非凌、在快捷指令應(yīng)用中添加綁定自己APP的快捷指令
該階段的目的
: 使自己在應(yīng)用代碼中添加的快捷指令可以與快捷指令app中添加的命令一一對應(yīng)起來,并且可以在快捷指令app新增指令時可選擇app列表中顯示自己的app
如何將自己的app放到快捷指令app的列表中呢荆针?需要新增一個extension
操作步驟為File->Target->iOS->Intents Extension
點
Next
后添上extension
的名稱并把UI Extension
選項取消勾選
敞嗡,如果是多target項目
注意該extension關(guān)聯(lián)的target別選錯新建extension
完成后配置好Bundle identifier
颁糟,并在關(guān)聯(lián)的target
中添加一個group
項,該group項需要在開發(fā)者賬號中進行配置
喉悴,配置好后將對應(yīng)的描述文件下載下來安裝好就行了棱貌,注意:添加group時需要在xcode登錄開發(fā)者賬號
接下來需要新建一個意圖文件
,步驟為: File->File->搜索siri
找到名為SiriKit Intent Definition File
的文件點擊創(chuàng)建箕肃,名稱隨便取一般項目中只有一個
在意圖文件中添加一條新的意圖婚脱,選擇
New Intent
起意圖的名字修改意圖的描述文案取消Intent is eligible for Siri Suggestions打鉤
注意: 該意圖的名字會在喚起的時候被喜歡加上Intent后綴作為activityType傳入應(yīng)用,例:意圖名為SYSiriShortcutSearch, 則activityType為SYSiriShortcutSearchIntent
當(dāng)做完這些之后勺像,就可以在系統(tǒng)的快捷指令應(yīng)用中找到自己的app了障贸,并且添加的意圖也可以在下一步功能列表中找到。
最后需要注意一點:
快捷指令應(yīng)用中同一條指令可以添加多個功能項
吟宦,在喚起
該指令的時候會先后一個個的調(diào)起application:continueUserActivity:restorationHandler:
方法(配置了UniversalLink的情況)并傳入userActivity.activityType
用以區(qū)分指令
圖示如下: