iOS10 UserNotifications用法总结

作者: zziazm | 来源:发表于2018-02-08 16:40 被阅读102次

下面的代码都可以在demo里找到。
为了能够简单地测试远程推送，一般我们都会用一些方便发送通知的工具，Knuff 就是其中之一。

knuff

新建一个工程，在工程里打开Capabilities里的Push Notifications开关。（这个开关不打开无法获取device token）

- (void)registerNotification{
    if (NSClassFromString(@"UNUserNotificationCenter")) {
        //请求使用本地和远程通知的权限
        [[UNUserNotificationCenter currentNotificationCenter] requestAuthorizationWithOptions:UNAuthorizationOptionBadge | UNAuthorizationOptionAlert | UNAuthorizationOptionSound completionHandler:^(BOOL granted, NSError * _Nullable error) {
            if (granted) {
                dispatch_async(dispatch_get_main_queue(), ^{
                    [[UIApplication sharedApplication] registerForRemoteNotifications];
                });
            }
        }];
    }
}

当App第一次调用requestAuthorizationWithOptions这个方法时，会出现上面的弹框，无论用户选择允许或不允许，之后再调用这个方法，都不会再出现这个弹框了。如果用户选择了不允许，之后只能通过系统的设置为App打开通知功能。

UIApplication调用这个registerForRemoteNotifications方法后，AppDelegate会调用代理方发didRegisterForRemoteNotificationsWithDeviceToken,可以获取到deviceToken。获取得到的 deviceToken 是一个 Data 类型，为了方便使用和传递，我们一般会选择将它转换为一个字符串。

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    NSString *token = [[deviceToken description] stringByTrimmingCharactersInSet: [NSCharacterSet characterSetWithCharactersInString:@"<>"]];
    token = [token stringByReplacingOccurrencesOfString:@" " withString:@""];
    NSLog(@"content---%@", token);
}

你可以对用户设置的推送权限进行检查：

[[UNUserNotificationCenter currentNotificationCenter] getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
        
 }];

发送一个本地通知：

// 1. 创建通知内容
    UNMutableNotificationContent *content = [UNMutableNotificationContent new];
    content.title = @"Time Interval Notification";
    content.body = @"My first notification";
    content.sound = [UNNotificationSound defaultSound];
    
    // 2. 创建发送触发
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:false];
    
    // 3. 发送请求标识符
    NSString *requestIdentifier = @"com.test.usernotification.myFirstNotification";
    
    // 4. 创建一个发送请求
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifier content:content trigger:trigger];
    
    //将请求添加到发送中心
    [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        if (!error) {
            NSLog(@"Time Interval Notification scheduled: %@", requestIdentifier);
        }
    }];

上面的这种触发器是只对本地通知而言的，远程推送的通知的话默认会在收到后立即显示。现在 UserNotifications 框架中提供了三种触发器，分别是：

UNTimeIntervalNotificationTrigger：在一定时间后触发；
UNCalendarNotificationTrigger：在某月某日某时触发；
UNLocationNotificationTrigger：在用户进入或是离开某个区域时触发。

iOS10中通知不仅支持简单的一行文字，你可以添加title和subtitle。

对于远程推送，iOS10之前一般只含有消息的推送payload是这样的：

{
   "aps":{
     "alert":"Test",
     "sound":"default",
     "badge":1
   }
 }

如果我们想要加入title和subtitle的话，则需要将alert从字符串转换为字典，新的payload是：

 {
   "aps":{
     "alert":{
       "title":"I am title",
       "subtitle":"I am subtitle",
       "body":"I am body"
     },
     "sound":"default",
     "badge":1
   }
 }

好消息是，后一种字典的方法其实在iOS8.2的时候就已经存在了，虽然当时title只能用在Apple Watch上，但是设置好body的话在iOS上也是可以显示的，所以针对iOS10添加标题时是可以保证向前兼容的。

使用knuff测试一下远程推送（远程推送必须在真机上测试）：

使用knuff发送推送

收到的远程推送

应用内展示通知

上面的例子当应用在前台时不会显示通知的，如果我们希望应用在前台时也能显示通知，需要额外的工作。
UNUserNotificationCenterDelegate提供了两个代理方法：

- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
        completionHandler(UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
  //如果不想在前台展示通知，可以直接传递UNNotificationPresentationOptionNone
 //completionHandler(UNNotificationPresentationOptionNone);

   }

当App在前台收到通知时，无论是本地还是远程通知，都会调用这个方法。如果你实现了这个方法，就要在这个方法里使用completionHandler这个block。这个block要传递一个UNNotificationPresentationOptions参数，它决定了App在前台展示通知的展示形式。如果你不想App在前台展示通知，可以传递UNNotificationPresentationOptionNone。

Actionable 通知发送和处理

注册一个Category

iOS8和9引入了可交互的通知，通过将一簇action放到category中，然后将这个category注册到UNUserNotificationCenter，最后在发送通知时将你的通知的category设置成你注册的category即可。

    UNNotificationCategory * (^saySomethingCategory)(void) = ^(){
        UNTextInputNotificationAction * inputAction = [UNTextInputNotificationAction actionWithIdentifier:@"input" title:@"Input" options:UNNotificationActionOptionForeground textInputButtonTitle:@"发送" textInputPlaceholder:@"说点什么"];
        UNNotificationAction * goodByeAction = [UNNotificationAction actionWithIdentifier:@"goodbye" title:@"Good bye" options:UNNotificationActionOptionForeground];
        UNNotificationAction * cancelAction = [UNNotificationAction actionWithIdentifier:@"none" title:@"Cancel" options:UNNotificationActionOptionDestructive];
        
        
       return [UNNotificationCategory categoryWithIdentifier:@"saySomething" actions:@[inputAction, goodByeAction, cancelAction] intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
    };
    
    UNNotificationCategory * (^customUICategory)(void) = ^(){
        UNNotificationAction *nextAction = [UNNotificationAction actionWithIdentifier:@"switch" title:@"Switch" options:UNNotificationActionOptionNone];
        
        UNNotificationAction *openAction = [UNNotificationAction actionWithIdentifier:@"open" title:@"Open" options:UNNotificationActionOptionForeground];
        
        UNNotificationAction *dismissAction = [UNNotificationAction actionWithIdentifier:@"dismiss" title:@"Dismiss" options:UNNotificationActionOptionDestructive];
        return [UNNotificationCategory categoryWithIdentifier:@"customUI" actions:@[nextAction, openAction, dismissAction] intentIdentifiers:@[] options:UNNotificationCategoryOptionNone];
    };
    
    [[UNUserNotificationCenter  currentNotificationCenter] setNotificationCategories:[NSSet setWithObjects:saySomethingCategory(), customUICategory(), nil]];

上面的代码是将一些action放入到了category中，并将category注册到了UNUserNotificationCenter。
注册完category后，发送一个actionable通知就很简单了，只需要在使用UNNotificationContent
时把它的属性categoryIdentifier设置为我们在上面的代码中注册category使用的Id即可。

    UNMutableNotificationContent *content = [UNMutableNotificationContent new];
    content.body = @"说些什么吧";
    content.categoryIdentifier = @"saySomething";
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:false];
    NSString *requestIdentifier = @"actionable";
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifier content:content trigger:trigger];
    [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        if (!error) {
            
        }
    }];

1311714-8e40c834e0717285.PNG

远程推送使用category

远程推送也可以使用category，只需要在payload中添加category字段，并且把它设置为注册过的category即可:

{
  "aps":{
    "alert":"Please say something",
    "category":"saySomething"
  }
}

处理 actionable 通知

处理上面的action后,App会调用UNUserNotificationCenterDelegate的另一个代理方法。我们可以根据request中包含的categoryIdentifier和response中包含的actionIdentifier就可以判定是哪个通知的哪个action被用户操作了。对于UNTextInputNotificationAction出发的response
，把UNNotificationResponse强转成UNTextInputNotificationResponse就可以拿到用户输入的文本了。

- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler {
    NSString *categoryId = response.notification.request.content.categoryIdentifier;
    if ([categoryId isEqualToString:@"saySomething"]) {
        [self handleSaySomthing:response];
    }
    
}

#pragma mark -- Private

- (void)handleSaySomthing:(UNNotificationResponse *)response{
    NSString *actionId = response.actionIdentifier;
    NSString *text;
    if ([actionId isEqualToString:@"input"]) {
        text = ((UNTextInputNotificationResponse *)response).userText;
    }
    else if ([actionId isEqualToString:@"goodbye"]) {
        text = @"拜拜";
    }
    else if ([actionId isEqualToString:@"none"]) {
        text = @"";
    }
    else {
        text = @"";
    }
    if (text.length > 0) {
        UIAlertView *a = [[UIAlertView alloc] initWithTitle:@"UserText" message:text delegate:nil cancelButtonTitle:@"确定" otherButtonTitles: nil];
        [a show];
    }
    
}

在通知中展示图片/视频

在iOS10中，开发者可以在通知中嵌入图片或者是视频。为本地通知添加多媒体内容十分简单，只需要通过本地磁盘上的文件URL创建一个UNNotificationAttachment对象，然后将这个对象放到数组中赋值给content的attachments属性就行了。

    UNMutableNotificationContent *content = [UNMutableNotificationContent new];
    content.title = @"带图片的通知";
    content.body = @"显示了一张图片";
    NSURL * imageURL = [[NSBundle mainBundle] URLForResource:@"timor" withExtension:@"png"];
    NSError *error;
    UNNotificationAttachment * attachment = [UNNotificationAttachment attachmentWithIdentifier:@"imageAttachment" URL:imageURL options:nil error:&error];
    if (!error) {
        content.attachments = @[attachment];
    }
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:false];
    
    NSString *requestIdentifier = @"media";

    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifier content:content trigger:trigger];
    
    [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        
    }];

1311714-8399570d1c43dc7e.PNG

1311714-68a61290625a6f7b.PNG

除了图片以外，通知还支持音频以及视频，你可以将MP3或者MP4这样的文件提供给系统来在通知中进行展示和播放。不过，这些文件都有尺寸限制，比如图片不能超过10MB，视频不能超过50MB。在创建UNNotificationAttachment时，如果遇到了不支持的格式，SDK会抛出错误。

远程推送也可以带图片和视频，我们会在下面的Notification Extension应用到。

Notification Extension

iOS10中添加了很多extension，作为应用与系统整合的入口。与通知的extension有两个：Service Extension和Content Extension。Service Extension可以让我们在收到远程推送后，修改通知的内容并展示；Content Extension可以让我们自定义通知视图的样式。

创建Notification Extension-1

创建Notification Extension-2

创建Service Extension后，在工程里会多了一个NotificationService文件夹。
NotificationService里已经为我们进行了基本的实现。

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    self.contentHandler = contentHandler;
    NSLog(@"aaaa");
    self.bestAttemptContent = [request.content mutableCopy];
    
    // Modify the notification content here...
    self.bestAttemptContent.body = [NSString stringWithFormat:@"%@ [已经修改了]", self.bestAttemptContent.body];
    
    self.contentHandler(self.bestAttemptContent);
}

- (void)serviceExtensionTimeWillExpire {
    // Called just before the extension will be terminated by the system.
    // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
    self.contentHandler(self.bestAttemptContent);
}

上面的第一个方法在通知准备改变的时候会调用，使用这个方法的contentHandler来传递你需要改变的内容。你可以在这个方法里下载图片或视频添加到通知的内容里，也可以改变alert text。这里有一个30s的时间限制让你来修改通知的内容和执行contentHandler，如果超过了这个时间，系统会调用上面的第二个方法serviceExtensionTimeWillExpire给你最后的机会来执行contentHandler。
Service Extension只对远程推送有效，你可以在推送 payload 中增加一个 mutable-content 值为 1 的项来启用内容修改*：

{
  "aps":{
    "alert":{
      "title":"Service Extension",
      "body":"修改Service Extension"
    },
    "mutable-content":1
  }
}

这个 payload 的推送得到的结果，注意 body 被修改了。

使用本机截取推送内容并修改内容的方式，可以用于提高传输内容的安全性。在服务器推送的payload中使用加密过的文本，在客户端接收到通知后使用预先定义或者获取过的密钥进行解密，然后再显示。

在远程通知中展示图片/视频

一般做法是，在推送的payload中指定需要加载的图片资源地址，这个地址可以使应用bundle内已经存在的资源，也可以是网络的资源。不过因为UNNotificationAttachment只能使用本地的资源，所以如果是网络资源的话，需要先下载在本地。

{
  "aps":{
    "alert":{
      "title":"NotificationService",
      "body":"修改内容",
    },
    "mutable-content":1
  },
  "image": "https://pic2.zhimg.com/80/v2-79c46a8b0a3098e72a0d211975acd46e_hd.jpg"
}

从网络加载图片

自定义通知视图样式

iOS10中新加的另一个Content Extension可以用来自定义通知的详细页面的视图。

Content Extension
新建完之后，在xcode为我们准备的模板包中包含了一个实现了UNNotificationContentExtension协议的控制器，这个协议中有一个必须实现的方法：

- (void)didReceiveNotification:(UNNotification *)notification {

}

当系统需要显示自定义的通知视图时，这个方法会被调用。自定义的UI可以通过这个extension中的MainInterface.storyboard来进行定义。自定义UI的通知是和通知的category绑定的，我们需要在extension的plist文件中指定这个通知的样式所对应的category。

我们在自定义UI时，虽然可以使用包括按钮在内的各种UI控件，但是系统不允许我们对这些控件进行交互，点击通知视图的UI本身会将我们导航到应用中，不过我们可以通过action的方式来对自定义的UI进行更新。UNNotificationContentExtension提供了一个可选的代理方法：

- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response completionHandler:(void (^)(UNNotificationContentExtensionResponseOption option))completion{
    
}

这个方法会在用户点击某个action时调用，你可以在这里更新通知的UI，如果有UI更新，那么在completion这个block中传递UNNotificationContentExtensionResponseOptionDoNotDismiss可以让这个通知继续显示，如果没有必要继续显示，可以传递UNNotificationContentExtensionResponseOptionDismissAndForwardAction，之后app会调用UNUserNotificationCenterDelegate中的didReceiveNotificationResponse:方法。
如果你自定义的UI中包含视频等，你还可以实现UNNotificationContentExtension里的media开头的一系列属性，他将为你提供一些视频播放的控件和相关方法。

取消和更新

在创建通知请求时，我们已经制定了标识符，这标识符可以用来管理通知。

iOS10 UserNotifications用法总结

发送一个本地通知：

应用内展示通知

Actionable 通知发送和处理

注册一个Category

远程推送使用category

处理 actionable 通知

在通知中展示图片/视频

Notification Extension

在远程通知中展示图片/视频

自定义通知视图样式

取消和更新

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读