关于使用 UNUserNotificationCenter 的本地通知

UNUserNotificationCenter是iOS10 推出的新的通知中心 ,最近的项目涉及的比较深,我就总结了一下:

下面我们开始一步一步的来添加本地推送,

1、首先在开始注册通知:

    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
    //监听回调事件
    center.delegate = self;
    //iOS 10 使用以下方法注册,才能得到授权
    [center requestAuthorizationWithOptions:(UNAuthorizationOptionAlert + UNAuthorizationOptionSound +UNAuthorizationOptionBadge)
                          completionHandler:^(BOOL granted, NSError * _Nullable error) {
                              // Enable or disable features based on authorization.
                              
                          }];
    
    //获取当前的通知设置,UNNotificationSettings 是只读对象,不能直接修改,只能通过以下方法获取
    [center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
            }];

我们要首先注册通知中心的代理事件,注册通知,提醒用户获取通知权限:

 - (void)requestAuthorizationWithOptions:(UNAuthorizationOptions)options completionHandler:(void (^)(BOOL granted, NSError *__nullable error))completionHandler;

(1)其中 UNAuthorizationOptions 是授权通知提醒的方式

           UNAuthorizationOptionBa dge;  
           UNAuthorizationOptionSound;  
           UNAuthorizationOptionAlert;  
           UNAuthorizationOptionCarPlay;   

这个根据需要填写。

(2)block中的 BOOL granted 与 NSError *__nullable error  :  
          error 注册失败时错误抛出;
          granted 为YES时得到用户授权,为NO�时授权失败 (用户不允许);

2、创建一个新的通知内容 UNMutableNotificationContent ,我们先了解一下这个类:

// 为通知中附加音频,图片,视频  
@property (NS_NONATOMIC_IOSONLY, copy) NSArray <UNNotificationAttachment *> *attachments 

//控制应用的badge的数量
@property (NS_NONATOMIC_IOSONLY, copy, nullable) NSNumber *badge;

//通知的消息体
@property (NS_NONATOMIC_IOSONLY, copy) NSString *body ;

//在通知代理 中用来识别具体是哪一个通知
@property (NS_NONATOMIC_IOSONLY, copy) NSString 
*categoryIdentifier ;

//通知中有图片时,设置本属性,可以获取下拉图片的大图展示
@property (NS_NONATOMIC_IOSONLY, copy) NSString *launchImageName;

//通知的提示音,可以默认系统的defaultSound ; 也可以加载本地的音频文件(传入音频文件名),这里iOS10中有个BUG, 加载本地音频文件时有时会放不出来
@property (NS_NONATOMIC_IOSONLY, copy, nullable) UNNotificationSound *sound ;

// 通知的副标题
@property (NS_NONATOMIC_IOSONLY, copy) NSString *subtitle ;

//线程标识
@property (NS_NONATOMIC_IOSONLY, copy) NSString *threadIdentifier;

//通知的标题
@property (NS_NONATOMIC_IOSONLY, copy) NSString *title;

//当一个通知发出时携带的信息;(远程时用到)
@property (NS_NONATOMIC_IOSONLY, copy) NSDictionary *userInfo;

下面看一下笔者写的一个方法:

/**
  IOS 10的通知   推送消息 支持的音频 <= 5M(现有的系统偶尔会出现播放不出来的BUG)  图片 <= 10M  视频 <= 50M  ,这些后面都要带上格式;

 @param body 消息内容
 @param promptTone 提示音
 @param soundName 音频
 @param imageName 图片
 @param movieName 视频
 @param identifier 消息标识
 */
-(void)pushNotification_IOS_10_Body:(NSString *)body
                         promptTone:(NSString *)promptTone
                          soundName:(NSString *)soundName
                          imageName:(NSString *)imageName
                          movieName:(NSString *)movieName
                         Identifier:(NSString *)identifier {
     //获取通知中心用来激活新建的通知
    UNUserNotificationCenter * center  = [UNUserNotificationCenter currentNotificationCenter];
    
    UNMutableNotificationContent * content = [[UNMutableNotificationContent alloc]init];
    
    content.body = body;
    //通知的提示音
    if ([promptTone containsString:@"."]) {
        
        UNNotificationSound *sound = [UNNotificationSound soundNamed:promptTone];
        content.sound = sound;
        
    }
    
    __block UNNotificationAttachment *imageAtt;
    __block UNNotificationAttachment *movieAtt;
    __block UNNotificationAttachment *soundAtt;

    if ([imageName containsString:@"."]) {
        
        [self addNotificationAttachmentContent:content attachmentName:imageName options:nil withCompletion:^(NSError *error, UNNotificationAttachment *notificationAtt) {
           
            imageAtt = [notificationAtt copy];
        }];
    }
    
    if ([soundName containsString:@"."]) {
        
        
        [self addNotificationAttachmentContent:content attachmentName:soundName options:nil withCompletion:^(NSError *error, UNNotificationAttachment *notificationAtt) {
            
            soundAtt = [notificationAtt copy];
            
        }];
        
    }
    
    if ([movieName containsString:@"."]) {
        // 在这里截取视频的第10s为视频的缩略图 :UNNotificationAttachmentOptionsThumbnailTimeKey
        [self addNotificationAttachmentContent:content attachmentName:movieName options:@{@"UNNotificationAttachmentOptionsThumbnailTimeKey":@10} withCompletion:^(NSError *error, UNNotificationAttachment *notificationAtt) {
            
            movieAtt = [notificationAtt copy];
            
        }];
        
    }

    NSMutableArray * array = [NSMutableArray array];
//    [array addObject:soundAtt];
//    [array addObject:imageAtt];
    [array addObject:movieAtt];
    
    content.attachments = array;

    //添加通知下拉动作按钮
    NSMutableArray * actionMutableArray = [NSMutableArray array];
    UNNotificationAction * actionA = [UNNotificationAction actionWithIdentifier:@"identifierNeedUnlock" title:@"进入应用" options:UNNotificationActionOptionAuthenticationRequired];
    UNNotificationAction * actionB = [UNNotificationAction actionWithIdentifier:@"identifierRed" title:@"忽略" options:UNNotificationActionOptionDestructive];
    [actionMutableArray addObjectsFromArray:@[actionA,actionB]];
    
    if (actionMutableArray.count > 1) {
        
        UNNotificationCategory * category = [UNNotificationCategory categoryWithIdentifier:@"categoryNoOperationAction" actions:actionMutableArray intentIdentifiers:@[] options:UNNotificationCategoryOptionCustomDismissAction];
        [center setNotificationCategories:[NSSet setWithObjects:category, nil]];
        content.categoryIdentifier = @"categoryNoOperationAction";
    }
    
    //UNTimeIntervalNotificationTrigger   延时推送
    //UNCalendarNotificationTrigger       定时推送
    //UNLocationNotificationTrigger       位置变化推送

    UNTimeIntervalNotificationTrigger * tirgger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:10 repeats:NO];
    
   //建立通知请求
    UNNotificationRequest * request = [UNNotificationRequest requestWithIdentifier:identifier content:content trigger:tirgger];
    
    //将建立的通知请求添加到通知中心
    [center addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        
        NSLog(@"%@本地推送 :( 报错 %@",identifier,error);
        
    }];
}


/**
 增加通知附件

 @param content 通知内容
 @param attachmentName 附件名称
 @param options 相关选项
 @param completion 结果回调
 */
-(void)addNotificationAttachmentContent:(UNMutableNotificationContent *)content attachmentName:(NSString *)attachmentName  options:(NSDictionary *)options withCompletion:(void(^)(NSError * error , UNNotificationAttachment * notificationAtt))completion{
    
    
    NSArray * arr = [attachmentName componentsSeparatedByString:@"."];
    
    NSError * error;
    
    NSString * path = [[NSBundle mainBundle]pathForResource:arr[0] ofType:arr[1]];
    
    UNNotificationAttachment * attachment = [UNNotificationAttachment attachmentWithIdentifier:[NSString stringWithFormat:@"notificationAtt_%@",arr[1]] URL:[NSURL fileURLWithPath:path] options:options error:&error];
    
    if (error) {
        
        NSLog(@"attachment error %@", error);
        
    }
    
    completion(error,attachment);
    //获取通知下拉放大图片
    content.launchImageName = attachmentName;

}

屏幕快照 2017-01-09 17.40.57.png
屏幕快照 2017-01-09 17.40.26.png
屏幕快照 2017-01-10 15.55.26.png

其中通知中的 图片、语音、视频,经过自己测试只能同时添加,只能显示其中一种,这个我还没有搞清楚 。

在创建附件的方法:attachmentWithIdentifier:URL:options:error:中,
(1)URL必须是一个有效地文件路径,
(2)option 是共有4个选项,
UNNotificationAttachmentOptionsTypeHintKey : 如果添加附件的文件名字中没有类型,就要靠该键值来确定文件类型;
UNNotificationAttachmentOptionsThumbnailHiddenKey : 是一个BOOL值,为YES时候,缩略图将隐藏,默认为YES;
UNNotificationAttachmentOptionsThumbnailClippingRectKey : 是一个矩形CGRect 剪贴图片的缩略图的键值;
UNNotificationAttachmentOptionsThumbnailTimeKey : 如果附件是一个视频的话,可以用这值来指定视频中的某一秒为视频的缩略图;

关于通知的我们可以设置它延时提醒,定时提醒(闹钟),位置发生变化提醒:

    UNTimeIntervalNotificationTrigger   延时推送
    UNCalendarNotificationTrigger         定时推送
    UNLocationNotificationTrigger         位置变化推送

(1)关于UNTimeIntervalNotificationTrigger 通知延时设置,注意 :如果 repeats 设置为YES 则延时时间必须大于 60s 否则会 crash;
(2)UNCalendarNotificationTrigger 使用定时推送 ,通过类NSDateComponents 来设置具体的提醒日期;
(3)UNLocationNotificationTrigger 使用位置变化触发推送,通过类CLRegion 来设置经纬度;

3、通知中的代理事件

//当应用在前台时,收到通知会触发这个代理方法;你可以在这个方法中对应用处于前台时接到通知做一些自己的处理
-(void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler{
    
    completionHandler(UNNotificationPresentationOptionSound + UNNotificationPresentationOptionAlert);
}
//当点击进入应用时触发;
-(void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{
    
    
    completionHandler(UNNotificationPresentationOptionSound + UNNotificationPresentationOptionAlert);
}

这里complitionHandler中参数是UNNotificationPresentationOptions 通知提醒的方式 :

    UNNotificationPresentationOptionBadge ,
    UNNotificationPresentationOptionSound  , 
    UNNotificationPresentationOptionAlert ,

欢迎大家 看过后,对文章做出评价,与指导!关于推送的更多内容我会不断的完善更新。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容