Using Grouped Notifications

Transcription

1 #WWDC18 Using Grouped Notifications Session 711 Michele Campeotto, ios User Notifications 2018 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.

2 Notification groups App grouping Custom grouping Group summaries

3 Notification Groups

4

5

6

7

8

9

10

11 App Grouping

12

13

14 Custom Grouping

15 // Creating Groups with Thread Identifiers let content = UNMutableNotificationContent() content.title = "Notifications Team" content.body = "WWDC session after party" content.threadidentifier = "notifications-team-chat"

16 // Creating Groups with Thread Identifiers let content = UNMutableNotificationContent() content.title = "Notifications Team" content.body = "WWDC session after party" content.threadidentifier = "notifications-team-chat"

17 // Creating Groups with Thread Identifiers { "aps" : { "alert" : { "title" : "Notifications Team", "body" : "WWDC session after party" } "thread-id" : "notifications-team-chat" } }

18 // Creating Groups with Thread Identifiers { "aps" : { "alert" : { "title" : "Notifications Team", "body" : "WWDC session after party" } "thread-id" : "notifications-team-chat" } }

19 Custom Grouping Examples Calendar Messages Mail

20

21 threadidentifier = nil

22 threadidentifier = "alerts" threadidentifier = nil

23 threadidentifier = "alerts" threadidentifier = nil

24

25 Separate important, actionable notifications from informative updates.

26

27 threadidentifier = "gr-michele"

28 threadidentifier = "gr-michele" threadidentifier = "gr-51413"

29

30 Create groups for meaningful, personal communications.

31

32 threadidentifier = "acct-icloud"

33 threadidentifier = "vip-michele" threadidentifier = "acct-icloud"

34 threadidentifier = "vip-michele" threadidentifier = "acct-icloud" threadidentifier = "th-51413"

35 threadidentifier = "vip-michele" threadidentifier = "acct-icloud" threadidentifier = "th-51413"

36 Respect the user s priorities and organization.

37 Notification Groups Summaries

38

39

40

41

42 // Simple Notification Group Summary let summaryformat = "%u more messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

43 // Simple Notification Group Summary let summaryformat = "%u more messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

44 // Simple Notification Group Summary let summaryformat = "%u more messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

45 // Hidden Previews Summary Customization let summaryformat = "%u more messages" let hiddenpreviewsplaceholder = "%u messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: hiddenpreviewsplaceholder, categorysummaryformat: summaryformat, options: [])

46 // Hidden Previews Summary Customization let summaryformat = "%u more messages" let hiddenpreviewsplaceholder = "%u messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: hiddenpreviewsplaceholder, categorysummaryformat: summaryformat, options: [])

47

48 // Notification Group Summary with Arguments let summaryformat = "%u more messages from %@" return UNNotificationCategory(identifier: "group-messages", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

49 // Notification Group Summary with Arguments let summaryformat = "%u more messages from %@" return UNNotificationCategory(identifier: "group-messages", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

50 // Notification Group Summary with Arguments let summaryformat = "%u more messages from %@" return UNNotificationCategory(identifier: "group-messages", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

51 // Notification Group Summary Argument let content = UNMutableNotificationContent() content.body = " " content.threadidentifier = "notifications-team" content.summaryargument = "Kritarth"

52 // Notification Group Summary Argument let content = UNMutableNotificationContent() content.body = " " content.threadidentifier = "notifications-team" content.summaryargument = "Kritarth"

53 // Notification Group Summary Argument { "aps" : { "alert" : { "body" : " ", "summary-arg" : "Kritarth" }, "thread-id" : "notifications-team" } }

54 // Notification Group Summary Argument { "aps" : { "alert" : { "body" : " ", "summary-arg" : "Kritarth" }, "thread-id" : "notifications-team" } }

55

56

57

58

59

60 // Notification Summary with Argument Count let content = UNMutableNotificationContent() content.body = " " content.threadidentifier = " " content.summaryargument = "Song by Song" content.summaryargumentcount = 3

61 // Notification Summary with Argument Count let content = UNMutableNotificationContent() content.body = " " content.threadidentifier = " " content.summaryargument = "Song by Song" content.summaryargumentcount = 3

62

63

64 // Summary Argument Count { "aps" : { "alert" : { "body" : " ", "summary-arg" : "Song by Song", "summary-arg-count" : 3 }, "thread-id" : "notifications-team" } }

65 // Summary Argument Count { "aps" : { "alert" : { "body" : " ", "summary-arg" : "Song by Song", "summary-arg-count" : 3 }, "thread-id" : "notifications-team" } }

66 Summary Plurals and Localization

67

68

69

70 // Summary Localization let summaryformat = "%u more messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

71 // Summary Localization let summaryformat = "%u more messages" return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

72 // Summary Localization let summaryformat = NSString.localizedUserNotificationString(forKey: "NOTIFICATION_SUMMARY", arguments: nil) return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

73 // Summary Localization let summaryformat = NSString.localizedUserNotificationString(forKey: "NOTIFICATION_SUMMARY", arguments: nil) return UNNotificationCategory(identifier: "category-identifier", actions: [], intentidentifiers: [], hiddenpreviewsbodyplaceholder: nil, categorysummaryformat: summaryformat, options: [])

74 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification</string> <key>other</key> <string>%u more notifications</string> </dict> </dict> </dict> </plist>

75 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification</string> <key>other</key> <string>%u more notifications</string> </dict> </dict> </dict> </plist>

76 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> עדכון אחד< string > < string />עוד <key>two</key> שני עדכונים< string > < string />עוד <key>many</key> עוד< string > u% < string />עדכונים </dict> </dict> </dict> </plist>

77 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> עדכון אחד< string > < string />עוד <key>two</key> שני עדכונים< string > < string />עוד <key>many</key> עוד< string > u% < string />עדכונים </dict> </dict> </dict> </plist>

78 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>еще %u уведомление</string> <key>few</key> <string>еще %u уведомления</string> <key>many</key> <string>еще %u уведомлений</string> </dict> </dict> </dict> </plist>

79 <!-- Summary Localization --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>еще %u уведомление</string> <key>few</key> <string>еще %u уведомления</string> <key>many</key> <string>еще %u уведомлений</string> </dict> </dict> </dict> </plist>

80 <!-- Summary Localization with Arguments --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification from <key>other</key> <string>%u more notifications from </dict> </dict> </dict> </plist>

81 <!-- Summary Localization with Arguments --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification from <key>other</key> <string>%u more notifications from </dict> </dict> </dict> </plist>

82 <!-- Summary Localization with Arguments --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification from <key>other</key> <string>%u more notifications from </dict> </dict> </dict> </plist>

83 <!-- Summary Localization with Arguments --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification from <key>other</key> <string>%u more notifications from </dict> </dict> </dict> </plist>

84 <!-- Summary Localization with Arguments --> <plist version="1.0"> <dict> <key>notification_summary</key> <dict> <key>nsstringlocalizedformatkey</key> <key>notifications</key> <dict> <key>nsstringformatspectypekey</key> <string>nsstringpluralruletype</string> <key>nsstringformatvaluetypekey</key> <string>u</string> <key>one</key> <string>%u more notification from <key>other</key> <string>%u more notifications from </dict> </dict> </dict> </plist>

85 Allowed Notification Summary Formats

86 Allowed Notification Summary Formats Notifications count %u more messages

87 Allowed Notification Summary Formats Notifications count %u more messages Notifications count and arguments %u more messages from

88 Quick Tips

89 Grouping Different Summaries

90 Grouping Different Summaries Simple summaries are joined 5 more messages and 3 more photos

91 Grouping Different Summaries Simple summaries are joined 5 more messages and 3 more photos Summaries with arguments fall back to default 8 more notifications

92 Rich Grouped Notifications Extension receives the leading notification public protocol UNNotificationContentExtension : NSObjectProtocol { public func didreceive(_ notification: UNNotification) }

93 Rich Grouped Notifications Extension receives the leading notification Extension can load other notifications class UNUserNotificationCenter : NSObject { func getdeliverednotifications(completionhandler:([unnotification]) -> Swift.Void) }

94 Rich Grouped Notifications Extension receives the leading notification Extension can load other notifications Threading of additional notifications public protocol UNNotificationContentExtension : NSObjectProtocol { public func didreceive(_ notification: UNNotification) }

95 Rich Grouped Notifications Extension receives the leading notification Extension can load other notifications Threading of additional notifications Remove notifications when read class UNUserNotificationCenter : NSObject { func removedeliverednotifications(withidentifiers identifiers: [String]) }

96 Summary Grouped notifications to help organization Custom summaries to improve clarity

97 More Information Notifications Lab Technology Lab 1 Wednesday 4:00PM Notifications Lab Technology Lab 1 Thursday 9:00AM Designing Notifications Hall 2 Friday 10:00AM

98