首先呢,需要一个配置好的工程,详见 极光推送官方文档,或者直接下载 现有工程(使用时记得改参数)。
极光推送相比较个推,除了以往的“通知”外,多了一个“自定义消息”,看一下官方文档中的一段解释:
通知:
简单场景下的通知,用户可以不写一行代码,而完全由 SDK 来负责默认的效果展示,以及默认用户点击时打开应用的主界面。
自定义消息:
SDK 不会把自定义消息展示到通知栏。
所以调试时,需要到日志里才可以看到服务器端推送的自定义消息。
自定义消息一定要由开发者写 接收推送消息Receiver 来处理收到的消息。
简单来说,如果APP在前台,会直接收到通知和自定义消息;如果APP不在前台,通知会通过APNs进行推送,而自定义消息则会在APP进入前台后接收到。
通知
当APP已经处于前台并接收到推送,或者APP不在前台时,接收到推送会有通知栏提示,这时点击通知栏唤醒(启动)APP,都会调用以下方法:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
// 取得 APNs 标准信息内容
NSDictionary *aps = [userInfo valueForKey:@"aps"];
NSString *content = [aps valueForKey:@"alert"]; // 推送显示的内容
NSInteger badge = [[aps valueForKey:@"badge"] integerValue]; // badge数量
NSString *sound = [aps valueForKey:@"sound"]; // 播放的声音
// 取得Extras字段内容
NSString *customizeField1 = [userInfo valueForKey:@"customizeExtras"]; // 服务端中Extras字段,key是自己定义的
NSLog(@"\nAppDelegate:\ncontent =[%@], badge=[%ld], sound=[%@], customize field =[%@]",content,badge,sound,customizeField1);
// Required
[JPUSHService handleRemoteNotification:userInfo];
completionHandler(UIBackgroundFetchResultNewData);
}
这里的Extras字段是极光推送控制台进行推送时设置的,为了更直观请遍历userInfo.allKeys并打印(我就不贴代码了)。
自定义消息
自定义消息只有APP在前台时才能接收到,如果APP在后台或者关闭状态,我猜测极光是将消息作为离线消息存储了起来,当APP被唤醒(启动)时,再进行推送。
在接收到自定义消息需要进行操作的页面注册通知:
// 注册通知
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(networkDidReceiveMessage:)
name:kJPFNetworkDidReceiveMessageNotification
object:nil];
// 接收到通知事件
- (void)networkDidReceiveMessage:(NSNotification *)notification {
NSDictionary *userInfo = [notification userInfo];
NSString *title = [userInfo valueForKey:@"title"];
NSString *content = [userInfo valueForKey:@"content"];
NSDictionary *extra = [userInfo valueForKey:@"extras"];
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:@"yyyy-MM-dd hh:mm:ss"];
self.timeLabel.text = [NSString stringWithFormat:@"时间:%@", [dateFormatter stringFromDate:[NSDate date]]];
self.titleLabel.text = [NSString stringWithFormat:@"标题:%@", title];
self.contentLabel.text = [NSString stringWithFormat:@"内容:%@", content];
self.extraLabel.text = [NSString stringWithFormat:@"传值:%@", [self logDic:extra]];
}
icon角标
由于APP不会自动清除角标,所以在APP进入前台后将角标置为0(清除),如果有需求的话还可以在这里直接清除通知栏消息:
- (void)applicationDidBecomeActive:(UIApplication *)application {
// 在app进入前台后,将icon右上角的红字置为0
/*
// 这里是为了在点击icon图标使APP进入前台的情况下清除通知栏消息,可根据需求开启
NSInteger badge = [UIApplication sharedApplication].applicationIconBadgeNumber;
badge = badge == 1 ? 2 : 1;
[UIApplication sharedApplication].applicationIconBadgeNumber = badge;
*/
[UIApplication sharedApplication].applicationIconBadgeNumber = 0;
}