转载请联系作者获取授权,并标明文章作者,谢谢!
大家好,之前的文章讲过了APNs推送的原理。推送开发证书和发布证书的注册,生成,以及把证书配制成pem格式交给我们的推送服务器使用。
今天讲解一下在代码层面上的推送注册,应用在前台和后台推送的回调,点击方法,以及对于不同系统需要作出的适配。
一,注册推送。注册推送需要区分系统。(因为iOS7用户很少,故本文尚未对iOS7调研)
我们需要在程序启动时application didFinishLaunchingWithOptions方法中注册推送。
1. iOS8和iOS9
//创建UIUserNotificationSettings,并设置消息的显示类类型
UIUserNotificationSettings *uns = [UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound) categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:uns];
上面函数三个UIUserNotificationType参数代表允许推送提示,标记,声音。最后调用的registerUserNotificationSettings方法代表本App注册通知,此时会弹出系统的提示框,也就是我们下载软件经常询问我们的是否允许接收通知。
2. iOS10
第一步,导入#import <UserNotifications/UserNotifications.h>
且要遵守<UNUserNotificationCenterDelegate>的协议,在Appdelegate.m中。
这里需要注意,我们最好写成这种形式
#ifdef NSFoundationVersionNumber_iOS_9_x_Max
#import <UserNotifications/UserNotifications.h>
#endif
第二步,写注册推送的方法
注意:下方代码中注释掉的三种UNNotificationActionOption类型是给UNNotificationAction事件添加响应类型的属性。
//iOS10特有
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
// 必须写代理,不然无法监听通知的接收与点击
center.delegate = self;
/**
UNNotificationActionOptionAuthenticationRequired: 锁屏时需要解锁才能触发事件,触发后不会直接进入应用
UNNotificationActionOptionDestructive:字体会显示为红色,且锁屏时触发该事件不需要解锁,触发后不会直接进入应用
UNNotificationActionOptionForeground:锁屏时需要解锁才能触发事件,触发后会直接进入应用界面
*/
UNNotificationAction *action1 = [UNNotificationAction actionWithIdentifier:kNotificationActionIdentifileStar title:@"赞" options:UNNotificationActionOptionAuthenticationRequired];
UNTextInputNotificationAction *action2 = [UNTextInputNotificationAction actionWithIdentifier:kNotificationActionIdentifileComment title:@"评论一下吧" options:UNNotificationActionOptionForeground textInputButtonTitle:@"评论" textInputPlaceholder:@"请输入评论"];
UNNotificationCategory *catetory = [UNNotificationCategory categoryWithIdentifier:kNotificationCategoryIdentifile actions:@[action1, action2] intentIdentifiers:@[kNotificationActionIdentifileStar, kNotificationActionIdentifileComment] options:UNNotificationCategoryOptionNone];
[center setNotificationCategories:[NSSet setWithObject:catetory]];
//向系统发出注册请求
[center requestAuthorizationWithOptions:(UNAuthorizationOptionAlert | UNAuthorizationOptionBadge | UNAuthorizationOptionSound) completionHandler:^(BOOL granted, NSError * _Nullable error) {
if (granted) {
//用户点击允许
NSLog(@"注册成功");
[center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
NSLog(@"%@", settings);
}];
} else {
//用户点击不允许
NSLog(@"注册失败");
}
}];
iOS10以后推送的弹出格式可以由我们添加扩展,如上方代码我给NotificationCategories添加了一个自定义的扩展,扩展中添加了两个Action并且每个Action都赋予了独一无二的Identifier(代码中为枚举字符串)。最后的requestAuthorizationWithOptions方法即像系统申请注册推送服务弹出询问框,getNotificationSettingsWithCompletionHandler方法可以获取到我们对Notification做的一些设置。
当我们注册推送失败是会调用下方函数:通常失败原因可能为证书无效,或者没有开启APNs推送功能。
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error{
NSLog(@"远程通知注册失败:%@",error);
}
二,获取DeviceToken发送给我们的推送服务器
什么是DeviceToken?
大家只需要记住他是APNs区别我们设备的一个标示(令牌),但是它还会变。
在上面的注册步骤结束后会弹出询问是否允许推送服务,用户点击了允许后就会调用下方的方法获取DeviceToken。
//获取DeviceToken
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
NSString *deviceTokenString = [[[[deviceToken description] stringByReplacingOccurrencesOfString:@"<"withString:@""]
stringByReplacingOccurrencesOfString:@">" withString:@""]stringByReplacingOccurrencesOfString:@" " withString:@""];
}
需要注意原始的DeviceToken是由尖括号包围起来的,所以需要对原始字符串进行截取。在Appdelegate中直接复制此方法即可,再将解析出来的deviceTokenString传递给我们的推送服务器。DeviceToken并不是一成不变的,据调查在测试环境交替到发布环境,App卸载重新安装,升级系统,系统数据还原等情况会改变。所以此时需要根据我们的需求查看是否上传新的DeviceToken。(其他DeviceToken改变的情况还需调查)
三,接受推送消息的代理方法(区分设备系统版本)
1. iOS8和iOS9接受和点击方法如下:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{
//userInfo即为推送的内容Dictionary格式可以打印查看
if (application.applicationState == UIApplicationStateActive) {
//应用在前台
if (1/*弹出系统推送框*/) {
completionHandler(UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);//此方法控制是否弹出系统的推送框
}else{
//弹出自定义
}
}else if (application.applicationState == UIApplicationStateBackground) {
//应用在后台收到推送的点击方法
}else{
//应用没有启动通过推送消息点击进入App调用的方法
}
}
需要注意:iOS8和iOS9的接受推送和点击推送都是此方法。据调研在iOS8的系统上应用在前台,虽然调用completionHandler回调方法但是并没有弹出系统的提示框。
2,iOS10接受推送方法
在iOS10中苹果给了我们2个代理方法来处理通知的接收和点击事件,这两个方法在<UNUserNotificationCenterDelegate>的协议中,大家可以查看下。此外,苹果把本地通知跟远程通知合二为一。区分本地通知跟远程通知的类是UNPushNotificationTrigger.h类中,UNPushNotificationTrigger的类型是新增加的,通过它,我们可以得到一些通知的触发条件,详见下方代码注释部分。
/**
本地和远程推送合为一个,通过 response.notification.request.trigger 来区分
1.UNPushNotificationTrigger (远程推送) 远程推送的通知类型
2.UNTimeIntervalNotificationTrigger (本地通知) 一定时间之后,重复或者不重复推送通知。我们可以设置timeInterval(时间间隔)和repeats(是否重复)。
3.UNCalendarNotificationTrigger(本地通知) 一定日期之后,重复或者不重复推送通知 例如,你每天8点推送一个通知,只要dateComponents为8,如果你想每天8点都推送这个通知,只要repeats为YES就可以了。
4.UNLocationNotificationTrigger (本地通知)地理位置的一种通知,
当用户进入或离开一个地理区域来通知。在CLRegion标识符必须是唯一的。因为如果相同的标识符来标识不同区域的UNNotificationRequests,会导致不确定的行为。
*/
//接收到通知的事件,应用在前台
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler
{
//推送的消息内容
NSDictionary *userInfo = notification.request.content.userInfo;
if([notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
//判断为第一种远程推送。
} else {
// 判断为本地通知,具体可以继续做判断
}
// 需要执行这个方法,选择是否提醒用户,有Badge、Sound、Alert三种类型可以设置
completionHandler(UNNotificationPresentationOptionBadge|UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
}
注意上面的方法仅为iOS10系统应用在前台收到推送的方法。下面方法为推送框的点击出发方法,此方法包括:应用在后台和没运行的情况下,点击推送消息进入到程序的方法;应用在前台如果执行了completionHandler方法弹出推送框,则点击推送框也在此方法。(如果不执行completionHandler则不弹框)
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler{
//推送内容
NSDictionary *userInfo = response.notification.request.content.userInfo;
if([response.notification.request.trigger isKindOfClass:[UNPushNotificationTrigger class]]) {
// 判断为远程推送
// 此处可以继续判断是应用在前台点击消息到此,还是在后台或者没运行的状态下点击推送消息进入到程序
} else {
// 判断为本地通知
}
NSString *actionIdentifile = response.actionIdentifier;
if ([actionIdentifile isEqualToString:kNotificationActionIdentifileStar]) {
[self showAlertView:@"点了赞"];
} else if ([actionIdentifile isEqualToString:kNotificationActionIdentifileComment]) {
[self showAlertView:[(UNTextInputNotificationResponse *)response userText]];
}
}
通过获取response.actionIdentifier就可以知道我们是否点击了之前注册推送时给NSNotification添加过的Action。
注意:细心的朋友会看到上面的方法也有一个completionHandler回调方法,但是这个回调方法并不是处理是否弹框的方法。仅仅是一个结果的回调。
总结:到此为止,有关iOS8,iOS9,iOS10的注册推送服务,接受推送消息,推送点击等事件的处理都叙述完毕。
作者:Olivia_Zqy