Android Notification 详解——基本操作

前几天项目中有用到 Android 通知相关的内容,索性把 Android Notification 相关的知识都看了一遍,稍作梳理,在此做个总结,以备不时之需。

温故而知新,可以为师矣~

下图是我对 Notification 做的思维导图,也是本文的主要逻辑。
Android Notification

本文主要讲述 Notification 的基本操作部分,进阶部分的内容还在学习ing~

Notification 概述

Notification,是一种具有全局效果的通知,可以在系统的通知栏中显示。当 APP 向系统发出通知时,它将先以图标的形式显示在通知栏中。用户可以下拉通知栏查看通知的详细信息。通知栏和抽屉式通知栏均是由系统控制,用户可以随时查看。下面两张图均是来自 Google 官方文档。

notification_area
图 1 .通知栏中的通知

notification_drawe
图 2 .抽屉式通知栏中的通知

通知的目的是告知用户 App 事件。在平时的使用中,通知主要有以下几个作用:

  1. 显示接收到短消息、及时消息等信息(如QQ、微信、新浪、短信)
  2. 显示客户端的推送消息,如广告、优惠、版本更新、推荐新闻等,常用的第三方 SDK 有: JPush个推信鸽网易云信(偏重 IM )阿里云推送
  3. 显示正在进行的事物,例如:后台运行的程序,如音乐播放进度、下载进度等

其中,前两点可以归结为与用户交互,第三点是实时的任务提醒,但不可否认的是,第三点也会与用户交互。

Notification 作为 Android 重要的用户界面组成部分,它有自己的设计指南。在 Android 5.0(Api level 21) 中引入的 Material Design 尤为重要。关于 Notification 的设计指南请参考 Notification Pattern

Notification 的概述就这么多,接下去就开始讲 Notification 的基本使用,中间会穿插 Notification 的基本 UI 、各个版本的区别、常见的通知效果以及自己在学习过程中踩到的坑。

Notification 的基本操作

Notification 的基本操作主要有创建、更新、取消这三种。一个 Notification 的必要属性有三项,如果不设置则在运行时会抛出异常:
1. 小图标,通过 setSmallIcon() 方法设置
2. 标题,通过 setContentTitle() 方法设置
3. 内容,通过 setContentText() 方法设置

除了以上三项,其它均为可选项。虽然如此,但还是应该给 Notification 设置一个 Action ,这样就可以直接跳转到 App 的某个 Activity 、启动一个 Service 或者发送一个 Broadcast。否则,Notification 仅仅只能起到通知的效果,而不能与用户交互。

当系统接收到通知时,可以通过震动、响铃、呼吸灯等多种方式进行提醒。

创建 Notification

Notification 的创建主要涉及到 Notification.BuilderNotificationNotificationManager

  1. Notification.Builer : 使用建造者模式构建 Notification 对象。由于 Notification.Builder 仅支持 Android 4.1及之后的版本,为了解决兼容性问题, Google 在 Android Support v4 中加入了 NotificationCompat.Builder 类。对于某些在 Android 4.1 之后才特性,即使 NotificationCompat.Builder 支持该方法,在之前的版本中也不能运行。点我 查看更多关于 Notification 兼容性问题处理。文中使用的都是 NotificationCompat。
  2. Notification : 通知对应类,保存通知相关的数据。NotificationManager 向系统发送通知时会用到。
  3. NotificationManager : NotificationManager 是通知管理类,它是一个系统服务。调用 NotificationManager 的 notify() 方法可以向系统发送通知。

获取 NotificationManager 对象:

前面讲到,Notification 有三个必要属性。下面,我们就来创建一个简单的 Notification 。主要有以下三步:

  1. 获取 NotificationManager 实例
  2. 实例化 NotificationCompat.Builder 并设置相关属性
  3. 通过 builder.build() 方法生成 Notification 对象,并发送通知

以上代码是对 Android 3.0 及之后的版本而言(包括使用 Support Library),对于 Android 3.0 之前的版本,主要使用 new Notification() 方法来创建 Notification 对象,本文不对此方式做任何讲解,代码如下:

补充

  • Android Support Library包的区别

  • Notification 中的元素。在 Android N(24) 中, Google 对 Notification 的 UI 进行了修改。下图是 Android M 和 Android N 的对比。
    屏幕快照 2016-10-17 上午10.33.40
  • 关于 setSmallIcon() 与 setLargeIcon()。在 NotificationCompat.Builder 中有设置通知的大小图标的两个方法。这两个方法有什么区别呢?当 setSmallIcon() 与 setLargeIcon() 同时存在时, smallIcon 显示在通知的右下角, largeIcon 显示在左侧;当只设置 setSmallIcon() 时, smallIcon 显示在左侧。看下图你就明白了。对于部分 ROM ,可能修改过源码,如 MIUI 上通知的大图标和小图标是没有区别的。
    屏幕快照 2016-10-17 上午10.38.05

Google 官方是这么解释 setSmallIcon() 这个方法的:

Set the small icon resource, which will be used to represent the notification in the status bar. The platform template for the expanded view will draw this icon in the left, unless a large icon has also been specified, in which case the small icon will be moved to the right-hand side.

给 Notification 设置 Action

在前一章节 创建 Notification 中发送的通知并不具备与用户交互的能力,这是因为我们并没有给 Notification 设置 Action 。在这一节,我们就来讲讲如何给 Notification 设置 Action 。这里,我们来实现一个点击 Notification 跳转到 MainActivity 的效果。代码如下:

相比发送最简单的通知,发送具有 Action 的通知多了创建 Intent 、 PendingIntent 和 setContentIntent() 这几步。
不难看出, PendingIntent 才是重点,那么, PendingIntent 是什么呢?

PendingIntent

如果您了解 PendingIntent ,请直接跳过本节。

PendingIntent 是一种特殊的 Intent ,字面意思可以解释为延迟的 Intent ,用于在某个事件结束后执行特定的 Action 。从上面带 Action 的通知也能验证这一点,当用户点击通知时,才会执行。
PendingIntent 是 Android 系统管理并持有的用于描述和获取原始数据的对象的标志(引用)。也就是说,即便创建该PendingIntent对象的进程被杀死了,这个PendingItent对象在其他进程中还是可用的
日常使用中的短信、闹钟等都用到了 PendingIntent。

PendingIntent 主要可以通过以下三种方式获取:

PendingIntent 具有以下几种 flag:

更新 Notification

更新通知很简单,只需要再次发送相同 ID 的通知即可,如果之前的通知还未被取消,则会直接更新该通知相关的属性;如果之前的通知已经被取消,则会重新创建一个新通知。

更新通知跟发送通知使用相同的方式。详见上节:创建 Notification

取消 Notification

取消通知有如下 5 种方式:

  1. 点击通知栏的清除按钮,会清除所有可清除的通知
  2. 设置了 setAutoCancel() 或 FLAG_AUTO_CANCEL 的通知,点击该通知时会清除它
  3. 通过 NotificationManager 调用 cancel(int id) 方法清除指定 ID 的通知
  4. 通过 NotificationManager 调用 cancel(String tag, int id) 方法清除指定 TAG 和 ID 的通知
  5. 通过 NotificationManager 调用 cancelAll() 方法清除所有该应用之前发送的通知

如果你是通过 NotificationManager.notify(String tag, int id, Notification notify) 方法创建的通知,那么只能通过 NotificationManager.cancel(String tag, int id) 方法才能清除对应的通知,调用NotificationManager.cancel(int id) 无效。

关于 Notification 的基本操作代码如下,布局文件代码这就不贴了。我是 Demo 传送门

设置 Notification 的通知效果

前面讲了 Notification 的创建、更新和取消,以及给 Notification 设置 Action 等基本操作。那么,我怎么给 Notification 设置诸如震动、铃声、呼吸灯等效果呢?别急,接下来马上就会告诉你怎么给 Notification 添加效果。

Notification 有震动、响铃、呼吸灯三种响铃效果,可以通过 setDefaults(int defualts) 方法来设置。 Default 属性有以下四种,一旦设置了 Default 效果,自定义的效果就会失效。楼主在这里踩了坑,愣是调了半天没找到为什么自定义效果会消失,忘大家慎之。

除了以上几种设置 Notification 默认通知效果,还可以通过以下几种 FLAG 设置通知效果。

Notification 通知效果的设置方式及注意事项全部在代码中,核心代码如下:

至此, Notification 的基本操作都已经讲完了,发送一个带有自定义效果的简单通知已经不在话下。接下去,我们会讲 Notification 的一些高级操作。快上车,没时间解释了~

补充:当用户点击通知栏的时候,正在进行的通知,比如 Notification 的 flags = Notification.FLAG_INSISTENT ,那么相当于用户响应了该通知,后面的 Demo 中会给出具体的代码

文中如有纰漏,欢迎大家留言指出。
微博:厉圣杰
源码:AndroidDemo/Notification

参考

  1. Android Patterns——Notification
  2. Android User Interface——Notification
  3. 全面了解Android Notification

打赏支持我写出更多好文章,谢谢!

打赏作者

打赏支持我写出更多好文章,谢谢!

任选一种支付方式

1 收藏 评论

关于作者:踏歌行

希望有一天我能够很坦然地说:\"让我来告诉你,在我眼中,这是一个怎样的世界。\" 个人主页 · 我的文章 · 22 ·   

可能感兴趣的话题



直接登录
跳到底部
返回顶部