Question

NotificationManager

版本：Android 4.0 r1

结构

继承关系

public class NotificationManager extends Object

java.lang.Object

android.app.NotificationManager

类概述

该类用来向用户通知发生的事情。用来告诉用户在后台发生的某些事情。

通知有下列一些形式：

l 在状态栏中显示一个图片，可以通过 launcher 来访问（当用户点击该图片会启动一个预先定义好的 intent）

l 打开或者闪烁设备上的 LED 灯

l 或者通知用户通过闪烁的背光灯、播放声音或者震动

每个通知方法接受一个整型的 id，还有一个字符串的标签参数可选，该参数可以为空。这两个参数被用来组成一对（tag，id）或者如果标签没有指定则为（null，id）。这对参数用来在应用程序和系统中标识该通知。所以这对参数在你的程序中应该唯一。

如果你在通知方法时传递该参数对（tag，id）和一些新的通知参数，如果（tag，id）对应的通知应经在运行，则对应的通知会被更新。举个例子来说：如果你传递一个新的状态栏图片，状态栏中老的图片会被新的图片所替换。该（tag，id）也用来传递给 cancel（Id）或者 cancel（String，int）方法来清除这些通知。

NotificationManager 不用实例化，可以通过 getSystemService（String）方法来获得。

开发者指南：创建一个通知，请阅读 Status Bar Notifications 开发者指南。

公共方法

public void cancel (int id)

移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。

参数

id 通知的 id

public void cancel (String tag，int id)

移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。

参数

tag 通知的标签

id 通知的 id

public void cancelAll ()

移除所有的已经显示的通知，详细行为见 cancel(int) 。

public void notify (int id，Notification notification)

提交一个通知在状态栏中显示。如果拥有相同 id 的通知已经被提交而且没有被移除，该方法会用新的信息来替换之前的通知。

参数

id 应用中通知的唯一标识

notification 一个通知对象用来描述向用户展示什么信息，不能为空

public void notify (String tag，int id，Notification notification)

提交一个通知在状态栏中显示。如果拥有相同标签和相同 id 的通知已经被提交而且没有被移除，该方法会用更新的信息来替换之前的通知。

参数

tag 用来标识通知的字符串，可以为空。

id 应用中通知的唯一标识。

notification 一个通知对象用来描述向用户展示什么信息，不能为空。

补充

文章精选

Android 中 Notification 详解【android 进化三十五】