-
本地通知
是由本地应用
触发的,它是基于时间行为
的一种通知形式,例如闹钟定时
、待办事项提醒
,又或者一个应用在一段时候后不使用通常会提示用户使用
此应用等都是本地通知。
创建本地通知步骤:
1> 创建UILocalNotification。
2> 设置处理通知的时间fireDate。
3> 配置通知的内容:通知主体、通知声音、图标数字等。
4> 配置通知传递的自定义数据参数userInfo(这一步可选)。
5> 调用通知,可以使用scheduleLocalNotification:
按计划调度
一个通知,也可以使用presentLocalNotificationNow
立即调用
通知。
实例
- 以一个程序更新后用户长期没有使用的提醒为例对本地通知说明:
- 所有的逻辑都在AppDelegate中:进入应用后如果没有注册通知,需要首先注册通知请求用户允许通知;一旦调用完注册方法,无论用户是否选择允许通知此刻都会调用应用程序的
- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
代理方法,在这个方法中根据用户的选择:如果是允许通知则会按照前面的步骤创建通知并在一定时间后执行。
- 所有的逻辑都在AppDelegate中:进入应用后如果没有注册通知,需要首先注册通知请求用户允许通知;一旦调用完注册方法,无论用户是否选择允许通知此刻都会调用应用程序的
//
// AppDelegate.m
// LocalNotification
//
#import "AppDelegate.h"
#import "LTYViewController.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
#pragma mark - 应用代理方法
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
_window=[[UIWindow alloc]initWithFrame:[UIScreen mainScreen].bounds];
_window.backgroundColor =[UIColor colorWithRed:249/255.0 green:249/255.0 blue:249/255.0 alpha:1];
//设置全局导航条风格和颜色
[[UINavigationBar appearance] setBarTintColor:[UIColor colorWithRed:23/255.0 green:180/255.0 blue:237/255.0 alpha:1]];
[[UINavigationBar appearance] setBarStyle:UIBarStyleBlack];
LTYViewController *mainController=[[LTYViewController alloc]init];
_window.rootViewController=mainController;
[_window makeKeyAndVisible];
//如果已经获得发送通知的授权则创建本地通知,否则请求授权(注意:如果不请求授权在设置中是没有对应的通知设置项的,也就是说如果从来没有发送过请求,即使通过设置也打不开消息允许设置)
if ([[UIApplication sharedApplication] currentUserNotificationSettings].types!=UIUserNotificationTypeNone) {
[self addLocalNotification];
}else{
[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeAlert|UIUserNotificationTypeBadge|UIUserNotificationTypeSound categories:nil]];
}
return YES;
}
#pragma mark 调用过用户注册通知方法之后执行(也就是调用完registerUserNotificationSettings:方法之后执行)
- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings{
if (notificationSettings.types!=UIUserNotificationTypeNone) {
[self addLocalNotification];
}
}
#pragma mark 进入前台后设置消息信息
- (void)applicationWillEnterForeground:(UIApplication *)application{
//进入前台取消应用消息图标
[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0];
}
#pragma mark - 私有方法
#pragma mark 添加本地通知
- (void)addLocalNotification{
//定义本地通知对象
UILocalNotification *notification=[[UILocalNotification alloc] init];
//通知触发的时间,10s以后
notification.fireDate=[NSDate dateWithTimeIntervalSinceNow:10.0];
//通知重复次数
notification.repeatInterval=2;
//当前日历,使用前最好设置时区等信息以便能够自动同步时间
//notification.repeatCalendar=[NSCalendar currentCalendar];
//设置通知属性
notification.alertBody=@"最近添加了诸多有趣的特性,是否立即体验?"; //通知主体
notification.applicationIconBadgeNumber=1;//应用程序图标右上角显示的消息数
notification.alertAction=@"打开应用"; //待机界面的滑动动作提示
notification.alertLaunchImage=@"Default";//通过点击通知打开应用时的启动图片,这里使用程序启动图片
//notification.soundName=UILocalNotificationDefaultSoundName;//收到通知时播放的声音,默认消息声音
notification.soundName=@"msg.caf";//通知声音(需要真机才能听到声音)
//设置用户信息
notification.userInfo=@{@"id":@1,@"user":@"AYuan"};//绑定到通知上的其他附加信息
//调用通知
[[UIApplication sharedApplication] scheduleLocalNotification:notification];
}
#pragma mark 移除本地通知,在不需要此通知时记得移除
-(void)removeNotification{
[[UIApplication sharedApplication] cancelAllLocalNotifications];
}
@end
- 请求获得用户允许通知的效果:
- 应用退出到后弹出通知的效果:
- 锁屏状态下的通知效果(从这个界面可以看到alertAction配置为“打开应用”):
注意:
- 在使用通知之前必须
注册通知类型
,如果用户不允许应用程序发送通知,则以后就无法发送通知,除非用户手动到iOS设置中打开通知。 - 本地通知是有
操作系统统一调度
的,只有在应用退出到后台或者关闭
才能收到通知。(这一点对于后面的推送通知也是完全适用的。 ) - 通知的声音是由iOS系统播放的,格式必须是Linear PCM、MA4(IMA/ADPCM)、µLaw、aLaw中的一种,并且播放时间必须在30s内,否则将被系统声音替换,同时自定义声音文件必须放到main boundle中。
- 本地通知的数量是有限制的,最近的本地通知最多只能有64个,超过这个数量将被系统忽略。
- 如果想要移除本地通知可以调用UIApplication的cancelLocalNotification:或cancelAllLocalNotifications移除指定通知或所有通知。
userInfos属性
从上面的程序可以看到userInfo这个属性我们设置了参数,那么这个参数如何接收呢?
- 在iOS中如果点击一个弹出通知(或者锁屏界面滑动查看通知),默认会自动打开当前应用。
- 由于通知由系统调度那么此时进入应用有两种情况:
- 如果应用程序已经完全退出那么此时会调用
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
方法; - 如果此时应用程序还在运行(无论是在前台还是在后台)则会调用
-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
方法接收消息参数。
- 如果应用程序已经完全退出那么此时会调用
- 后者参数中已经可以拿到notification对象,只要读取userInfo属性即可。前者则可以访问
launchOptions
中键为UIApplicationLaunchOptionsLocalNotificationKey
的对象,这个对象就是发送的通知
,由此对象再去访问userInfo
。为了演示这个过程在下面的程序中将userInfo的内容写入文件以便模拟关闭程序后再通过点击通知打开应用获取userInfo的过程。
AppDelegate.m
//
// AppDelegate.m
// LocalNotification
//
#import "AppDelegate.h"
#import "LTYViewController.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
#pragma mark - 应用代理方法
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
_window=[[UIWindow alloc]initWithFrame:[UIScreen mainScreen].bounds];
_window.backgroundColor =[UIColor colorWithRed:249/255.0 green:249/255.0 blue:249/255.0 alpha:1];
//设置全局导航条风格和颜色
[[UINavigationBar appearance] setBarTintColor:[UIColor colorWithRed:23/255.0 green:180/255.0 blue:237/255.0 alpha:1]];
[[UINavigationBar appearance] setBarStyle:UIBarStyleBlack];
LTYViewController *mainController=[[LTYViewController alloc] init];
_window.rootViewController=mainController;
[_window makeKeyAndVisible];
//添加通知
[self addLocalNotification];
//接收通知参数
UILocalNotification *notification=[launchOptions valueForKey:UIApplicationLaunchOptionsLocalNotificationKey];
NSDictionary *userInfo= notification.userInfo;
[userInfo writeToFile:@"/Users/kenshincui/Desktop/didFinishLaunchingWithOptions.txt" atomically:YES];
NSLog(@"didFinishLaunchingWithOptions:The userInfo is %@.",userInfo);
return YES;
}
#pragma mark 接收本地通知时触发
-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification{
NSDictionary *userInfo=notification.userInfo;
[userInfo writeToFile:@"/Users/kenshincui/Desktop/didReceiveLocalNotification.txt" atomically:YES];
NSLog(@"didReceiveLocalNotification:The userInfo is %@",userInfo);
}
#pragma mark 调用过用户注册通知方法之后执行(也就是调用完registerUserNotificationSettings:方法之后执行)
-(void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings{
if (notificationSettings.types!=UIUserNotificationTypeNone) {
[self addLocalNotification];
}
}
#pragma mark 进入前台后设置消息信息
-(void)applicationWillEnterForeground:(UIApplication *)application{
[[UIApplication sharedApplication]setApplicationIconBadgeNumber:0];//进入前台取消应用消息图标
}
#pragma mark - 私有方法
#pragma mark 添加本地通知
-(void)addLocalNotification{
//定义本地通知对象
UILocalNotification *notification=[[UILocalNotification alloc]init];
//设置调用时间
notification.fireDate=[NSDate dateWithTimeIntervalSinceNow:10.0];//通知触发的时间,10s以后
notification.repeatInterval=2;//通知重复次数
//notification.repeatCalendar=[NSCalendar currentCalendar];//当前日历,使用前最好设置时区等信息以便能够自动同步时间
//设置通知属性
notification.alertBody=@"最近添加了诸多有趣的特性,是否立即体验?"; //通知主体
notification.applicationIconBadgeNumber=1;//应用程序图标右上角显示的消息数
notification.alertAction=@"打开应用"; //待机界面的滑动动作提示
notification.alertLaunchImage=@"Default";//通过点击通知打开应用时的启动图片
//notification.soundName=UILocalNotificationDefaultSoundName;//收到通知时播放的声音,默认消息声音
notification.soundName=@"msg.caf";//通知声音(需要真机)
//设置用户信息
notification.userInfo=@{@"id":@1,@"user":@"AYuan"};//绑定到通知上的其他额外信息
//调用通知
[[UIApplication sharedApplication] scheduleLocalNotification:notification];
}
@end
- 上面代码可分为两种情况运行:
- 一种是启动程序关闭程序,等到接收到通知之后点击通知重新进入程序;
- 另一种是启动程序后,进入后台(其实在前台也可以,但是为了明显的体验这个过程建议进入后台),接收到通知后点击通知进入应用。
- 情况不同调用不同的方法接收到userInfo写入本地文件系统。有了userInfo一般来说就可以根据这个信息进行一些处理,例如可以
根据不同的参数
信息导航到不同的界面
,假设是更新的通知则可以导航到更新内容界面等。