android: 使用通知

8.1   使用通知

通知（Notification）是 Android 系统中比较有特色的一个功能，当某个应用程序希望向 用户发出一些提示信息，而该应用程序又不在前台运行时，就可以借助通知来实现。发出一 条通知后，手机最上方的状态栏中会显示一个通知的图标，下拉状态栏后可以看到通知的详 细内容。Android 的通知功能获得了大量用户的认可和喜爱，就连 iOS 系统也在 5.0 版本之 后加入了类似的功能。

8.1.1    通知的基本用法

了解了通知的基本概念，下面我们就来看一下通知的使用方法吧。通知的用法还是比较 灵活的，既可以在活动里创建，也可以在广播接收器里创建，当然还可以在下一章中我们即 将学习的服务里创建。相比于广播接收器和服务，在活动里创建通知的场景还是比较少的， 因为一般只有当程序进入到后台的时候我们才需要使用通知。

不过，无论是在哪里创建通知，整体的步骤都是相同的，下面我们就来学习一下创建通 知的详细步骤。首先需要一个 NotificationManager 来对通知进行管理，可以调用 Context 的 getSystemService()方法获取到。getSystemService()方法接收一个字符串参数用于确定获取系 统 的 哪 个 服 务 ， 这 里 我 们 传 入 Context.NOTIFICATION_SERVICE 即 可 。 因 此 ， 获 取NotificationManager 的实例就可以写成：

NotificationManager manager = (NotificationManager)

getSystemService(Context.NOTIFICATION_SERVICE);

接下来需要创建一个 Notification 对象，这个对象用于存储通知所需的各种信息，我们 可以使用它的有参构造函数来进行创建。Notification 的有参构造函数接收三个参数，第一个 参数用于指定通知的图标，比如项目的 res/drawable 目录下有一张 icon.png 图片，那么这里 就可以传入 R.drawable.icon。第二个参数用于指定通知的 ticker 内容，当通知刚被创建的时 候，它会在系统的状态栏一闪而过，属于一种瞬时的提示信息。第三个参数用于指定通知被 创建的时间，以毫秒为单位，当下拉系统状态栏时，这里指定的时间会显示在相应的通知上。 因此，创建一个 Notification 对象就可以写成：

Notification notification = new Notification(R.drawable.icon, "This is ticker text", System.currentTimeMillis());

创建好了 Notification 对象后，我们还需要对通知的布局进行设定，这里只需要调用 Notification 的 setLatestEventInfo()方法就可以给通知设置一个标准的布局。这个方法接收四 个参数，第一个参数是 Context，这个没什么好解释的。第二个参数用于指定通知的标题内 容，下拉系统状态栏就可以看到这部分内容。第三个参数用于指定通知的正文内容，同样下 拉系统状态栏就可以看到这部分内容。第四个参数我们暂时还用不到，可以先传入 null。因 此，对通知的布局进行设定就可以写成：

notification.setLatestEventInfo(context, "This is content title", "This is content text", null);

以上工作都完成之后，只需要调用 NotificationManager 的 notify()方法就可以让通知显示 出来了。notify()方法接收两个参数，第一个参数是 id，要保证为每个通知所指定的 id 都是 不同的。第二个参数则是 Notification 对象，这里直接将我们刚刚创建好的 Notification 对象 传入即可。因此，显示一个通知就可以写成：

manager.notify(1, notification);

到这里就已经把创建通知的每一个步骤都分析完了，下面就让我们通过一个具体的例子 来看一看通知到底是长什么样的。

新建一个 NotificationTest 项目，并修改 activity_main.xml 中的代码，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent"

android:orientation="vertical" >

<Button
android:id="@+id/send_notice"
android:layout_width="match_parent"
android:layout_height="wrap_content" android:text="Send
notice"

/>

</LinearLayout>

布局文件非常简单，里面只有一个 Send notice 按钮，用于发出一条通知。接下来修改

MainActivity 中的代码，如下所示：

public class MainActivity extends Activity implements
OnClickListener {

private Button sendNotice;

@Override

protected void
onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

sendNotice = (Button) findViewById(R.id.send_notice);

sendNotice.setOnClickListener(this);

}

@Override

public void onClick(View
v) {

switch (v.getId()) {

case R.id.send_notice:

NotificationManager manager = (NotificationManager)

getSystemService(NOTIFICATION_SERVICE);

Notification notification
= new Notification(R.drawable. ic_launcher, "This is ticker text",
System.currentTimeMillis());

notification.setLatestEventInfo(this,
"This is content
title",

"This is content
text", null); manager.notify(1, notification); break;

default:

break;

}

}

}

可以看到，我们在 Send notice 按钮的点击事件里面完成了通知的创建工作，创建的过程 正如前面所描述的一样。现在就可以来运行一下程序了，点击 Send notice 按钮，就会看到有 一条通知在系统状态栏显示出来，如图 8.1 所示。

图   8.1

下拉系统状态栏可以看到该通知的详细信息，如图 8.2 所示。

图   8.2

如果你使用过 Android 手机，此时应该会下意识地认为这条通知是可以点击的。但是当
你去点击它的时候，你会发现没有任何效果。不对啊，好像每条通知点击之后都应该会有反
应的呀？其实要想实现通知的点击效果，我们还需要在代码中进行相应的设置，这就涉及到
了一个新的概念，PendingIntent。

PendingIntent 从名字上看起来就和 Intent 有些类似，它们之间也确实存在着不少共同点。
比如它们都可以去指明某一个“意图”，都可以用于启动活动、启动服务以及发送广播等。 不同的是，Intent 更加倾向于去立即执行某个动作，而 PendingIntent 更加倾向于在某个合适
的时机去执行某个动作。所以，也可以把 PendingIntent 简单地理解为延迟执行的 Intent。

PendingIntent 的用法同样很简单，它主要提供了几个静态方法用于获取 PendingIntent 的 实例，可以根据需求来选择是使用 getActivity()方法、getBroadcast()方法、还是 getService()
方法。这几个方法所接收的参数都是相同的，第一个参数依旧是 Context，不用多做解释。 第二个参数一般用不到，通常都是传入 0 即可。第三个参数是一个 Intent 对象，我们可以通
过这个对象构建出 PendingIntent 的“意图”。第四个参数用于确定 PendingIntent 的行为，有
FLAG_ONE_SHOT、FLAG_NO_CREATE、FLAG_CANCEL_CURRENT 和 FLAG_UPDATE_
CURRENT 这四种值可选，每种值的含义你可以查看文档，我就不一一进行解释了。

对 PendingIntent 有 了 一 定 的 了 解 后 ， 我 们 再 回 过 头 来 看 一 下 Notification 的 setLatestEventInfo()方法。刚才我们将 setLatestEventInfo()方法的第四个参数忽略掉了，直接 传入了 null，现在仔细观察一下，发现第四个参数正是一个 PendingIntent 对象。因此，这里 就可以通过 PendingIntent 构建出一个延迟执行的“意图”，当用户点击这条通知时就会执行
相应的逻辑。

现在我们来优化一下 NotificationTest 项目，给刚才的通知加上点击功能，让用户点击它 的时候可以启动另一个活动。

首先需要准备好另一个活动，这里新建布局文件 notification_layout.xml，代码如下所示：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent" >

<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:textSize="24sp"

android:text="This is notification layout"

/>

</RelativeLayout>

布局文件的内容非常简单，只有一个居中显示的 TextView，用于展示一段文本信息。然 后新建 NotificationActivity 继承自 Activity，在这里加载刚才定义的布局文件，代码如下所示：

public class NotificationActivity extends Activity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.notification_layout);

}

}

接着修改 AndroidManifest.xml 中的代码，在里面加入 NotificationActivity 的注册声明，
如下所示：

<manifest
xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.notificationtest"

android:versionCode="1"

android:versionName="1.0" >

……

<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >

……

<activity android:name=".NotificationActivity" >

</activity>

</application>

</manifest>

这样就把 NotificationActivity 这个活动准备好了，下面我们修改 MainActivity 中的代码， 给通知加入点击功能，如下所示：

public class MainActivity extends Activity implements
OnClickListener {

……

@Override

public void onClick(View v) {

switch (v.getId()) {

case R.id.send_notice:

NotificationManager manager = (NotificationManager)

getSystemService(NOTIFICATION_SERVICE);

Notification notification
= new Notification(R.drawable. ic_launcher, "This is ticker text",
System.currentTimeMillis());

Intent intent = new Intent(this,
NotificationActivity.class); PendingIntent pi = PendingIntent.getActivity(this,
0, intent,

PendingIntent.FLAG_CANCEL_CURRENT);

notification.setLatestEventInfo(this, "This is content title", "This is content
text", pi);

manager.notify(1, notification);

break;

default:

break;

}

}

}

可以看到，这里先是使用 Intent 表达出我们想要启动 NotificationActivity 的“意图”，然
后将构建好的 Intent 对象传入到 PendingIntent 的 getActivity()方法里，以得到 PendingIntent
的实例，接着把它作为第四个参数传入到 Notification 的 setLatestEventInfo()方法中。

现在重新运行一下程序，并点击 Send
notice 按钮，依旧会发出一条通知。然后下拉系统 状态栏，点击一下该通知，就会看到 NotificationActivity 这个活动的界面了，如图 8.3 所示。

图   8.3

咦？怎么系统状态上的通知图标还没有消失呢？是这样的，如果我们没有在代码中对该 通知进行取消，它就会一直显示在系统的状态栏上显示。解决的方法也很简单，调用 NotificationManager 的 cancel()方法就可以取消通知了。修改 NotificationActivity 中的代码， 如下所示：

public class NotificationActivity extends Activity {

@Override

protected void
onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);
setContentView(R.layout.notification_layout); NotificationManager manager =
(NotificationManager)

getSystemService(NOTIFICATION_SERVICE);

manager.cancel(1);

}

}

可以看到，这里我们在 cancel()方法中传入了 1，这个 1 是什么意思呢？还记得在创建通 知的时候给每条通知指定的 id 吗？当时我们给这条通知设置的 id 就是 1。因此，如果你想 要取消哪一条通知，就在 cancel()方法中传入该通知的 id
就行了。

8.1.2    通知的高级技巧

现在你已经掌握了创建和取消通知的方法，并且知道了如何去响应通知的点击事件。不
过通知的用法并不仅仅是这些呢，那么本节中我们就来探究一下通知更多的高级技巧。

观察 Notification 这个类，你会发现里面还有很多我们没有使用过的属性。先来看看 sound 这个属性吧，它可以在通知发出的时候播放一段音频，这样就能够更好地告知用户有通知到 来。sound 这个属性是一个 Uri 对象，所以在指定音频文件的时候还需要先获取到音频文件 对应的 URI。比如说，我们手机的/system/media/audio/ringtones 目录下有一个 Basic_tone.ogg 音频文件，那么在代码中这样就可以这样指定：

Uri soundUri =
Uri.fromFile(new File("/system/media/audio/ringtones/
Basic_tone.ogg"));

notification.sound = soundUri;

除了允许播放音频外，我们还可以在通知到来的时候让手机进行振动，使用的是 vibrate

这个属性。它是一个长整型的数组，用于设置手机静止和振动的时长，以毫秒为单位。下标为 0 的值表示手机静止的时长，下标为 1 的值表示手机振动的时长，下标为 2 的值又表示手

机静止的时长，以此类推。所以，如果想要让手机在通知到来的时候立刻振动 1 秒，然后静 止 1 秒，再振动 1 秒，代码就可以写成：

long[] vibrates = {0, 1000, 1000, 1000};
notification.vibrate = vibrates; 不过，想要控制手机振动还需要声明权限的。因此，我们还得编辑 AndroidManifest.xml文件，加入如下声明：

<manifest
xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.notificationtest"

android:versionCode="1"

android:versionName="1.0" >

……

<uses-permission
android:name="android.permission.VIBRATE" />

……

</manifest>

学会了控制通知的声音和振动，下面我们来看一下如何在通知到来时控制手机 LED 灯 的显示。

现在的手机基本上都会前置一个 LED 灯，当有未接电话或未读短信，而此时手机又处 于锁屏状态时，LED 灯就会不停地闪烁，提醒用户去查看。我们可以使用 ledARGB、ledOnMS、 ledOffMS 以及 flags 这几个属性来实现这种效果。ledARGB 用于控制 LED 灯的颜色，一般 有红绿蓝三种颜色可选。ledOnMS 用于指定 LED 灯亮起的时长，以毫秒为单位。ledOffMS 用于指定 LED 灯暗去的时长，也是以毫秒为单位。flags 可用于指定通知的一些行为，其中 就包括显示 LED 灯这一选项。所以，当通知到来时，如果想要实现 LED 灯以绿色的灯光一 闪一闪的效果，就可以写成：

notification.ledARGB = Color.GREEN;
notification.ledOnMS = 1000; notification.ledOffMS = 1000;

notification.flags = Notification.FLAG_SHOW_LIGHTS;

当然，如果你不想进行那么多繁杂的设置，也可以直接使用通知的默认效果，它会根据
当前手机的环境来决定播放什么铃声，以及如何振动，写法如下：

notification.defaults = Notification.DEFAULT_ALL;

注意，以上所涉及的这些高级技巧都要在手机上运行才能看得到效果，模拟器是无法表
现出振动、以及 LED 灯闪烁等功能的。