来源:徐不一样 数组
连接:http://www.jianshu.com/p/3d602a60ca4fapp
虽然这篇文章比较长,也很差理解,可是仍是建议你们收藏,之后用到的时候,能够看看,有耐心的仍是读一读。ide
这篇文章开始,我会跟你们好好讲讲,苹果新发布的iOS10的全部通知类。函数
1、建立本地通知事例详解:测试
注意啊,小伙伴们,本地通知也必须在appdelegate中注册中心,通知的开关打不打开无所谓的,毕竟是本地通知,可是通知的接收的代理,以及通知点击的代理,苹果给合二为一了。因此你们仍是须要在appdelegate中写上这2个方法,还有不要忘记在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions注册通知中心。若是使用极光推送的小伙伴,写看一下个人基础篇,辛苦你们啦ui
建立一个UNNotificationRequest类的实例,必定要为它设置identifier, 在后面的查找,更新, 删除通知,这个标识是能够用来区分这个通知与其余通知
把request加到UNUserNotificationCenter, 并设置触发器,等待触发
若是另外一个request具备和以前request相同的标识,不一样的内容, 能够达到更新通知的目的spa
建立一个本地通知咱们应该先建立一个UNNotificationRequest类,而且将这个类添加到UNUserNotificationCenter才能够。代码以下:线程
// 1.建立一个UNNotificationRequest翻译
NSString *requestIdentifer = @"TestRequest";
UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifer content:content trigger:trigger];
// 2.将UNNotificationRequest类,添加进当前通知中心中
[[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
}];
在建立UNNotificationRequest类时,官方的解释是说,一个通知请求能够在预约经过时间和位置,来通知用户。触发的方式见UNNotificationTrigger的相关说明。调用该方法,在通知触发的时候。会取代具备相同标识符的通知请求,此外,消息个数受系统限制。
上面的翻译,看上去可能有些拗口,简单来讲,就是咱们须要为UNNotificationRequest设置一个标识符,经过标识符,咱们能够对该通知进行添加,删除,更新等操做。
如下是完整的建立通知的代码:
// 1.建立通知内容
UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
content.title = @"徐不一样测试通知";
content.subtitle = @"测试通知";
content.body = @"来自徐不一样的简书";
content.badge = @1;
NSError *error = nil;
NSString *path = [[NSBundle mainBundle] pathForResource:@"icon_certification_status1@2x" ofType:@"png"];
// 2.设置通知附件内容
UNNotificationAttachment *att = [UNNotificationAttachment attachmentWithIdentifier:@"att1" URL:[NSURL fileURLWithPath:path] options:nil error:&error];
if (error) {
NSLog(@"attachment error %@", error);
}
content.attachments = @[att];
content.launchImageName = @"icon_certification_status1@2x";
// 2.设置声音
UNNotificationSound *sound = [UNNotificationSound defaultSound];
content.sound = sound;
// 3.触发模式
UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];
// 4.设置UNNotificationRequest
NSString *requestIdentifer = @"TestRequest";
UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifer content:content trigger:trigger1];
//5.把通知加到UNUserNotificationCenter, 到指定触发点会被触发
[[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
}];
经过以上代码,咱们就能够建立一个5秒触发本地通知,具体样式能够看下图
下拉放大content.launchImageName = @”icon_certification_status1@2x”;显示的图片是这行代码的效果,如图
根据上面内容,你们会发如今建立UNNotificationRequest的时候,会须要UNMutableNotificationContent以及UNTimeIntervalNotificationTrigger这两个类。下面我就对相关的类,以及类扩展,作相应的说明。
1.UNNotificationContent以及UNMutableNotificationContent(通知内容和可变通知内容)
通知内容分为可变的以及不可变的两种类型,相似于可变数组跟不可变数组。后续咱们经过某一特定标识符更新通知,即是用可变通知了。
不论是可变通知仍是不可变通知,都有如下的几个属性:
// 1.附件数组,存放UNNotificationAttachment类
@property (NS_NONATOMIC_IOSONLY, copy) NSArray *attachments ;
// 2.应用程序角标,0或者不传,意味着角标消失
@property (NS_NONATOMIC_IOSONLY, copy, nullable) NSNumber *badge;
// 3.主体内容
@property (NS_NONATOMIC_IOSONLY, copy) NSString *body ;
// 4.app通知下拉预览时候展现的图
@property (NS_NONATOMIC_IOSONLY, copy) NSString *launchImageName;
// 5.UNNotificationSound类,能够设置默认声音,或者指定名称的声音
@property (NS_NONATOMIC_IOSONLY, copy, nullable) UNNotificationSound *sound ;
// 6.推送内容的子标题
@property (NS_NONATOMIC_IOSONLY, copy) NSString *subtitle ;
// 7.通知线程的标识
@property (NS_NONATOMIC_IOSONLY, copy) NSString *threadIdentifier;
// 8.推送内容的标题
@property (NS_NONATOMIC_IOSONLY, copy) NSString *title ;
// 9.远程通知推送内容
@property (NS_NONATOMIC_IOSONLY, copy) NSDictionary *userInfo;
// 10.category标识
@property (NS_NONATOMIC_IOSONLY, copy) NSString *categoryIdentifier;
以上的的属性,我都增长了相应的说明,你们能够对照个人注释来使用。
2.UNNotificationAttachment (附件内容通知)
在UNNotificationContent类中,有个附件数组的属性,这就是包含UNNotificationAttachment类的数组了。
@property (NS_NONATOMIC_IOSONLY, copy) NSArray *attachments ;
苹果的解释说,UNNotificationAttachment(附件通知)是指能够包含音频,图像或视频内容,而且能够将其内容显示出来的通知。使用本地通知时,能够在通知建立时,将附件加入便可。对于远程通知,则必须实现使用UNNotificationServiceExtension类通知服务扩展。
建立附件的方法是attachmentWithIdentifier:URL:options:error:。在使用时,必须指定使用文件附件的内容,而且文件格式必须是支持的类型之一。建立附件后,将其分配给内容对象的附件属性。 (对于远程通知,您必须从您的服务扩展作到这一点。)
附件通知支持的类型以下图:
下面是建立UNNotificationAttachment的方法:
+ (nullable instancetype)attachmentWithIdentifier:(NSString *)identifier URL:(NSURL *)URL options:(nullable NSDictionary *)options error:(NSError *__nullable *__nullable)error;
注意:URL必须是一个有效的文件路径,否则会报错
这里我再在说下options的属性,一共有4种选项(这几个属性可研究死我了)
1UNNotificationAttachmentOptionsTypeHintKey此键的值是一个包含描述文件的类型统一类型标识符(UTI)一个NSString。若是不提供该键,附件的文件扩展名来肯定其类型,经常使用的类型标识符有
kUTTypeImage,kUTTypeJPEG2000,kUTTypeTIFF,kUTTypePICT,kUTTypeGIF ,kUTTypePNG,kUTTypeQuickTimeImage等。看到这里你必定有疑问,这些类型导入报错了啊!!我研究了苹果文档,发现你们须要添加如下框架才能够,具体你们能够经过如下类型来处理。
注意:
框架就是#import
使用方法以下:
dict[UNNotificationAttachmentOptionsTypeHintKey] = (__bridge id _Nullable)(kUTTypeImage);
2UNNotificationAttachmentOptionsThumbnailHiddenKey,是一个BOOL值,为YES时候,缩略图将隐藏,默认为YES。如图:
你们能够对照上面的图来看,就明白是哪里的图消失了。
使用方法以下:
dict[UNNotificationAttachmentOptionsThumbnailHiddenKey] = @YES;
3UNNotificationAttachmentOptionsThumbnailClippingRectKey剪贴矩形的缩略图。这个密钥的值是包含一个归一化的CGRect – 也就是说,一个单元的矩形,其值是在以1.0〜 0.0 ,表示要显示的原始图像的所述部分的字典。例如,指定的(0.25 , 0.25)的原点和大小(0.5 ,0.5 )定义了剪辑矩形,只显示图像的中心部分。使用CGRectCreateDictionaryRepresentation函数来建立字典的矩形。
上面这句话是苹果的翻译,太绕口了。我简单说,就是我下面这幅图。
整张图被分割了,总体比例为1,若是想获得图中阴影面积,就须要写的CGRect(0.5,0.5,0.25,0.25),意思是,从(0.5,0.5)为原点,面积为(0.25,0.25),你们能够理解成,即下面的方法。
使用方法以下:
dict[UNNotificationAttachmentOptionsThumbnailClippingRectKey] = (__bridge id _Nullable)((CGRectCreateDictionaryRepresentation(CGRectMake(0.5, 0.5, 0.25 ,0.25))));;
使用上面的方法,能够获得一张图的阴影部分的图像,这张图像会是通知的缩略图。好比我下面的这个图,缩略图你们应该能够发现变了吧。
这里为了理解,在给你们说几个”坐标点”:
(0,0,0.25,0.25)左上角的最小正方形
(0,0,0.5,0.5) 四分之一的正方形,左上角
(0.5,0.5,0.5,0.5)四分之一的正方形,右下角
(0.5,0,0.5,0.5)四分之一的正方形,左下角
(0.25,0.25,0.5,0.5)最中心的正方形
特别注意:
调试到这里的时候,我感受苹果应该是有个bug,就是我在来回变化这个显示缩略图的frame的时候,来回改,永远显示为第一次写的frame。我在修改UNNotificationRequest的requestIdentifer属性后,能够变换属性。因此我猜想可能相同requestIdentifer的通知,算一个通知,因此只能调用更新的方法,来变化缩略图的吃不腻吧,或许也不是bug。
4UNNotificationAttachmentOptionsThumbnailTimeKey,通常影片附件会用到,指的是用影片中的某一秒来作这个缩略图;
使用方法以下:
dict[UNNotificationAttachmentOptionsThumbnailTimeKey] =@10;
这里咱们能够直接传递一个NSNumber的数值,好比使用影片第10s的画面来作缩略图就按照上面的来写。此外,要注意的是,这个秒数必须是这个影片长度范围内的,否则报错。
3.UNTimeIntervalNotificationTrigger (通知触发模式)
这个我在!(这篇文章中已经初步介绍了,如今我在详细介绍下)[www.baidu.com]这篇文章中已经初步介绍了,如今我在详细介绍下。
1.UNPushNotificationTrigger (远程通知触发)通常咱们不会使用的
2.UNTimeIntervalNotificationTrigger (本地通知) 必定时间以后,重复或者不重复推送通知。咱们能够设置timeInterval(时间间隔)和repeats(是否重复)。
使用方法:
UNTimeIntervalNotificationTrigger *triggerOne = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];
解释:上面的方法是指5秒钟以后执行。repeats这个属性,若是须要为重复执行的,则TimeInterval必须大于60s,不然会报* Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'time interval must be at least 60 if repeating'的错误!**
3.UNCalendarNotificationTrigger(本地通知) 必定日期以后,重复或者不重复推送通知 例如,你天天8点推送一个通知,只须要dateComponents为8。若是你想天天8点都推送这个通知,只要repeats为YES就能够了。
// 周一早上 8:00 上班
NSDateComponents *components = [[NSDateComponents alloc] init];
// 注意,weekday是从周日开始的,若是想设置为从周一开始,你们能够本身想一想~
components.weekday = 2;
components.hour = 8;
UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];
4.UNLocationNotificationTrigger (本地通知)地理位置的一种通知,使用这个通知,你须要导入
#import这个系统类库。示例代码以下:
//一、若是用户进入或者走出某个区域会调用下面两个方法
- (void)locationManager:(CLLocationManager *)manager
didEnterRegion:(CLRegion *)region
- (void)locationManager:(CLLocationManager *)manager
didExitRegion:(CLRegion *)region代理方法反馈相关信息
//二、一到某个经纬度就通知,判断包含某一点么
// 不建议使用!!!!!!CLRegion *region = [[CLRegion alloc] init];// 不建议使用!!!!!!
CLCircularRegion *circlarRegin = [[CLCircularRegion alloc] init];
[circlarRegin containsCoordinate:(CLLocationCoordinate2D)];
UNLocationNotificationTrigger *trigger4 = [UNLocationNotificationTrigger triggerWithRegion:circlarRegin repeats:NO];
注意,这里建议使用CLCircularRegion这个继承自CLRegion的类,由于我看到苹果已经飞起了CLRegion里面是否包含这一点的方法,而且推荐咱们使用CLCircularRegion这个类型