iOS_LocalPush_本地推送

iOS10之前本地推送

• 本地推送不需要借助服务器，即可实现推送功能。
  
  • 这个时候需要借助UILocalNotification类进行功能实现
  • 创建本地推送代码实现

// 创建本地推送
- (void)creatLocalPush{
    UILocalNotification *localNotifi = [[UILocalNotification alloc]init];
    // 设置触发时间
    localNotifi.fireDate = [NSDate dateWithTimeIntervalSinceNow:3];
    // 设置时区  以当前手机运行的时区为准
    localNotifi.timeZone = [NSTimeZone defaultTimeZone];
    // 设置推送 显示的内容
    localNotifi.alertTitle = @"推送标题";
    localNotifi.alertBody = @"本地推送内容";
    localNotifi.alertAction = @"alert提示框按钮文本";
    //是否显示额外的按钮，为no时alertAction消失
    localNotifi.hasAction = YES;
    // 设置 icon小红点个数
    localNotifi.applicationIconBadgeNumber = 1;
    // 设置是否重复  重复最小时间间隔为秒，但最好是分钟
    // 不设置此属性，则默认不重复
    localNotifi.repeatInterval =  NSCalendarUnitMinute;
    // 设置推送的声音
    // 通知的声音默认是iOS系统自带的声音，当然也支持自定义，但是自定义必须是固定格式的音频文件，不支持mp3，最常用的是cef/pcm/ma4/alaw格式的音频文件，并且播放时间不能长于30秒，如果长于30秒，将会被系统时间所代替，音频文件必须放在工程文件当中([NSBundle mainBundle])
    localNotifi.soundName = UILocalNotificationDefaultSoundName;

    // 设置推送的区别符
    localNotifi.userInfo = @{@"name":@"loaclPushOne"};
    // 按照前面设置的计划 执行此通知
    [[UIApplication sharedApplication] scheduleLocalNotification:localNotifi];
}

• 取消指定本地推送代码实现

// 关闭本地推送
- (void)deleteLocalPush{
    // 获取该app上所有的本地推送
    NSArray *allLocalNotifi = [[UIApplication sharedApplication] scheduledLocalNotifications];

    // 取消特定的本地推送
    UILocalNotification *localNotifi  = nil;
    for (UILocalNotification *item in allLocalNotifi) {
        NSDictionary *userInfo = item.userInfo;
        if ([[userInfo objectForKey:@"name"] isEqualToString:@"loaclPushOne"]) {
            localNotifi = item;
            break;
        }
    }
    [[UIApplication sharedApplication] cancelLocalNotification:localNotifi];
}

• 取消所有的本地推送

  [[UIApplication sharedApplication]  cancelAllLocalNotifications];

• 点击本地推送通知 进入APP后的回调

#pragma mark - LocalPush
// 点击本地推送通知 进入APP后的回调 在iOS10之后将会 分成两个方法回调
 - (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{
    [application cancelLocalNotification:notification];
}

iOS10之后本地推送

• 本地通知也需要在appdelegate 中注册。

通知内容

• 通知内容有可变和不可变之分UNNotificationContent(不可变)、UNMutableNotificationContent(可变)，后续我们通过某一特定标识符更新通知，便是用可变通知了。
• 不管是可变通知还是不可变通知，都有以下的几个属性：

// 1.附件数组，存放UNNotificationAttachment类
@property (NS_NONATOMIC_IOSONLY, copy) NSArray <UNNotificationAttachment *> *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;

附件内容(UNNotificationAttachment)

• 在UNNotificationContent类中，有个附件数组的属性，这就是包含UNNotificationAttachment类的数组了。

@property (NS_NONATOMIC_IOSONLY, copy) NSArray <UNNotificationAttachment *> *attachments ;

苹果的解释说，UNNotificationAttachment（附件通知）是指可以包含音频，图像或视频内容，并且可以将其内容显示出来的通知。使用本地通知时，可以在通知创建时，将附件加入即可。对于远程通知，则必须实现使用UNNotificationServiceExtension类通知服务扩展。

创建附件的方法：

+ (nullable instancetype)attachmentWithIdentifier:(NSString *)identifier URL:(NSURL *)URL options:(nullable NSDictionary *)options error:(NSError *__nullable *__nullable)error;
// URL必须是一个有效的文件路径，不然会报错

• 在使用时，必须指定使用文件附件的内容，并且文件格式必须是支持的类型之一。

创建附件中options的属性,一共有4种选项。

• options属性为一个类型为字典的数值。

UNNotificationAttachmentOptionsTypeHintKey

• 一个包含描述文件的类型统一类型标识符（UTI）一个NSString。如果不提供该键，附件的文件扩展名来确定其类型，常用的类型标识符有
  kUTTypeImage、kUTTypeJPEG2000、kUTTypeTIFF、kUTTypePICT、kUTTypeGIF、kUTTypePNG、kUTTypeQuickTimeImage等。
• 这些标识符，在UIImagePickerController对象属性中也会遇到。
• 使用这些标识符需要导如对应的框架<MobileCoreServices/MobileCoreServices.h>
• 使用方法示例：

 NSMutableDictionary *optionsDict = [NSMutableDictionary dictionary];
    // 需要导入框架 #import<MobileCoreServices/MobileCoreServices.h>
    optionsDict[UNNotificationAttachmentOptionsTypeHintKey] = (__bridge id _Nullable)(kUTTypeImage);

UNNotificationAttachmentOptionsThumbnailHiddenKey

• 此值为布尔值，代表是否隐藏推送消息右侧缩略图，YES代表隐藏
• 使用方法示例：

optionsDict[UNNotificationAttachmentOptionsThumbnailHiddenKey] = @YES;
// 隐藏缩略图

UNNotificationAttachmentOptionsThumbnailClippingRectKey

• 剪贴矩形的缩略图，将缩略图整体作为1：1，然后按照比例进行缩减，以图片左上角为原点。
• 示例，剪切图片（中心的正方形）

optionsDict[UNNotificationAttachmentOptionsThumbnailClippingRectKey] = (__bridge id _Nullable)((CGRectCreateDictionaryRepresentation(CGRectMake(0.25, 0.25, 0.5 ,0.5))));

UNNotificationAttachmentOptionsThumbnailTimeKey

• 主要用于附件是影片的，选择影片中的某一秒来做这个缩略图。
• 示例，以影片第一秒来作为缩略图

optionsDict[UNNotificationAttachmentOptionsThumbnailTimeKey] = @1;

通知触发模式（UNNotificationTrigger）

• 通知触发模式供有四种情况，四种情况均是UNNotificationTrigger 子类。

远程推送触发模式

• @interface UNPushNotificationTrigger : UNNotificationTrigger

本地推送触发模式(按秒间隔)

• @interface UNTimeIntervalNotificationTrigger : UNNotificationTrigger
• 使用方法示例：

// timeInterval（时间间隔）和repeats（是否重复）
// 5秒后执行，NO:不重复
// 如果需要重复执行，则重复时间间隔需要大于60秒
UNTimeIntervalNotificationTrigger *triggerOne = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];

本地推送触发模式(按日期进行间隔)

• UNCalendarNotificationTrigger
• 使用方法示例：

// 例如：周二早上 9：00 上班
NSDateComponents *components = [[NSDateComponents alloc] init];
// 注意，weekday是从周日开始从1计数，如果想设置为从周一开始则需要设置为2
components.weekday = 3;
components.hour = 9;
UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];

本地推送触发模式(按地理位置)

• @interface UNLocationNotificationTrigger : UNNotificationTrigger

使用方式

1. 导入框架#import<CoreLocation/CoreLocation.h>
2. 初始化对象

 // 不建议使用！！！！！！CLRegion *region = [[CLRegion alloc] init];

 CLCircularRegion *circlarRegin = [[CLCircularRegion alloc] init];
    // 经纬度
    CLLocationDegrees latitudeDegrees = 123.00; // 维度
    CLLocationDegrees longitudeDegrees = 123.00; // 经度

    [circlarRegin containsCoordinate:CLLocationCoordinate2DMake(latitudeDegrees, longitudeDegrees)];
    UNLocationNotificationTrigger *trigger = [UNLocationNotificationTrigger triggerWithRegion:circlarRegin repeats:NO];

这里建议使用CLCircularRegion这个继承自CLRegion的类，因为我看到苹果已经飞起了CLRegion里面是否包含这一点的方法，并且推荐我们使用CLCircularRegion这个类型

创建本地通知示例

#pragma mark - 创建本地推送 ios10之后
- (void)creatLocalPushIOS10{
    // 注意：创建本地通知也需要在appdelegate中心进行注册
    // 1.创建通知内容
    UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
    content.title = @"本地通知标题";
    content.subtitle = @"本地通知副标题";
    content.body = @"本地通知内容";
    content.badge = @1;
    NSError *error = nil;
    NSString *path = [[NSBundle mainBundle] pathForResource:@"imageName" ofType:@"png"];
    // 2.设置通知附件内容
    NSMutableDictionary *optionsDict = [NSMutableDictionary dictionary];
    // 一个包含描述文件的类型统一类型标识符（UTI）一个NSString。如果不提供该键，附件的文件扩展名来确定其类型，常用的类型标识符有 kUTTypeImage,kUTTypeJPEG2000,kUTTypeTIFF,kUTTypePICT,kUTTypeGIF ,kUTTypePNG,kUTTypeQuickTimeImage等。

    // 需要导入框架 #import<MobileCoreServices/MobileCoreServices.h>
              optionsDict[UNNotificationAttachmentOptionsTypeHintKey] = (__bridge id _Nullable)(kUTTypeImage);
    // 是否隐藏缩略图
    optionsDict[UNNotificationAttachmentOptionsThumbnailHiddenKey] = @YES;
    // 剪切缩略图
    optionsDict[UNNotificationAttachmentOptionsThumbnailClippingRectKey] = (__bridge id _Nullable)((CGRectCreateDictionaryRepresentation(CGRectMake(0.25, 0.25, 0.5 ,0.5))));
    // 如果附件是影片，则以第几秒作为缩略图
optionsDict[UNNotificationAttachmentOptionsThumbnailTimeKey] = @1;
    // optionsDict如果不需要，可以不设置，直接传nil即可
    UNNotificationAttachment *att = [UNNotificationAttachment attachmentWithIdentifier:@"identifier" URL:[NSURL fileURLWithPath:path] options:optionsDict error:&error];
    if (error) {
        NSLog(@"attachment error %@", error);
    }
    content.attachments = @[att];
    content.launchImageName = @"imageName@2x";
    // 2.设置声音
    UNNotificationSound *sound = [UNNotificationSound defaultSound];
    content.sound = sound;
    // 3.触发模式 多久触发，是否重复
     // 3.1 按秒
    UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:5 repeats:NO];
     // 3.2 按日期
//    // 周二早上 9：00 上班
//    NSDateComponents *components = [[NSDateComponents alloc] init];
//    // 注意，weekday是从周日开始的计数的
//    components.weekday = 3;
//    components.hour = 9;
//    UNCalendarNotificationTrigger *trigger = [UNCalendarNotificationTrigger triggerWithDateMatchingComponents:components repeats:YES];
    // 3.3 按地理位置
    // 一到某个经纬度就通知，判断包含某一点么
    // 不建议使用！！！！！！CLRegion *region = [[CLRegion alloc] init];

//   CLCircularRegion *circlarRegin = [[CLCircularRegion alloc] init];
    // 经纬度
//    CLLocationDegrees latitudeDegrees = 123.00; // 维度
//    CLLocationDegrees longitudeDegrees = 123.00; // 经度

//    [circlarRegin containsCoordinate:CLLocationCoordinate2DMake(latitudeDegrees, longitudeDegrees)];
//    UNLocationNotificationTrigger *trigger = [UNLocationNotificationTrigger triggerWithRegion:circlarRegin repeats:NO];

    // 4.设置UNNotificationRequest
    NSString *requestIdentifer = @"TestRequest";
    UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:requestIdentifer content:content trigger:trigger];

    //5.把通知加到UNUserNotificationCenter, 到指定触发点会被触发
    [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
    }];

}

推送效果图示：

推送回调

• 远程推送与本地推送均是这两个回调

#pragma mark - UNUserNotificationCenterDelegate 
// iOS10 推送回调
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler{
    NSDictionary *userInfo = notification.request.content.userInfo;
    UNNotificationRequest *request = notification.request; // 收到推送的请求
    UNNotificationContent *content = request.content; //收到推送消息的全部内容
    NSNumber *badge = content.badge; // 推送消息的角标
    NSString *body = content.body; // 收到推送消息具体内容
    UNNotificationSound *sound = content.sound; //声音
    NSString *subTitle = content.subtitle; // 推送收到的副标题
    NSString *title = content.title; // 推送收到的标题

    if ([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        NSLog(@"iOS10 收到远程通知");
    }else{
        NSLog(@"ios10 收到本地通知%@%@%@%@%@",title,subTitle,body,badge,userInfo);
    }
    completionHandler(UNNotificationPresentationOptionBadge |
                      UNNotificationPresentationOptionSound |
                      UNNotificationPresentationOptionAlert );
    // 需要执行此方法，选择是否提醒用户，有以上三种那个类型可选

}
// 通知的点击事件
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler{
    NSDictionary *userInfo = response.notification.request.content.userInfo;
    UNNotificationRequest *request = response.notification.request;
    UNNotificationContent *content = request.content; //收到推送消息的全部内容
    NSNumber *badge = content.badge; // 推送消息的角标
    NSString *body = content.body; // 收到推送消息具体内容
    UNNotificationSound *sound = content.sound; //声音
    NSString *subTitle = content.subtitle; // 推送收到的副标题
    NSString *title = content.title; // 推送收到的标题
    NSLog(@">>>通知的点击事件");
    if ([request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
        NSLog(@"iOS10 收到远程通知");
    }else{
        NSLog(@"ios10 收到本地通知%@%@%@%@%@",title,subTitle,body,badge,userInfo);
    }
    completionHandler(); //系统要求执行此方法

}

---

代码地址：https://github.com/FlyingKuiKui/PushTestApp.git