注:此文只现在已经不能适配iOS10了,iOS10推送采用了新的方法,做iOS9及以下的系统可读此篇文章。
写此文的原因可见此文章的姊妹篇iOS推送之远程推送(iOS Notification Of Remote Notification),如果你看过了它的姊妹篇,了解过了远程推送,那么再来看此本地推送,真真是易如反掌啊!
此篇文章的逻辑如下图所示:
本地推送介绍
本地推送和远程推送的功能是一样的,都是要提醒用户去做某些事情。但是和远程推送不同的就是本地推送是不需要设备联网的,而远程推送是必需要设备联网的,因为只有联网状态下,才能和苹果的APNs服务器建立长连接,从而推送消息。本地推送是由App自己设定的,并且发送给安装此App的这台设备,属于一对一的对应关系。
本地推送适合
日历
to-do list
等类型的App,注意:一个App最多只能设置64个本地推送,当超过此限制的时候,系统会自动忽略多余的本地推送,而保留能最快触发的64个。循环的本地推送会被系统认为是同一个本地推送。
本地推送应用
iOS8本地推送注册
iOS8之后推送要求必须注册App支持的用户交互类型,注册代码和远程推送注册代码相同如下
// iOS8注册本地通知类型
UIUserNotificationType types = UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert;
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
基本应用
UILocalNotification的基本属性
fireDate:启动时间
timeZone:启动时间参考的时区
repeatInterval:重复推送时间(NSCalendarUnit类型),0代表不重复
repeatCalendar:重复推送时间(NSCalendar类型)
alertBody:通知内容
alertAction:解锁滑动时的事件
alertLaunchImage:启动图片,设置此字段点击通知时会显示该图片
alertTitle:通知标题,适用iOS8.2之后
applicationIconBadgeNumber:收到通知时App icon的角标
soundName:推送是带的声音提醒,设置默认的字段为UILocalNotificationDefaultSoundName
userInfo:发送通知时附加的内容
category:此属性和注册通知类型时有关联,(有兴趣的同学自己了解,不详细叙述)适用iOS8.0之后
region:带有定位的推送相关属性,具体使用见下面【带有定位的本地推送】适用iOS8.0之后
regionTriggersOnce:带有定位的推送相关属性,具体使用见下面【带有定位的本地推送】适用iOS8.0之后
Example
- (void)scheduleNotificationWithItem:(ToDoItem *)item interval:(int)minutesBefore {
NSCalendar *calendar = [NSCalendar autoupdatingCurrentCalendar];
NSDateComponents *dateComps = [[NSDateComponents alloc] init];
[dateComps setDay:item.day];
[dateComps setMonth:item.month];
[dateComps setYear:item.year];
[dateComps setHour:item.hour];
[dateComps setMinute:item.minute];
NSDate *itemDate = [calendar dateFromComponents:dateComps];
UILocalNotification *localNotif = [[UILocalNotification alloc] init];
if (localNotif == nil) return;
localNotif.fireDate = [itemDate dateByAddingTimeIntervalInterval:-(minutesBefore*60)];
localNotif.timeZone = [NSTimeZone defaultTimeZone];
localNotif.alertBody = [NSString stringWithFormat:NSLocalizedString(@"%@ in %i minutes.", nil),
item.eventName, minutesBefore];
localNotif.alertAction = NSLocalizedString(@"View Details", nil);
localNotif.alertTitle = NSLocalizedString(@"Item Due", nil);
localNotif.soundName = UILocalNotificationDefaultSoundName;
localNotif.applicationIconBadgeNumber = 1;
NSDictionary *infoDict = [NSDictionary dictionaryWithObject:item.eventName forKey:ToDoItemKey];
localNotif.userInfo = infoDict;
// 设置好本地推送后必须调用此方法启动此推送
[[UIApplication sharedApplication] scheduleLocalNotification:localNotif];
}
取消本地推送的方法
// 取消某一个本地推送
[[UIApplication sharedApplication] cancelLocalNotification:notification];
// 取消所有的本地推送
[[UIApplication sharedApplication] cancelAllLocalNotifications];
收到本地通知时的回调方法
application: didFinishLaunchingWithOptions:
此方法在程序第一次启动是调用,也就是说App从Terminate状态进入Foreground状态的时候,根据方法内代码判断是否有推送消息。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// userInfo为收到远程通知的内容
NSDictionary *userInfo = launchOptions[UIApplicationLaunchOptionsLocalNotificationKey];
if (userInfo) {
// 有推送的消息,处理推送的消息
}
return YES;
}
application: didReceiveLocalNotification:
如果App处于Background状态时,只用用户点击了通知消息时才会调用该方法;如果App处于Foreground状态,会直接调用该方法。
- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification {
}
带有定位的本地推送
iOS8之后,本地推送可以创建带有定位的本地推送,当用户进入这一指定的区域的时候就会发送此推送。并且可以指定此消息是只发送一次,还是每次用户进入此区域的时候都发送此推送。设置此属性对应的属性字段为:regionTriggersOnce。
开启定位服务
注册带有定位的推送必要要求用户开启定位功能,授权使用定位服务
// 获得授权去追踪用户的位置
CLLocationManager *locManager = [[CLLocationManager alloc] init];
locManager.delegate = self;
[locManager requestWhenInUseAuthorization];
当你第一次请求使用授权定位服务的时候,系统会询问用户是同意还是拒绝。为了提醒用户,系统会显示一些在Info.plist中NSLocationWhenInUseUsageDescription
此key值对应的额外信息。使用定位服务此key值一定要配置。只有用户同意了此App访问他的位置信息,此App才会接收到回到方法。
处理定位回调
首先要检查用户对定位服务的授权状态,只有用户授权了可以访问用户的位置信息,才会回调以下方法
- (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status {
//检查状态判断App是否授权
if (status == kCLAuthorizationStatusAuthorizedWhenInUse) {
// 设置通知
[self startShowingLocationNotifications];
}
}
// 设置通知
- (void)startShowingLocationNotifications {
UILocalNotification *locNotification = [[UILocalNotification alloc] init];
locNotification.alertBody = @"You have arrived!";
locNotification.regionTriggersOnce = YES;
locNotification.region = [[CLCircularRegion alloc] initWithCenter:LOC_COORDINATE radius:LOC_RADIUS identifier:LOC_IDENTIFIER];
[[UIApplication sharedApplication] scheduleLocalNotification:locNotification];
}
// 收到本地通知的时候,回调此方法,处理通知
- (void)application:(UIApplication *)application didReceiveLocalNotification: (UILocalNotification *)notification {
if (notification.region) {
[self tellUserArrivedAtRegion:region];
}
}
本地推送使用注意(本地推送的坑)
本地推送的准确率和到达率都是秒杀远程推送的,但是本地推送也有一些问题,处理不善的话很容易让用户误解的。本地推送无论是在App处于什么状态,当有消息的时候,在手机下拉的Notifications中都是会有显示的。当App不是处于Foreground状态的时候,都是会有banner通知的,但是当App处于Foreground状态时,通知还是会一样发出,而且手机下拉Notifications中会有磁条通知,但是banner并不会出现。这样就会引起一个时间错觉问题。而且本地推送手机下拉Notifications中的消息显示,当用户打开App的时候不会消失的啊。只有用户点击此条消息或者直接给清除掉才会消息的啊。做此功能的时候,一直被说本地推送不准啊,我都同步数据了,为什么还让同步,经过几番测试,最终发现原因出于此,不知道算不算系统的一个bug。
注:在同步数据之后再设置[UIApplication sharedApplication].applicationIconBadgeNumber = 0可以清除通知栏里面的推送消息。在此感谢@冰奇的指出。
Example
我设置一条推送,内容是提醒用户去同步数据,此推送触发条件是(每天10:00,并且用户没有同步数据),当用户同步完数据,我就取消这个提醒。假设一用户在9:55的时候打开App,一直使用到10:05,这时提醒用户去同步数据的推送消息已经发出,由于App处于Foreground状态下并没有出现banner提醒,用户并不知道有消息提醒,这时他去同步数据,然后退出App,手机下拉Notifications中会有提示去同步数据的这条推送消息啊,这时用户就会很郁闷。。。他的表情一定是这样的:
总结
本地推送相比远程推送是简单的多了。但是在项目实际运用中会有各种复杂的逻辑判读,达到什么条件,什么时间在去推送;这些业务相关逻辑就都需要客户端去写了。不比远程推送,这些业务逻辑是在服务端处理。我们要做的就是收到推送消息,然后再处理就可以了。另外iOS8出的带有定位的本地推送这个功能自我感觉还是比较好玩的。其中可能还有本篇没有提到的一些本地推送相关知识,有什么好的想法,也欢迎你私密我一起讨论,共同进步。关于远程推送参看此文姊妹篇iOS推送之远程推送(iOS Notification Of Remote Notification)