iOS快捷指令集成方式

一预侯、自己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類文件有三個屬性invocationPhraseshortcut琅关、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

siriExtension.png

Next后添上extension的名稱并把UI Extension選項取消勾選敞嗡,如果是多target項目注意該extension關(guān)聯(lián)的target別選錯
image.png

新建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)建箕肃,名稱隨便取一般項目中只有一個

image.png

在意圖文件中添加一條新的意圖婚脱,選擇New Intent
image.png

起意圖的名字修改意圖的描述文案取消Intent is eligible for Siri Suggestions打鉤

image.png

注意: 該意圖的名字會在喚起的時候被喜歡加上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ū)分指令

圖示如下:

IMG_5425.PNG
IMG_5426.PNG
IMG_5427.PNG
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末篮洁,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子殃姓,更是在濱河造成了極大的恐慌袁波,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,807評論 6 518
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件蜗侈,死亡現(xiàn)場離奇詭異篷牌,居然都是意外死亡,警方通過查閱死者的電腦和手機踏幻,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,284評論 3 399
  • 文/潘曉璐 我一進店門枷颊,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人该面,你說我怎么就攤上這事偷卧。” “怎么了吆倦?”我有些...
    開封第一講書人閱讀 169,589評論 0 363
  • 文/不壞的土叔 我叫張陵听诸,是天一觀的道長。 經(jīng)常有香客問我蚕泽,道長晌梨,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 60,188評論 1 300
  • 正文 為了忘掉前任须妻,我火速辦了婚禮仔蝌,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘荒吏。我一直安慰自己敛惊,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 69,185評論 6 398
  • 文/花漫 我一把揭開白布绰更。 她就那樣靜靜地躺著瞧挤,像睡著了一般锡宋。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上特恬,一...
    開封第一講書人閱讀 52,785評論 1 314
  • 那天执俩,我揣著相機與錄音,去河邊找鬼癌刽。 笑死役首,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的显拜。 我是一名探鬼主播衡奥,決...
    沈念sama閱讀 41,220評論 3 423
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼远荠!你這毒婦竟也來了矮固?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 40,167評論 0 277
  • 序言:老撾萬榮一對情侶失蹤矮台,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后根时,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體瘦赫,經(jīng)...
    沈念sama閱讀 46,698評論 1 320
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,767評論 3 343
  • 正文 我和宋清朗相戀三年蛤迎,在試婚紗的時候發(fā)現(xiàn)自己被綠了确虱。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,912評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡替裆,死狀恐怖校辩,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情辆童,我是刑警寧澤宜咒,帶...
    沈念sama閱讀 36,572評論 5 351
  • 正文 年R本政府宣布,位于F島的核電站把鉴,受9級特大地震影響故黑,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜庭砍,卻給世界環(huán)境...
    茶點故事閱讀 42,254評論 3 336
  • 文/蒙蒙 一场晶、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧怠缸,春花似錦诗轻、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,746評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽吏颖。三九已至,卻和暖如春鞠柄,著一層夾襖步出監(jiān)牢的瞬間侦高,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,859評論 1 274
  • 我被黑心中介騙來泰國打工厌杜, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留奉呛,地道東北人。 一個月前我還...
    沈念sama閱讀 49,359評論 3 379
  • 正文 我出身青樓夯尽,卻偏偏與公主長得像瞧壮,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子匙握,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,922評論 2 361

推薦閱讀更多精彩內(nèi)容

  • iOS12 最新系統(tǒng)咆槽,可以使用Siri捷徑了,現(xiàn)將創(chuàng)建步驟記錄如下 先看一下效果吧圈纺。GitHub地址 1 創(chuàng)建Cu...
    霧靄天涯閱讀 2,250評論 0 0
  • Siri介紹 Siri是一款蘋果 iOS 系統(tǒng)提供的智能語音助手軟件秦忿,它的全名是Speech Interpreta...
    林神_iOS閱讀 2,241評論 0 0
  • 我是黑夜里大雨紛飛的人啊 1 “又到一年六月,有人笑有人哭蛾娶,有人歡樂有人憂愁灯谣,有人驚喜有人失落,有的覺得收獲滿滿有...
    陌忘宇閱讀 8,547評論 28 53
  • 信任包括信任自己和信任他人 很多時候蛔琅,很多事情胎许,失敗、遺憾罗售、錯過辜窑,源于不自信,不信任他人 覺得自己做不成寨躁,別人做不...
    吳氵晃閱讀 6,195評論 4 8
  • 步驟:發(fā)微博01-導(dǎo)航欄內(nèi)容 -> 發(fā)微博02-自定義TextView -> 發(fā)微博03-完善TextView和...
    dibadalu閱讀 3,142評論 1 3