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 灯闪烁等功能的。