iOS 本地通知

级别: ★☆☆☆☆
标签:「iOS通知」「iOSPush」「本地通知」
作者: dac_1033
审校: QiShare团队

iOS中的通知(Notification)分为两种:
1. iOS 本地通知
2. iOS 远程通知
3. iOS 通知扩展


本篇将主要介绍:iOS 本地通知。

概述
本地通知是由本地应用触发的,是基于时间的通知形式,一般用于闹钟定时、待办事项等提醒功能。

发送本地通知的大体步骤如下:
(1)注册本地通知;
(2)创建本地通知相关变量,并初始化;
(3)设置处理通知的时间fireDate;
(4)设置通知的内容:通知标题、通知声音、图标数字等;
(5)设置通知传递的参数userInfo,该字典内容可自定义(这一步可选);
(6)添加这个配置好的本地通知。

  1. 注册本地通知
- (void)sendLocalNotification {
    
    NSString *title = @"通知-title";
    NSString *sutitle = @"通知-subtitle";
    NSString *body = @"通知-body";
    NSInteger badge = 1;
    NSInteger timeInteval = 5;
    NSDictionary *userInfo = @{@"id":@"LOCAL_NOTIFY_SCHEDULE_ID"};
    
    if (@available(iOS 10.0, *)) {
        // 1.创建通知内容
        UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
        [content setValue:@(YES) forKeyPath:@"shouldAlwaysAlertWhileAppIsForeground"];
        content.sound = [UNNotificationSound defaultSound];
        content.title = title;
        content.subtitle = subtitle;
        content.body = body;
        content.badge = @(badge);

        content.userInfo = userInfo;

        // 2.设置通知附件内容
        NSError *error = nil;
        NSString *path = [[NSBundle mainBundle] pathForResource:@"logo_img_02@2x" ofType:@"png"];
        UNNotificationAttachment *att = [UNNotificationAttachment attachmentWithIdentifier:@"att1" URL:[NSURL fileURLWithPath:path] options:nil error:&error];
        if (error) {
            NSLog(@"attachment error %@", error);
        }
        content.attachments = @[att];
        content.launchImageName = @"icon_certification_status1@2x";
        // 2.设置声音
        UNNotificationSound *sound = [UNNotificationSound soundNamed:@"sound01.wav"];// [UNNotificationSound defaultSound];
        content.sound = sound;

        // 3.触发模式
        UNTimeIntervalNotificationTrigger *trigger = [UNTimeIntervalNotificationTrigger triggerWithTimeInterval:timeInteval repeats:NO];

        // 4.设置UNNotificationRequest
        UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:LocalNotiReqIdentifer content:content trigger:trigger];

        // 5.把通知加到UNUserNotificationCenter, 到指定触发点会被触发
        [[UNUserNotificationCenter currentNotificationCenter] addNotificationRequest:request withCompletionHandler:^(NSError * _Nullable error) {
        }];

    } else {
    
        UILocalNotification *localNotification = [[UILocalNotification alloc] init];
        
        // 1.设置触发时间(如果要立即触发,无需设置)
        localNotification.timeZone = [NSTimeZone defaultTimeZone];
        localNotification.fireDate = [NSDate dateWithTimeIntervalSinceNow:5];
        
        // 2.设置通知标题
        localNotification.alertBody = title;
        
        // 3.设置通知动作按钮的标题
        localNotification.alertAction = @"查看";
        
        // 4.设置提醒的声音
        localNotification.soundName = @"sound01.wav";// UILocalNotificationDefaultSoundName;
        
        // 5.设置通知的 传递的userInfo
        localNotification.userInfo = userInfo;
        
        // 6.在规定的日期触发通知
        [[UIApplication sharedApplication] scheduleLocalNotification:localNotification];
        // 6.立即触发一个通知
        //[[UIApplication sharedApplication] presentLocalNotificationNow:localNotification];
    }
}
  1. 取消本地通知
- (void)cancelLocalNotificaitons {
    
    // 取消一个特定的通知
    NSArray *notificaitons = [[UIApplication sharedApplication] scheduledLocalNotifications];
    // 获取当前所有的本地通知
    if (!notificaitons || notificaitons.count <= 0) { return; }
    for (UILocalNotification *notify in notificaitons) {
        if ([[notify.userInfo objectForKey:@"id"] isEqualToString:@"LOCAL_NOTIFY_SCHEDULE_ID"]) {
            if (@available(iOS 10.0, *)) {
                [[UNUserNotificationCenter currentNotificationCenter] removePendingNotificationRequestsWithIdentifiers:@[LocalNotiReqIdentifer]];
            } else {
                [[UIApplication sharedApplication] cancelLocalNotification:notify];
            }
            break;
        }
    }
    // 取消所有的本地通知
    //[[UIApplication sharedApplication] cancelAllLocalNotifications];
}

app请求通知用户权限的提示弹窗:


请求通知用户权限的提示弹窗

app切换到前、后台或退出,还有锁屏之后弹出通知的效果:


app切换到前台时

app切换到后台时

锁屏

在上面的代码中我们设置了userInfo这个参数,在iOS中收到并点击通知,则会自动打开当前应用。由于通知由系统调度那么此时进入应用有两种情况,如下:

  • 系统版本 < iOS10
// 如果App已经完全退出:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;

// 当App已经完全退出时,获取userInfo参数过程如下:
// NSDictionary *userInfoLocal = (NSDictionary *)[launchOptions objectForKey:UIApplicationLaunchOptionsLocalNotificationKey];
// NSDictionary *userInfoRemote = (NSDictionary *)[launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];

// 如果App还在运行(前台or后台)
- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification;
  • 系统版本 >= iOS10
#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_10_0
#pragma mark - UNUserNotificationCenterDelegate
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler __IOS_AVAILABLE(10.0) __TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0);

- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler __IOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0) __TVOS_PROHIBITED;
#endif

备注:
(1)注册通知类型,当用户不允许时,则app无法接收通知;(用户可以到iOS设置->通知->找到相应app,手动设置通知选项)
(2)远程通知与本地通知是由iOS统一调度的,只有在应用退出到后台或者关闭才能收到通知。
(3)通知的声音是在代码中指定,由系统播放,播放时间必须在30s内,否则将被系统声音替换,同时自定义声音文件必须放到main boundle中,本文Demo中使用wav格式声音文件。
(4)本地通知是有数量限制的,一般短时间内发送的本地通知上限为64个,超过这个数量将被系统忽略(数据来源于网络,具体时间间隔待验证)。

Demo源码:GitHub地址

专栏下一篇:iOS 远程通知


了解更多iOS及相关新技术,请关注我们的公众号:

关注我们的途径有:
QiShare(简书)
QiShare(掘金)
QiShare(知乎)
QiShare(GitHub)
QiShare(CocoaChina)
QiShare(StackOverflow)
QiShare(微信公众号)

推荐文章:
iOS与JS交互之WKWebView-WKUIDelegate协议
如果360推出辣椒水,各位女士会买吗?
奇舞周刊第 274 期: 秋风起,白云飞

推荐阅读更多精彩内容

  • 天气晴 午上还是有高高的太阳 晚上可也得虚盖着被子 才不会着凉 秋日就这样不生不响的到了 想想这也是在这的第三个...
    晴天儿阅读 23评论 0 1