状态栏通知：Notification-知识专区-汉码未来

当前位置： Java > 状态栏通知：Notification

admin · 更新于 2021-08-06

1. Notification 的特性

在上一节我们学习了 Toast，它提供了一种简单易用的展示提示信息的方法，但是它只能做短暂的提示，而相比之下，Notification 可以让消息长时间的停留在通知栏，适合于一些内容比较多并且需要长时间停留的消息通知。通常在顶部通知栏会有 icon 显示，有些手机甚至会配上 LED 灯的闪烁，如图：

如果想要看详细的通知内容，可以通过下拉的方式展开通知列表，然后点击我们想要看的通知栏目即可，如图：

2. Notification 的基本使用

我们可以直接创建 Notification，但是这样不利于我们设置自己的样式，好在 Android 系统为 Notification 提供了一个构建者，我们可以通过 Builder 来自定义各种属性，Builder 常用 API 如下：

setAutoCancel(boolean autoCancel)：
设置当用户点击通知之后，通知是否要自动消失。
setContent(RemoteViews views) ：
设置一个自定义的 View 来替换系统标准的 View，从而实现自定义通知样式。
setContentInfo(CharSequence info)：
设置通知的大文本内容（通常位于通知的右边）。
setContentIntent(PendingIntent intent)：
设置一个PendingIntent供Notification被点击的时候使用。
setContentText(CharSequence text)：
设置通知的内容文本。
setContentTitle(CharSequence title)：
设置通知的标题文本。
setDefaults(int defaults)：
设置Notification的默认选项。
setSmallIcon(int icon)：
设置通知的小 icon（通常位于右下角）。
setLargeIcon(Bitmap bitmap)：
设置通知的大 icon（通常位于左边）。
setTicker(CharSequence ticker)：
设置收到通知时在系统顶部显示的提示内容。
setWhen(long when)：
设置通知的时间，通知列表会按照这个值进行排序。
setVibrate(long[] pattern)：
设置收到通知时的振动频率。
setLights(int argb, int onMs, int offMs)：
设置 LED 灯样式（需要设备支持且设置 Flag 为Notification.FLAG_SHOW_LIGHTS），方法参数依次是：灯光颜色，亮的时长，灭的时长。
setSound(Uri uri)：
设置接收到通知时的铃声。
setOngoing(boolean ongoing)：
设置当前是否正在进行一个通知。

3. Notification 使用示例

3.1 Notification 的创建与展示

Android 系统为我们提供了一套非常简单的方法去创建 Notification，只需要按照以下步骤即可轻松使用：
Step 1：创建 Notification Builder
创建 Notification 之前我们要构建一个 Notification Builder，关于 Builder 我们在前文中提到过，通过它我们可以设置 Notification 各种各样的属性，比如大小图标、标题、内容、优先级等等，创建 Builder 的方式很简单，通过以下代码即可完成创建：

NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this)代码块
1

Step 2：设置 Notification 属性
一旦创建了 Builder，我们就可以通过它设置 Notification 的属性从而实现我们的需求了。从第 2 小节中我们了解到 Builder 的 API 非常之多，其实大多数 API 是很少用的，我们只需要了解就好，而以下 3 个是系统强制要求设置的：

设置小图标

mBuilder.setSmallIcon(R.drawable.notification_icon);代码块
1

设置通知标题

mBuilder.setContentTitle("Notification Alert, Click Me!");代码块
1

设置通知内容

mBuilder.setContentText("Hi, This is Android Notification Detail!");代码块
1

Step 3：绑定事件
这一步是一个可选项，如果你有一些复杂的逻辑需要执行，那么可以给 Notification 绑定一个事件，让用户在点击通知栏的时候能够跳转到对应的 Activity 中完成相应的操作。
我们通过一个 PendingIntent 来完成绑定，PendingIntent 中包含一个可以启动 Activity 的 Intent。然后使用setContentIntent(PendingIntent intent)接口将 PendingIntent 和通知关联上，这样在通知列表中点击相应的通知就可以跳转到对应的 Activity 当中了，使用方法如下：

Intent intent = new Intent(context, Destination.class);PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);Notification.Builder builder = new Notification.Builder(this);mBuilder.setContentIntent(pendingIntent);     代码块
1
2
3
4

Step 4：展示通知
最后，我们可以通过设置好的 Builder 构造出我们想要的 Notification，然后调用NotificationManager.notify()通知系统展示通知，示例代码如下：

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);notificationManager.notify(notificationID, builder.build());代码块
1
2

其中 notificationID 是当前通知的唯一 ID，后续可以它来更新Notification。

3.2 Notification 完整示例

如果你安装了汉码未来 App，那么一定收到过一些精彩课程的推送信息，接下来我们就一起通过 Notification 完成一个新课程的更新通知。

3.2.1 编写布局

首先提供一个 Button 用于触发新课程的推送，然后一个 Button 用于取消这条推送，为了样式的美观，我们在加上一条App的标题和内容信息。整个的布局比较简单，主要由 4 个元素组成，代码如下：

<RelativeLayout 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:paddingBottom="@dimen/activity_vertical_margin"
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   tools:context="MainActivity">
   
   <TextView
      android:id="@+id/tv_title"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Android Study"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true"
      android:textSize="30dp" />
      
   <TextView
      android:id="@+id/tv_content"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="汉码未来新课程通知"
      android:textColor="#ff87ff09"
      android:textSize="30dp"
      android:layout_below="@+id/tv_title"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="48dp" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="取消课程通知"
      android:id="@+id/bt_cancel"
      android:layout_marginTop="62dp"
      android:layout_below="@+id/bt_show"
      android:layout_centerHorizontal="true" />
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/bt_show"
      android:text="弹出课程通知"
      android:layout_below="@+id/tv_content"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="42dp" /></RelativeLayout>代码块
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

样式效果如下：

3.2.2 编写 MainActivity 逻辑

MainActivity 里面要做的事也比较简单，大体上只有两件事：

在点击“弹出课程通知”的时候创建 Builder 并通过设置相应的属性及提示信息，接着构造 Notification 并展示；
点击“取消课程通知”，则隐藏掉已经弹出的课程通知。

代码如下：

package com.emercy.myapplication;import android.app.Activity;import android.app.Notification;import android.app.NotificationManager;import android.app.PendingIntent;import android.content.Context;import android.content.Intent;import android.os.Bundle;import android.view.View;import android.widget.Button;public class MainActivity extends Activity {
   NotificationManager mManager;
   
   private static final int NOTIFICATION_ID = 0;
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      ((Button)findViewById(R.id.bt_show)).setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            addNotification();
         }
      });
      ((Button) findViewById(R.id.bt_cancel)).setOnClickListener(new View.OnClickListener() {
          @Override
          public void onClick(View v) {
        	  if (mManager != null) {
        		  mManager.cancel(NOTIFICATION_ID);
        	  }
          }
       });
   }

   private void addNotification() {
      Notification.Builder builder = new Notification.Builder(this)
         .setSmallIcon(R.drawable.icon)
         .setContentTitle("汉码未来 Android 教程更新")
         .setContentText("状态栏通知：Notification");
      
      Intent notificationIntent = new Intent(this, NotificationActivity.class);
      PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT);
      builder.setContentIntent(contentIntent);

      mManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
      mManager.notify(NOTIFICATION_ID, builder.build());
   }}代码块
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

弹出的通知样式如下：

注意：在代码中我们为 Notification 设置了 PendingIntent，而 PendingIntent 是通过一个 Intent 构造出来的，通过这个 Intent 我们可以将 Notification 和 NotificationActivity 绑定上，从而实现点击 Notification 跳转到相应 Activity 的功能，页面样式如下：

3.2.3 编写 NotificationActivity 及其布局页面

当用户在下拉通知菜单中点击我们弹出的 Notification 后，就可以进入推送的新课程页面了，这里就简单放一个TextView表示新课程的内容：

<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent" >
   
   <TextView
      android:layout_width="match_parent"
      android:layout_height="400dp"
      android:text="想要学习更多 Android 精彩内容，请登录汉码未来官方网站，跟着超哥学 Android" /></LinearLayout>代码块
1
2
3
4
5
6
7
8
9
10

然后创建一个空白的 NotificationActivity，设置布局为以上文件：

package com.emercy.myapplication;import android.os.Bundle;import android.app.Activity;public class NotificationActivity extends Activity{
   @Override
   public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.notification);
   }}代码块
1
2
3
4
5
6
7
8
9
10
11

在通知列表中点击我们的 Notification 会跳转到课程的详情页，也就是 NotificationActivity，如下：

4. 小结

本节介绍了一个可以长时间停留，并且样式更丰富的通知消息，再点击的时候能够跳转到指定的 Activity 执行相应的业务逻辑。

为了更好的对 Notification 做定制化需求，系统为我们提供了一个 Builder 用于设置各种属性及样式，在创建之后通过NotificationManager来弹出通知，并且可以通过PendingIntent设置点击通知之后的跳转页面，只要按照正确的流程来使用，Notification 还是非常简单易用的。