[置顶] iOS10--消息通知的基本使用

官方将通知单独放在了UserNotifications.framework，使用时需要导入框架。
UserNotifications.framework主要类文件：

UNCalendarNotificationTrigger
UNLocationNotificationTrigger
UNMutableNotificationContent
UNNotification
UNNotificationAction
UNNotificationAttachment
UNNotificationCategory
UNNotificationContent
UNNotificationRequest
UNNotificationResponse
UNNotificationServiceExtension
UNNotificationSettings
UNNotificationSound
UNNotificationTrigger
UNPushNotificationTrigger
UNTextInputNotificationAction
UNTextInputNotificationResponse
UNTimeIntervalNotificationTrigger
UNUserNotificationCenter

UNUserNotificationCenter的利用：

• 要求用户授权：
  UNUserNotificationCenter* center = [UNUserNotificationCenter currentNotificationCenter]; // 要求授权 /* UNAuthorizationOptionBadge = (1 << 0), UNAuthorizationOptionSound = (1 << 1), UNAuthorizationOptionAlert = (1 << 2), UNAuthorizationOptionCarPlay = (1 << 3), */ [center requestAuthorizationWithOptions:(UNAuthorizationOptionAlert + UNAuthorizationOptionSound + UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) { }];
  补充：获得授权设置信息
  // 获得通知授权和设置 [center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) { /* UNAuthorizationStatusNotDetermined : 没有做出选择 UNAuthorizationStatusDenied : 用户未授权 UNAuthorizationStatusAuthorized ：用户已授权 */ if (settings.authorizationStatus == UNAuthorizationStatusNotDetermined) { NSLog(@"未选择"); }else if (settings.authorizationStatus == UNAuthorizationStatusDenied){ NSLog(@"未授权"); }else if (settings.authorizationStatus == UNAuthorizationStatusAuthorized){ NSLog(@"已授权"); } }];

• 创建本地通知：

  // 创建1个本地通知 UNMutableNotificationContent *content_1 = [[UNMutableNotificationContent alloc] init]; // 主标题 content_1.title = [NSString localizedUserNotificationStringForKey:@"title" arguments:nil]; // 副标题 content_1.subtitle = [NSString localizedUserNotificationStringForKey:@"subtitle" arguments:nil]; content_1.badge = [NSNumber numberWithInteger:1]; content_1.body = [NSString localizedUserNotificationStringForKey:@"title_message_for_yan" arguments:nil]; content_1.sound = [UNNotificationSound defaultSound]; // 设置触发时间 UNTimeIntervalNotificationTrigger *trigger_1 = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:10 repeats:NO]; // 创建1个发送要求 UNNotificationRequest *request_1 = [UNNotificationRequest requestWithIdentifier:@"my_notification" content:content_1 trigger:trigger_1];

  补充：

  • UserNotifications提供了3种触发器：
    UNTimeIntervalNotificationTrigger ：1定时间后触发 UNCalendarNotificationTrigger ： 在某月某日某时触发 UNLocationNotificationTrigger ： 在用户进入或是离开某个区域时触发
  • @“my_notification”要求的标识符可以用来管理通知：
    - 移除还未展现的通知 [center removePendingNotificationRequestsWithIdentifiers: @[@“my_notification” ]]; [center removeAllPendingNotificationRequests]; // - (void)cancelAllLocalNotifications； - 移除已展现过的通知 [center removeDeliveredNotificationsWithIdentifiers:@[@“my_notification” ]]; [center removeAllDeliveredNotifications]; - 获得未展现的通知 [center getPendingNotificationRequestsWithCompletionHandler:^(NSArray<UNNotificationRequest *> * _Nonnull requests) { NSLog(@"%@",requests); }]; - 获得展现过的通知 [center getDeliveredNotificationsWithCompletionHandler:^(NSArray<UNNotification *> * _Nonnull notifications) { NSLog(@"%@",notifications); }];
  • 远程通知的格式：
    { "aps":{ "alert":{ "title":"I am title", "subtitle":"I am subtitle", "body":"I am body" }, "sound":"default", "badge":1 } }
    具体请参考官方文档

• 将通知要求添加到通知中心（UNUserNotificationCenter）：

  [center addNotificationRequest:request_1 withCompletionHandler:^(NSError * _Nullable error) { }];

接收通知

• 处理通知：
  设置UNUserNotificationCenterDelegate：
  注意：UNUserNotificationCenter 的 delegate 必须在 application:willFinishLaunchingWithOptions: or application:didFinishLaunchingWithOptions: 方法中实现；

  center.delegate = self;

  • 利用内展现通知:

    - (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler{ // 如果不想显示某个通知，可以直接用空 options 调用 completionHandler: // completionHandler([]) completionHandler(UNNotificationPresentationOptionBadge + UNNotificationPresentationOptionSound); }
  • 在用户与你推送的通知进行交互时被调用：
    - (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{ completionHandler(); NSLog(@"userInfo--%@",response.notification.request.content.userInfo); }

UNNotificationCategory的利用：

• 创建1个 category：
  /* UNNotificationActionOptionAuthenticationRequired = (1 << 0), UNNotificationActionOptionDestructive = (1 << 1), 取消 UNNotificationActionOptionForeground = (1 << 2), 启动程序 */ UNTextInputNotificationAction *textAction = [UNTextInputNotificationAction actionWithIdentifier:@"my_text" title:@"text_action" options:UNNotificationActionOptionForeground textInputButtonTitle:@"输入" textInputPlaceholder:@"默许文字"]; UNNotificationAction *action = [UNNotificationAction actionWithIdentifier:@"my_action" title:@"action" options:UNNotificationActionOptionDestructive]; UNNotificationAction *action_1 = [UNNotificationAction actionWithIdentifier:@"my_action_1" title:@"action_1" options:UNNotificationActionOptionAuthenticationRequired]; /* UNNotificationCategoryOptionNone = (0), UNNotificationCategoryOptionCustomDismissAction = (1 << 0), UNNotificationCategoryOptionAllowInCarPlay = (2 << 0), */ UNNotificationCategory *category = [UNNotificationCategory categoryWithIdentifier:@"my_category" actions:@[textAction,action,action_1] intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction]; NSSet *setting = [NSSet setWithObjects:category, nil]; [center setNotificationCategories:setting];
• 在创建 UNNotificationContent 时把 categoryIdentifier 设置为需要的 category id 便可：
  content.categoryIdentifier = @"my_category";

  远程推送也能够使用 category，只需要在 payload 中添加 category 字段，并指定预先定义的 category id 就能够了

• 处理category的通知：
  - (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{ completionHandler(); NSLog(@"userInfo--%@",response.notification.request.content.userInfo); // 获得通知中心的所有的Categories [center getNotificationCategoriesWithCompletionHandler:^(NSSet<UNNotificationCategory *> * _Nonnull categories) { for (UNNotificationCategory *category in categories) { if ([category.identifier isEqualToString:@"my_category"] && [response.notification.request.content.categoryIdentifier isEqualToString:@"my_category"]) { for (UNNotificationAction *textAction in category.actions) { if ([textAction.identifier isEqualToString:@"my_text"]) { UNTextInputNotificationAction *text = (UNTextInputNotificationAction *)textAction; UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"提示" message:text.textInputButtonTitle preferredStyle:UIAlertControllerStyleAlert]; [alert addAction:[UIAlertAction actionWithTitle:@"肯定" style:UIAlertActionStyleCancel handler:nil]]; [[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:alert animated:YES completion:nil]; } } } } }]; }

长按 3D touch 效果图

进入利用

iOS 10 中被标为弃用的 API

UILocalNotification
UIMutableUserNotificationAction
UIMutableUserNotificationCategory
UIUserNotificationAction
UIUserNotificationCategory
UIUserNotificationSettings
handleActionWithIdentifier:forLocalNotification:
handleActionWithIdentifier:forRemoteNotification:
didReceiveLocalNotification:withCompletion:
didReceiveRemoteNotification:withCompletion: