iOS10本地通知UserNotifications快速入门

01 Oct, 2016
- IOS ,
- Notification

iOS10更新变动最大的就是通知这部分了，新版通知变得更加统一，使用更加方便，设计更加自由。以前本地通知和远程推送是分开的，虽然这些到了iOS10都合在一起了，但是为了便于理解，我们还是把他俩分开来进行学习。这节我们学习的是本地通知。

以下的用语，如无特别表述，通知就代表本地通知，推送就代表远程服务器的推送。

##快速添加一个通知我们先举个完整的代码例子，大家了解下这个流程，然后分步介绍这几项：

//第一步：注册通知
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    //请求获取通知权限（角标，声音，弹框）
    [center requestAuthorizationWithOptions:(UNAuthorizationOptionBadge | UNAuthorizationOptionSound | UNAuthorizationOptionAlert) completionHandler:^(BOOL granted, NSError * _Nullable error) {
        if (granted) {
            //获取用户是否同意开启通知
            NSLog(@"request authorization successed!");
        }
    }];
    }
    //第二步：新建通知内容对象
    UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init]
    content.title = @"iOS10通知";
    content.subtitle = @"新通知学习笔记";
    content.body = @"新通知变化很大，之前本地通知和远程推送是两个类，现在合成一个了。这是一条测试通知，";
    content.badge = @1;
    UNNotificationSound *sound = [UNNotificationSound soundNamed:@"caodi.m4a"];
    content.sound = sound;

    //第三步：通知触发机制。（重复提醒，时间间隔要大于60s）
    UNTimeIntervalNotificationTrigger *trigger1 = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];

    //第四步：创建UNNotificationRequest通知请求对象
    NSString *requertIdentifier = @"RequestIdentifier";
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requertIdentifier content:content trigger:trigger1];

    //第五步：将通知加到通知中心
    [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        NSLog(@"Error:%@",error);

    }];
}

最终效果如下：

通知内容UNMutableNotificationContent

通知内容就是设定通知的一些展示信息，iOS10之后可以设置subtitle。声音的设置需要借助一个新类UNNotificationSound ，通知文件要放到bundle里面。另外在实际的测试过程中发现，添加通知的声音有时候会无效。这应该是iOS10存在的一个bug，删除掉程序，再安装运行就好了。

触发机制UNNotificationTrigger

Trigger是新加入的一个功能，通过此类可设置本地通知触发条件。它一共有一下几种类型： 1、UNPushNotificaitonTrigger 推送服务的Trigger，由系统创建 2、UNTimeIntervalNotificaitonTrigger 时间触发器，可以设置多长时间以后触发，是否重复。如果设置重复，重复时长要大于60s 3、UNCalendarNotificaitonTrigger 日期触发器，可以设置某一日期触发。例如，提醒我每天早上七点起床：

NSDateComponents *components = [[NSDateComponents alloc] init];
components.hour = 7;
components.minute = 0; // components 日期         UNCalendarNotificationTrigger *calendarTrigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];

4、UNLocationNotificaitonTrigger 位置触发器，用于到某一范围之后，触发通知。通过CLRegion设定具体范围。

通知请求UNNotificationRequest

通知请求的构造 + (instancetype)requestWithIdentifier:(NSString *)identifier content:(UNNotificationContent *)content trigger:(nullable UNNotificationTrigger *)trigger; 就是把上面三项连接起来。它有一个参数identifier，这相当于通知的一个身份。iOS10通知支持更新，就是基于此identifier再发一条通知。

通知中心UNUserNotificationCenter

获取通知[UNUserNotificationCenter currentNotificationCenter] 然后通过addNotificaitonRequest:就完成了一个通知的添加。

##扩展通知的内容通知我们已经添加上了，现在我们需要扩展一下通知的内容，给它加一些内容。扩展的内容需要支持3D-touch的手机（6s以上），重压之后全面显示

添加附件

iOS10之前通知的样式不能更改，在iOS10之后引入了UNNotificationationAttachment，可以在通知中添加图片，音频，视频。苹果对这些附件的大小和类型有一个限制：如果我想在通知里加一个图片，可以这样处理：

NSString *imageFile = [[NSBundle mainBundle] pathForResource:@"sport" ofType:@"png"];
UNNotificationAttachment *imageAttachment = [UNNotificationAttachment attachmentWithIdentifier:@"iamgeAttachment" URL:[NSURL fileURLWithPath:imageFile] options:nil error:nil];
content.attachments = @[imageAttachment];//虽然是数组，但是添加多个只能显示第一个
/* add request and notificaiton code ... */

效果如下：

重压之后：

添加交互

//点击可以显示文本输入框
UNTextInputNotificationAction *action1 = [UNTextInputNotificationAction actionWithIdentifier:@"replyAction" title:@"文字回复" options:UNNotificationActionOptionNone];
    //点击进入应用
UNNotificationAction *action2 = [UNNotificationAction actionWithIdentifier:@"enterAction" title:@"进入应用" options:UNNotificationActionOptionForeground];
    //点击取消，没有任何操作
UNNotificationAction *action3 = [UNNotificationAction actionWithIdentifier:@"cancelAction" title:@"取消" options:UNNotificationActionOptionDestructive];
    //通过UNNotificationCategory对象将这几个action行为添加到通知里去
UNNotificationCategory *categroy = [UNNotificationCategory categoryWithIdentifier:@"Categroy" actions:@[action1,action2,action3] intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
    //将categroy赋值到通知内容上
    content.categoryIdentifier = @"Categroy";
    //设置通知代理，用于检测点击方法
[[UNUserNotificationCenter currentNotificationCenter] setDelegate:self];
/* add request and notificaiton code ... */

效果如下：

获取通知交互内容：

//识别通知交互处理的代理方法
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{
    
    NSString *categoryIdentifier = response.notification.request.content.categoryIdentifier;
    
    if ([categoryIdentifier isEqualToString:@"Categroy"]) {
        //识别需要被处理的拓展
        if ([response.actionIdentifier isEqualToString:@"replyAction"]){
            //识别用户点击的是哪个 action
            UNTextInputNotificationResponse *textResponse = (UNTextInputNotificationResponse*)response;
            //获取输入内容
            NSString *userText = textResponse.userText;
            //发送 userText 给需要接收的方法
            NSLog(@"要发送的内容是：%@",userText);
            //[ClassName handleUserText: userText];
        }else if([response.actionIdentifier isEqualToString:@"enterAction"]){
            NSLog(@"点击了进入应用按钮");
        }else{
            NSLog(@"点击了取消");
        }
    }
    completionHandler();
}

由此我们可以知道action，categroy，request这些东西都是通过各自的identifier获取的。这样可以很方便的定位到某一个通知或者action上，为交互的处理提供了很大的便利。##自定义通知样式在Xcode中File->New->Targe会出现下面的视图

Notification Content对应的是通知，Notification Service Extension对应的是推送。我们这里要实现通知的自定义，选择左边那个。创建成功之后会在工程里多一个文件件 NotificationViewController文件是自动生成的，里面有一个 - (void)didReceiveNotification:(UNNotification *)notification 可以在这里定义一些通知的显示。

MainInterface.storyboard文件是控制通知的storyboard文件，可以编辑需要的通知样式。我们设计一下文字的颜色和显示位置

接下来你可能会问，怎么把这个自定义的通知样式应用到当前通知里呢？先别急，我们看下一个文件Info.flist里面的内容

第一项UNNotificationExtensionCategory就是UNNotificationCategory的标示，我们把他换成我们通知里使用的标示"Category"，系统就会自动匹配通知显示的样式。第二项UNNotificationExtensionIntialContentSizeRation初始内容 Size 的比例。也可以在 viewDidLoad 中使用 self.preferredContentSize 直接设置 Size。第三项UNNotificationExtensionDefaultContentHidden是否隐藏默认内容，如果设为YES，默认内容会被隐藏。显示的效果：

##总结至此，iOS通知部分的内容就学完了，参考代码：Demo。参考文档： iOS10 User Notificaitons学习笔记活久见的重构-iOS10 UserNotificaiotns框架解析