Siri Shortcut的OTT應用

摘要

* 介紹 SiriKit
* 介紹 Siri Shortcut
* 如何應用到 OTT app
* 開發經驗分享

細節

在 2018 的 WWDC 中，介紹了新的 SiriKit 應用 Shortcut，在這次的分享中，不但會簡單介紹 SiriKit & Siri Shortcut，並且會介紹實際應用在 OTT 的方式和與如何提升與使用者的互動。

設定的目標聽眾會是想了解最新的 Siri Shortcut 的功能以外，並且想提升活躍使用者數量的 app 開發者。

說明

* 今年最新的 WWDC 所介紹的功能
* 實際應用在有百萬等級以上使用者所使用的 OTT app
* SiriKit & Siri Shortcut 的官方文件較沒有統整性，並且多在歷年的 WWDC 才有詳細資訊，統整過後的資訊對於其他開發者有很大的助益

Transcript

1. Siri Shortcut的OTT應⽤用 @SiriShortcutToOtt
2. ⾃自我介紹 現職偶爾刷存在感的丈夫、 陪⽑毛尼玩的爸爸、剩餘時間 拿來來寫程式的⼯工程師 • Twitter: @marslin_dev • Facebook: marslin1220
3. Aganda • 介紹 SiriKit • 介紹 Siri Shortcut • 如何應⽤用到 OTT app • 開發經驗分享
4. SiriKit
5. – Apple Inc. “SiriKit enables your iOS apps and watchOS apps to work with Siri, so users can get things done using just their voice.”
6. 讓你的使⽤用者更更懶懶惰 !
7. SiriKit • Introduced in 2016 • Use “intent” as user request • Group intents into “domains”
8. Siri Shortcut
9. –Apple Inc. “Siri can now intelligently pair users' daily routines with your apps to suggest convenient shortcuts right when they're needed”
10. 讓你的使⽤用者退化 "
11. “Siri Shortcut” ≠ “Shortcut”
12. Siri Shortcut is just a shortcut of intents
13. Shortcut Advantage • 加速使⽤用者使⽤用app中的重要功能 • 增加使⽤用黏著度 • 隨時可使⽤用
14. Shortcut Features • Siri Suggestion (Prediction + Notification) • Short Invocation Phrase
15. Prediction
17. Notification
21. Create Shortcut Define
22. Create Shortcut Define Donate
23. Create Shortcut Define Donate Handle
24. Define Shortcut
25. 1. Enable Siri capability: “TARGETS” —> “Info” —> “Siri”
 
 
 
 

26. 2. Add NSUserActivityTypes • Use the reverse domain as naming • The name of the intent
 
 
 
 
 
 

27. Donate Shortcut
28. Good Donation • 使⽤用者時常使⽤用的功能 • Donation的內容⼀一致 • 不需要放入timestamp或⽇日期資訊 • 使⽤用者使⽤用功能⼀一次，則donate⼀一次即可
29. The Easiest Way: NSUseractivity
30. Use UserActivity • 開啟app中的⾴頁⾯面 • ⽤用來來顯⽰示Spotlight or Handoff對應的項⽬目，因為已經有 使⽤用UserActivity
31. NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:@"com.chocolabs.dramacrazy-test.dramainfo"]; userActivity.title = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; [userActivity addUserInfoEntriesFromDictionary:@{@"dramaID" : dramaObject.dramaID, @"dramaName" : dramaObject.dramaName, }]; userActivity.needsSave = YES; userActivity.eligibleForSearch = YES; userActivity.eligibleForPrediction = YES; userActivity.persistentIdentifier = @"com.chocolabs.dramacrazy.activity"; userActivity.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; self.userActivity = userActivity;
32. NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:@"com.chocolabs.dramacrazy-test.dramainfo"]; userActivity.title = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; [userActivity addUserInfoEntriesFromDictionary:@{@"dramaID" : dramaObject.dramaID, @"dramaName" : dramaObject.dramaName, }]; userActivity.needsSave = YES; userActivity.eligibleForSearch = YES; userActivity.eligibleForPrediction = YES; userActivity.persistentIdentifier = @"com.chocolabs.dramacrazy.activity"; userActivity.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; self.userActivity = userActivity;
33. NSUserActivity *userActivity = [[NSUserActivity alloc] initWithActivityType:@"com.chocolabs.dramacrazy-test.dramainfo"]; userActivity.title = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; [userActivity addUserInfoEntriesFromDictionary:@{@"dramaID" : dramaObject.dramaID, @"dramaName" : dramaObject.dramaName, }]; userActivity.needsSave = YES; userActivity.eligibleForSearch = YES; userActivity.eligibleForPrediction = YES; userActivity.persistentIdentifier = @"com.chocolabs.dramacrazy.activity"; userActivity.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; self.userActivity = userActivity;
34. suggestedInvocationPhrase
35. suggestedInvocationPhrase • if (@available(iOS 12.0, *)) {…} • #import "Intents/NSUserActivity+IntentsAdditions.h"
36. Handle Shortcut
37. // AppDelegate.m if ([userActivity.activityType isEqualToString:@"com.chocolabs.dramacrazy-test.dramainfo"]) { //… return YES; }
40. The Easy Way: INInteraction
41. Use Interaction • 無須開啟app • 可客製化語⾳音回覆或客製化UI • 更更多的參參數來來作更更精細的預測
42. INImage *artwork = [INImage imageWithURL:[NSURL URLWithString:dramaObject.posterUrlVertical]]; INMediaItem *item = [[INMediaItem alloc] initWithIdentifier:dramaObject.dramaID title:dramaObject.dramaName type:INMediaItemTypeTVShow artwork:artwork]; INPlayMediaIntent *intent = [[INPlayMediaIntent alloc] initWithMediaItems:nil mediaContainer:item playShuffled:@(0) playbackRepeatMode:INPlaybackRepeatModeNone resumePlayback:@(0)]; intent.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName];
43. INImage *artwork = [INImage imageWithURL:[NSURL URLWithString:dramaObject.posterUrlVertical]]; INMediaItem *item = [[INMediaItem alloc] initWithIdentifier:dramaObject.dramaID title:dramaObject.dramaName type:INMediaItemTypeTVShow artwork:artwork]; INPlayMediaIntent *intent = [[INPlayMediaIntent alloc] initWithMediaItems:nil mediaContainer:item playShuffled:@(0) playbackRepeatMode:INPlaybackRepeatModeNone resumePlayback:@(0)]; intent.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName];
44. INInteraction *interaction = [[INInteraction alloc] initWithIntent:intent response:nil]; [interaction donateInteractionWithCompletion:^(NSError * _Nullable error) { if (error) { NSLog(@"donate error: %@", error); } }];
45. The Harder Way: 
 Custom Intent
46. Create Intent Definition
47. • “File” -> “New” -> “File…”
48. Customize System Intent
50. Customize System Intent
52. Intent Naming • Auto fill prefix: CT • Auto fill postfix: Intent
53. Custom Intent
54. Parameters
55. Shortcut Type
56. Import Intent Header #import <Intents/Intents.h> NS_ASSUME_NONNULL_BEGIN API_AVAILABLE(ios(12.0), watchos(5.0)) @interface CTPlayDramaIntent : INIntent @property (readwrite, copy, nullable, nonatomic) NSString *startTime; @property (readwrite, copy, nullable, nonatomic) NSString *episode; @property (readwrite, copy, nullable, nonatomic) NSString *dramaName; @property (readwrite, copy, nullable, nonatomic) NSString *dramaID; @end @class CTPlayDramaIntentResponse;
57. Donate It if (@available(iOS 12.0, *)) { CTPlayDramaIntent *intent = [[CTPlayDramaIntent alloc] init]; intent.dramaID = dramaObject.dramaID; intent.dramaName = dramaObject.dramaName; if (saveHistory) { intent.episode = saveHistory.epsTitle; intent.startTime = saveHistory.offsetTimeString; } intent.suggestedInvocationPhrase = [NSString stringWithFormat:@"播放 %@", dramaObject.dramaName]; INInteraction *interaction = [[INInteraction alloc] initWithIntent:intent response:nil]; [interaction donateInteractionWithCompletion:^(NSError * _Nullable error) { if (error) { NSLog(@"donate error: %@", error); } }]; }
58. Add Shortcut to Siri
63. The Challenge Way: IntentExtension
64. Add IntentExtension Target
65. • “File” -> “New” -> “Target”
66. Define Intents
71. Handle Intent
72. #import "CTDropHistoryIntent.h" #import <Intents/Intents.h> NS_ASSUME_NONNULL_BEGIN @interface CTDropHistoryIntentHandler : NSObject <CTDropHistoryIntentHandling> @end NS_ASSUME_NONNULL_END
73. Confirm & Handle the Intent
74. // CTDropHistoryIntentHandler.m - (void)confirmDropHistory:(CTDropHistoryIntent *)intent completion:(void (^)(CTDropHistoryIntentResponse *_Nonnull))completion API_AVAILABLE(ios(12.0)) { CTDropHistoryIntentResponse *intentResponse = [[CTDropHistoryIntentResponse alloc] initWithCode:CTDropHistoryIntentResponseCodeReady userActivity:nil]; completion(intentResponse); }
75. // CTDropHistoryIntentHandler.m - (void)handleDropHistory:(CTDropHistoryIntent *)intent completion:(void (^) (CTDropHistoryIntentResponse *_Nonnull))completion API_AVAILABLE(ios(12.0)) { [self dropHistoryWithSuccess:^{ CTDropHistoryIntentResponse *intentResponse = [[CTDropHistoryIntentResponse alloc] initWithCode:CTDropHistoryIntentResponseCodeSuccess userActivity:nil]; completion(intentResponse); } failure:^(NSError *error) { CTDropHistoryIntentResponse *intentResponse = [[CTDropHistoryIntentResponse alloc] initWithCode:CTDropHistoryIntentResponseCodeFailure userActivity:nil]; completion(intentResponse); }]; }
76. Assign the Handler
77. // IntentHandler.m @implementation IntentHandler - (id)handlerForIntent:(INIntent *)intent { if ([intent isKindOfClass:[CTDropHistoryIntent class]]) { return [CTDropHistoryIntentHandler new]; } return self; } @end
84. The Crazy Way: IntentUIExtension
85. 504 Timeout 請參參考 2017 WWDC “What's New in SiriKit”
86. Tips
87. Shortcut Testing
88. Shortcut Testing
89. Shortcut Testing
90. Siri Intent Query
91. Siri Intent Query
92. Suggest Siri Suggestion #import "Intents/INShortcut.h" #import “Intents/INVoiceShortcutCenter.h" INShortcut *activityShortcut = [[INShortcut alloc] initWithUserActivity:userActivity]; INShortcut *intentShortcut = [[INShortcut alloc] initWithIntent:intent]; [[INVoiceShortcutCenter sharedCenter] setShortcutSuggestions:@[activityShortcut, intentShortcut]];
93. Q&A
94. Thank You