03.iOS本地推送通知

@(〓〓 iOS-实用技术)[远程/本地推送]


目录

  • 03.iOS本地推送通知
  • 1.推送通知简介
    • 什么是推送通知?
    • 推送通知的分类
  • 2.本地推送通知
    • 本地通知的基本使用
    • 额外设置/通知调度
    • 监听用户点击通知
    • 额外补充
    • 监听通知操作行为的点击
  • 3.本地通知的使用
    • 本地通知的基本使用
    • 本地通知的其他功能配置
      • 设置时区跟随手机系统时区
      • 设置通知的重复周期(最低一分钟)
      • 设置锁屏状态下, “滑动XXX”
      • 当通知进入锁屏界面时, 滑动通知, 打开APP时, 弹出的启动界面(现在设置这个属性没有效果)
      • 设置通知的弹框标题(iOS 8.2之后)
      • 设置通知的提示声音
      • 设置应用程序图片右上角的数字(取消直接设置为0)
      • 通知传值
      • 获取所有计划的通知
      • 取消所有计划的通知
    • 补充
  • 4.监听通知的点击
    • 通知非正常启动时传值
    • 监听通知的点击
    • 通知显示文本框(iOS 9.0之后才能使用)

1.推送通知简介

什么是推送通知?

首先明确:此处的推送通知跟”NSNotification”并没有任何关系
可以理解为: 向用户推送一条信息来通知用户某件事情
作用: 可以在APP退到后台,或者关闭时;继续推送一条消息告诉用户某件事情

  • 推送通知的应用场景?

(1) 一些任务管理APP,会在任务时间即将到达时,通知你做该任务;
(2) 健身App定时提醒你应该健身了;
(3) 买过电影票后,提前半小时告诉你,电影即将开场;
(4) 当你QQ或者微信收到消息时,即使退到后台,或者关闭APP,也可以收到信息通知告诉我们;
(5) 电商APP,推送一条消息通知我们有新品上架等等

  • 推送通知的展现样式

(1) 在屏幕顶部显示一块横幅(显示具体内容)
(2) 在屏幕中间弹出一个UIAlertView(显示具体内容)
(3) 在锁屏界面显示一块横幅(锁屏状态下,显示具体内容)
(4) 更新app图标的数字(说明新内容的数量)
(5) 播放音效(提醒作用)
注意:以上样式只能是用户自己设置,我们无法通过代码控制

  • 推送通知的展现示例图
01.推送通知的展现示例图.png

推送通知的分类

  • 本地推送通知

    • 应用场景: 确定知道未来某个时间点应该提醒用户什么

    “本地”可以理解为”不联网”;即使没有网络情况下,也可以推送通知消息

  • 远程推送通知

    • 概念:

    与“本地”相对,表示,必须在联网情况下才会向用户推送通知消息
    远程推送服务,又称为APNs(Apple Push Notification Services)

    • 应用场景:
    1. 不确定未来某个时间点应该提醒用户什么,临时性的
    2. 当APP彻底退出时也想继续让用户获取一些最新消息
      使用原则: 谁能确定通知时间和内容, 谁就可以发送(开发人员在APP内部通过代码发送=本地通知; 服务器可以确定通知时间和内容=远程通知)

2.本地推送通知

本地通知的基本使用

  • 1.创建UILocalNotification 对象

  • 2.设置一些必要属性

    推送通知的触发时间(何时发出推送通知)
    @property(nonatomic,copy) NSDate *fireDate;
    推送通知的具体内容
    @property(nonatomic,copy) NSString *alertBody;

  • 3.开始推送通知

    根据fireDate设定的时间进行推送
    [[UIApplication sharedApplication] scheduleLocalNotification:ln];
    立即推送
    presentLocalNotificationNow:(UILocalNotification *)notification;

  • 4.注意事项

    • 在iOS 8.0+,如果要使用本地通知,需要得到用户的许可
// 在didFinishLaunchingWithOptions方法中添加如下代码
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert categories:nil];
[application registerUserNotificationSettings:settings];

额外设置/通知调度

  • 通知的配置
    // 每隔多久重复发一次推送通知
    @property(nonatomic) NSCalendarUnit repeatInterval;
    
    // 点击推送通知打开app时显示的启动图片
    @property(nonatomic,copy) NSString *alertLaunchImage;
    
    // 附加的额外信息
    @property(nonatomic,copy) NSDictionary *userInfo;
    
    // 时区(一般设置为[NSTimeZone defaultTimeZone] ,跟随手机的时区)
    @property(nonatomic,copy) NSTimeZone *timeZone;
    
    // 在锁屏时显示的动作标题(完整标题:“滑动来” + alertAction)
    @property(nonatomic,copy) NSString *alertAction;
    
    // 音效文件名
    @property(nonatomic,copy) NSString *soundName;
    
    // app图标数字
    @property(nonatomic) NSInteger applicationIconBadgeNumber;
  • 取消调度本地推送通知
    // 取消指定本地推送通知
    - (void)cancelLocalNotification:(UILocalNotification *)notification;
    // 取消所有本地推送通知
    - (void)cancelAllLocalNotifications;
  • 获得被调度(定制)的所有本地推送通知
    // 已经发出且过期的推送通知就算调度结束,会自动从这个数组中移除
    @property(nonatomic,copy) NSArray *scheduledLocalNotifications;

监听用户点击通知

  • app处于前台

    此时不会弹框通知用户通知的到达,但是还是会调用对应的代理方法

  • app并没有关闭,一直隐藏在后台时

    此时用户点击通知信息后,会让app进入前台,并会调用AppDelegate的下面方法
    application: didReceiveLocalNotification:

  • app已经被关闭(进程已死)

    此时用户点击通知信息后,会启动app,启动完毕会调用AppDelegate的下面方法
    application: didFinishLaunchingWithOptions:
    launchOptions参数通过UIApplicationLaunchOptionsLocalNotificationKey取出本地推送通知对象


额外补充

  • 在iOS8.0之后,可以设置推送通知带操作行为

  • 在注册设置时,设置categories:参数

    • UIMutableUserNotificationAction

      • identifier
        动作标识
      • title
        动作标题
      • activationMode
        是前台运行, 还是后台运行此动作
      • destructive
        是否是破坏性动作(只是通过颜色, 标识按钮, 给用户提示)
      • behavior
        动作行为(iOS9.0提供一个文本行为)

监听通知操作行为的点击

// 监听通知的点击
application(application: UIApplication, handleActionWithIdentifier identifier: String?, forLocalNotification notification: UILocalNotification, completionHandler: () -> Void)

// 监听通知的点击(优先级较高)iOS 9.0以后可以使用的方法,如果该方法实现,就不会调用上面的方法.
application(application: UIApplication, handleActionWithIdentifier identifier: String?, forLocalNotification notification: UILocalNotification, withResponseInfo responseInfo: [NSObject : AnyObject], completionHandler: () -> Void)

3.本地通知的使用

本地通知的基本使用

  • 1.请求授权(iOS 8.0之后需主动请求授权)
    • 在AppDelegate.m中请求授权
// ----------------------------------------------------------------------------
// iOS 8.0之后需主动请求授权
- (void)requestAuthor
{
    
    if ([UIDevice currentDevice].systemVersion.floatValue >= 8.0) {
        
        // 设置通知的类型可以为弹窗提示,声音提示,应用图标数字提示
        UIUserNotificationSettings *setting = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert categories:nil];
        // 授权通知
        [[UIApplication sharedApplication] registerUserNotificationSettings:setting];
    }
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // 主动请求授权
    [self requestAuthor];
    
    return YES;
}

  • 2.在ViewController.m中设置本地通知的属性
    • 发送方式一: 根据通知的发送时间(fireDate)发送通知
    • 发送方式二: 立即发送通知
// 如果是iOS 8.0之前版本,不用请求授权就能发送本地通知.如果是iOS 8.0之后,需主动请求授权才能发送本地通知.一般在AppDelegate中请求授权
// 1.通知显示的条件:
// 1.1 当App处于后台,锁屏状态,彻底退出时,都会显示通知
// 注意: 当App处于前台状态时,不会显示通知

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    // 1.创建通知
    UILocalNotification *localNotification = [[UILocalNotification alloc] init];
    
    // 2.设置通知的必选参数
    // 设置通知显示的内容
    localNotification.alertBody = @"本地通知测试";
    // 设置通知的发送时间
    localNotification.fireDate = [NSDate dateWithTimeIntervalSinceNow:3];
    
    // 3.发送通知
    // 方式一: 根据通知的发送时间(fireDate)发送通知
    [[UIApplication sharedApplication] scheduleLocalNotification:localNotification];
    
    // 方式二: 立即发送通知
//    [[UIApplication sharedApplication] presentLocalNotificationNow:localNotification];
}
  • 3.运行效果图
    • 注意: 运行程序后,点击view之后,必须推到后台才能看到通知的运行效果.

首次运行会弹出让用户选择授权

02.首次运行会弹出让用户选择授权.png

在桌面顶部弹出效果

03.在桌面顶部弹出效果.png

下拉通知菜单的效果

04.下拉通知菜单的效果.png

本地通知的其他功能配置


设置时区跟随手机系统时区

    // 设置时区跟随手机系统时区
    localNotification.timeZone = [NSTimeZone defaultTimeZone];

设置通知的重复周期(最低一分钟)

    // 设置通知的重复周期(最低一分钟)
//    localNotification.repeatInterval = NSCalendarUnitMinute;


设置锁屏状态下, "滑动XXX"

    // 设置锁屏状态下, "滑动XXX"
    localNotification.hasAction = YES;
    localNotification.alertAction = @"alertAction";
  • 锁屏状态下, "滑动XXX"的运行效果
05.下拉通知菜单的效果.png

当通知进入锁屏界面时, 滑动通知, 打开APP时, 弹出的启动界面(现在设置这个属性没有效果)

    // 当通知进入锁屏界面时, 滑动通知, 打开APP时, 弹出的启动界面
    // 注意: 现在这个属性, 没有反应!!!!
    localNotification.alertLaunchImage = @"bear";

设置通知的弹框标题(iOS 8.2之后)

    // 设置通知的弹框标题
    if ([UIDevice currentDevice].systemVersion.floatValue >= 8.2) {
        localNotification.alertTitle = @"alertTitle";
    }

设置通知的提示声音

// 设置通知的提示声音 UILocalNotificationDefaultSoundName: 系统默认声音
// 注意: 手机必须处于非静音模式!!!
localNotification.soundName = @"win.aac";

设置应用程序图片右上角的数字(取消直接设置为0)

    // 设置应用程序图片右上角的数字(如果想要取消右上角的数字, 直接把这个参数值为0)
    localNotification.applicationIconBadgeNumber = 10;
  • 运行效果
06.应用程序图片右上角的数字.png

通知传值

    localNotification.userInfo = @{@"name" : @"liwx", @"body" : @"吃饭了没呀~~~"};

获取所有计划的通知

    // 获取所有计划的通知
    NSArray *array = [UIApplication sharedApplication].scheduledLocalNotifications;

取消所有计划的通知

    // 取消所有计划的通知
    [[UIApplication sharedApplication] cancelAllLocalNotifications];

补充

  • 应用程序进入前台会调用该代理方法
// 进入前台时会调用该方法
- (void)applicationDidBecomeActive:(UIApplication *)application;

4.监听通知的点击

通知非正常启动时传值

  • App非正常启动时,通知传值

当App完全关闭后,点击通知进入App启动时,会将通知的参数传递给launchOptions

  • 监听通知的传值launchOptions参考代码
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // 主动请求授权
    [self requestAuthor];
    
    
    // ------------------------------------------------------------------------
    // 如果当APP通过一些非正常手段启动时(正常: 点击APP 图标打开)
    // 这时候, 都会把对应的一些参数信息, 传递给launchOptions
    // 此处不能使用NSLog打印,NSLog只能在调试状态下打印,而此方式必须应用完全关闭,所有不是出于调试状态.所以此处使用TextView来显示launchOptions的值
    NSLog(@"launchOptions: %@", launchOptions);
    
    UITextView *textView = [[UITextView alloc] initWithFrame:CGRectMake(200, 150, 150, 480)];
    textView.backgroundColor = [UIColor orangeColor];
    textView.text = launchOptions.description;
    [self.window.rootViewController.view addSubview:textView];
    
    if (launchOptions[UIApplicationLaunchOptionsLocalNotificationKey]) {
        textView.text = [NSString stringWithFormat:@"%@, ------\n%@", textView.text, @"用户是通过点击了通知启动的APP"];
    }
    return YES;
}

  • 监听通知的传值运行效果图
07.监听通知的传值运行效果图.gif

监听通知的点击

  • 监听本地通知的点击
// ------------------------------------------------------------------------
/**
 只有当发送出一个本地通知, 并且满足以下条件时, 才会调用该方法
 APP 处于前台情况
 当用用户点击了通知, 从后台, 进入到前台时,
 当锁屏状态下, 用户点击了通知, 从后台进入前台
 
 注意: 当App彻底退出时, 用户点击通知, 打开APP , 不会调用这个方法
 
 但是会把通知的参数传递给 application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool
 
 */

- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
{
    NSLog(@"接收到本地通知");
    
    // 通过UI控件来测试.当App彻底退出时, 用户点击通知, 打开APP , 会不会调用这个方法
    UISwitch *sw = [[UISwitch alloc] init];
    [self.window.rootViewController.view addSubview:sw];
    
    // 查看当前的状态出于(前台: 0)/(后台: 2)/(从后台进入前台: 1)
    NSLog(@"applicationState.rawValue: %zd", application.applicationState);
    
    // 执行响应操作
    // 如果当前App在前台,执行操作
    if (application.applicationState == UIApplicationStateActive) {
        NSLog(@"执行前台对应的操作");
    } else if (application.applicationState == UIApplicationStateInactive) {
        // 后台进入前台
        NSLog(@"执行后台进入前台对应的操作");
        NSLog(@"%@", notification.userInfo);
    } else {
        // 当前App在后台
        NSLog(@"执行后台对应的操作");
    }
}

通知显示文本框(iOS 9.0之后才能使用)

  • 1.创建本地通知行为操作组
    • UIMutableUserNotificationCategory: 行为操作组
    • UIMutableUserNotificationAction: 行为操作按钮
      • identifier: 行为操作标识
      • title: 行为操作按钮的标题
      • behavior: 设置通知提醒显示文本框UIUserNotificationActionBehaviorTextInput.(iOS 9.0之后才能使用)
      • activationMode: 设置行为操作按钮点击后是在前台还是后台运行
      • authenticationRequired: 设置只有解锁之后才能执行
      • destructive: 设置这个操作是否是破坏性的行为(通过不同颜色来区别)
    • 使用步骤: 将按钮添加到操作组,之后将操作组封装到集合.封装的集合左右请求授权的参数.具体操作参考以下代码.
// ----------------------------------------------------------------------------
// iOS 8.0之后需主动请求授权
- (void)requestAuthor
{
    
    if ([UIDevice currentDevice].systemVersion.floatValue >= 8.0) {
        
        // ------------------------------------------------------------------------
        // 1.给通知设置一些操作行为.注意: 需先注册这些操作行为
        // 1.1 创建一个组
        UIMutableUserNotificationCategory *category = [[UIMutableUserNotificationCategory alloc] init];
        // 设置组的标识
        category.identifier = @"select";
        
        // ------------------------------------------------------------------------
        // 添加按钮1 "进入"
        // 1.2 创建操作行为
        UIMutableUserNotificationAction *action1 = [[UIMutableUserNotificationAction alloc] init];
        // 设置行为的标识
        action1.identifier = @"go";
        action1.title = @"进入";
//        action1.behavior = nil;
        
        // 设置要在前台执行该行为
        action1.activationMode = UIUserNotificationActivationModeForeground;
        // 设置只有解锁之后才能执行
//        action1.authenticationRequired = YES;
        // 设置这个操作是否是破坏性的行为(通过不同颜色来区别)
        action1.destructive = YES;
        
        // ------------------------------------------------------------------------
        // 添加按钮2 "回复"
        // 1.2 创建操作行为
        UIMutableUserNotificationAction *action2 = [[UIMutableUserNotificationAction alloc] init];
        // 设置行为的标识
        action2.identifier = @"answer";
        action2.title = @"回复";
        // iOS 9.0之后才能弹出文本框,如果没判断,在9.0之前版本运行,程序会崩溃
        if ([UIDevice currentDevice].systemVersion.floatValue >= 9.0) {
            action2.behavior = UIUserNotificationActionBehaviorTextInput;
        }
    
        // 设置要在后台执行该行为
        action2.activationMode = UIUserNotificationActivationModeBackground;
        
        // 设置这个是破坏性的行为(通过不同颜色来区别)
        action2.destructive = NO;
        
        
        // ------------------------------------------------------------------------
        // 将按钮1和按钮2添加到category
        NSArray *actions = @[action1, action2];
        [category setActions:actions forContext:UIUserNotificationActionContextDefault];
        
        // 将category封装为集合
        NSSet *categories = [NSSet setWithObjects:category, nil];
        
        
        // ------------------------------------------------------------------------
        // 授权通知
        // 设置通知的类型可以为弹窗提示,声音提示,应用图标数字提示
        UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge | UIUserNotificationTypeSound | UIUserNotificationTypeAlert categories:categories];
        // 授权通知
        [[UIApplication sharedApplication] registerUserNotificationSettings:settings];
    }
}

  • 2.注意: 在创建本地通知时必须指定通知使用哪个操作组
// 指定通知使用哪个操作组
localNotification.category = @"select";
  • 3.通知显示文本框运行效果
08.通知显示文本框运行效果.gif

推荐阅读更多精彩内容