第一次接触IOS的本地通知的使用,看到别人写的一个比较详细的记录,自己整理过来,方便以后再次使用和拓展:
1.创建一个本地通知,添加到系统:
1 // 初始化本地通知对象 2 UILocalNotification *notification = [[UILocalNotification alloc] init]; 3 if (notification) { 4 // 设置通知的提醒时间 5 NSDate *currentDate = [NSDate date]; 6 notification.timeZone = [NSTimeZone defaultTimeZone]; // 使用本地时区 7 notification.fireDate = [currentDate dateByAddingTimeInterval:5.0]; 8 9 // 设置重复间隔 10 notification.repeatInterval = kCFCalendarUnitDay; 11 12 // 设置提醒的文字内容 13 notification.alertBody = @"Wake up, man"; 14 notification.alertAction = NSLocalizedString(@"起床了", nil); 15 16 // 通知提示音 使用默认的 17 notification.soundName= UILocalNotificationDefaultSoundName; 18 19 // 设置应用程序右上角的提醒个数 20 notification.applicationIconBadgeNumber++; 21 22 // 设定通知的userInfo,用来标识该通知 23 NSMutableDictionary *aUserInfo = [[NSMutableDictionary alloc] init]; 24 aUserInfo[kLocalNotificationID] = @"LocalNotificationID"; 25 notification.userInfo = aUserInfo; 26 27 // 将通知添加到系统中 28 [[UIApplication sharedApplication] scheduleLocalNotification:notification]; 29 }
repeatInterval表示通知的重复间隔,在SDK中定义如下:
1 typedef CF_OPTIONS(CFOptionFlags, CFCalendarUnit) { 2 kCFCalendarUnitEra = (1UL << 1), 3 kCFCalendarUnitYear = (1UL << 2), 4 kCFCalendarUnitMonth = (1UL << 3), 5 kCFCalendarUnitDay = (1UL << 4), 6 kCFCalendarUnitHour = (1UL << 5), 7 kCFCalendarUnitMinute = (1UL << 6), 8 kCFCalendarUnitSecond = (1UL << 7), 9 kCFCalendarUnitWeek CF_ENUM_DEPRECATED(10_4, 10_10, 2_0, 8_0) = (1UL << 8), 10 kCFCalendarUnitWeekday = (1UL << 9), 11 kCFCalendarUnitWeekdayOrdinal = (1UL << 10), 12 kCFCalendarUnitQuarter CF_ENUM_AVAILABLE(10_6, 4_0) = (1UL << 11), 13 kCFCalendarUnitWeekOfMonth CF_ENUM_AVAILABLE(10_7, 5_0) = (1UL << 12), 14 kCFCalendarUnitWeekOfYear CF_ENUM_AVAILABLE(10_7, 5_0) = (1UL << 13), 15 kCFCalendarUnitYearForWeekOfYear CF_ENUM_AVAILABLE(10_7, 5_0) = (1UL << 14), 16 };
这里比较不好的一点是该值不能自定义(很遗憾,NSCalendarUnit是个枚举类型),例如你不能塞个10.0给它从而希望它每十秒重复一次。所以如果你想每20分钟发送一次通知,一小时内发送3次,那么只能同时设定三个通知了。
2.收到通知后委托内的自定义实现:
1 -(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{ 2 NSLog(@"Application did receive local notifications"); 3 4 UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Hello" message:@"welcome" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil]; 5 [alert show]; 6 }
3.如何取消(删除本地通知)
有一点需要注意,如果我们的应用程序给系统发送的本地通知是周期性的,那么即使把程序删了重装,之前的本地通知在重装时依然存在(没有从系统中移除)。
因此我们需要取消通知的方法,当然该对象也会在scheduledLocalNotifications数组中移除。
取消方法分为两种。
第一种比较暴力,直接取消所有的本地通知:
[[UIApplication sharedApplication] cancelAllLocalNotifications];
这个适合在App重装时第一次启动的时候,或还原程序默认设置等场合下使用。
第二种方法是针对某个特定通知的:
- (void)cancelLocalNotification:(UILocalNotification *)notification
4.如何标识一个本地通知
需要通知有一个标识,这样我们才能定位是哪一个通知。可以在notification的userInfo(一个字典)中指定。
例如:
1 -(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{ 2 NSLog(@"Application did receive local notifications"); 3 4 // 取消某个特定的本地通知 5 for (UILocalNotification *noti in [[UIApplication sharedApplication] scheduledLocalNotifications]) { 6 NSString *notiID = noti.userInfo[kLocalNotificationID]; 7 NSString *receiveNotiID = notification.userInfo[kLocalNotificationID]; 8 if ([notiID isEqualToString:receiveNotiID]) { 9 [[UIApplication sharedApplication] cancelLocalNotification:notification]; 10 return; 11 } 12 } 13 14 UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Hello" message:@"welcome" delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil]; 15 [alert show]; 16 }
当然使用上述本地通知的前提是,应用获取到了系统的通知权限,需要注册通知:
注册之前有两个前提条件必须准备好:
- 开发配置文件(provisioning profile,也就是.mobileprovision后缀的文件)的App ID不能使用通配ID必须使用指定APP ID并且生成配置文件中选择Push Notifications服务,一般的开发配置文件无法完成注册;
- 应用 程序的Bundle Identifier必须和生成配置文件使用的APP ID完全一致
1 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 2 UIDevice *device = [UIDevice currentDevice]; 3 float sysVersion = [device.systemVersion floatValue]; 4 if (sysVersion >= 8.0f) { 5 UIUserNotificationSettings *setting = [[UIApplication sharedApplication] currentUserNotificationSettings]; 6 if (UIUserNotificationTypeNone != setting.types) {
[self addLocalNotification]; 7 NSLog(@"已经允许了通知"); 8 }else{ 9 [[UIApplication sharedApplication]registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound categories:nil]]; 10 [[UIApplication sharedApplication] registerForRemoteNotifications]; 11 } 12 }else{ 13 UIRemoteNotificationType type = [[UIApplication sharedApplication] enabledRemoteNotificationTypes]; 14 if(UIRemoteNotificationTypeNone != type){ 15 NSLog(@"已经允许了通知"); 16 }else{ 17 [[UIApplication sharedApplication] registerForRemoteNotificationTypes:(UIRemoteNotificationType)(UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert)]; 18 } 19 } 20 21 //[self registerRemoteNotification]; 22 return YES; 23 } 24 25 #pragma mark 调用过用户注册通知方法之后执行(也就是调用完registerUserNotificationSettings:方法之后执行) 26 -(void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings{ 27 if (notificationSettings.types!=UIUserNotificationTypeNone) { 28 //[self addLocalNotification]; 29 NSLog(@"允许了通知"); 30 } 31 } 32 33 - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 34 NSLog(@"注册成功"); 35 } 36 37 - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error { 38 NSLog(@"注册失败"); 39 }
注:
- 在使用通知之前必须注册通知类型,如果用户不允许应用程序发送通知,则以后就无法发送通知,除非用户手动到iOS设置中打开通知。
- 本地通知是有操作系统统一调度的,只有在应用退出到后台或者关闭才能收到通知。(注意:这一点对于后面的推送通知也是完全适用的。 )
- 通知的声音是由iOS系统播放的,格式必须是Linear PCM、MA4(IMA/ADPCM)、µLaw、aLaw中的一种,并且播放时间必须在30s内,否则将被系统声音替换,同时自定义声音文件必须放到boundle中。
- 本地通知的数量是有限制的,最近的本地通知最多只能有64个,超过这个数量将被系统忽略。
- 如果想要移除本地通知可以调用UIApplication的cancelLocalNotification:或cancelAllLocalNotifications移除指定通知或所有通知。
从上面的程序可以看到userInfo这个属性我们设置了参数,那么这个参数如何接收呢?
在iOS中如果点击一个弹出通知(或者锁屏界面滑动查看通知),默认会自动打开当前应用。由于通知由系统调度那么此时进入应用有两种情况:
- 如果应用程序已经完全退出那么此时会调用- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法;
- 如果此时应用程序还在运行(无论是在前台还是在后台)则会调用-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification方法接收消息参数。
当然如果是后者自然不必多说,因为参数中已经可以拿到notification对象,只要读取userInfo属性即可。如果是前者的话则可以访问launchOptions中键为UIApplicationLaunchOptionsLocalNotificationKey的对象,这个对象就是发送的通知,由此对象再去访问userInfo。为了演示这个过程在下面的程序中将userInfo的内容写入文件以便模拟关闭程序后再通过点击通知打开应用获取userInfo的过程。
1 #pragma mark - 应用代理方法 2 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 3 //添加通知 4 [self addLocalNotification]; 5 6 //接收通知参数 7 UILocalNotification *notification=[launchOptions valueForKey:UIApplicationLaunchOptionsLocalNotificationKey]; 8 NSDictionary *userInfo= notification.userInfo; 9 10 [userInfo writeToFile:@"/Users/kenshincui/Desktop/didFinishLaunchingWithOptions.txt" atomically:YES]; 11 NSLog(@"didFinishLaunchingWithOptions:The userInfo is %@.",userInfo); 12 13 return YES; 14 }
上面的程序可以分为两种情况去运行:
- 一种是启动程序关闭程序,等到接收到通知之后点击通知重新进入程序;
- 另一种是启动程序后,进入后台(其实在前台也可以,但是为了明显的体验这个过程建议进入后台),接收到通知后点击通知进入应用。
两种情况会分别按照前面说的情况调用不同的方法接收到userInfo写入本地文件系统。有了userInfo一般来说就可以根据这个信息进行一些处理,例如可以根据不同的参数信息导航到不同的界面,假设是更新的通知则可以导航到更新内容界面等。