Java / 状态栏通知:Notification

状态栏通知:Notification

Notification 是一种可以在 App 之外给用户弹出消息通知的控件,当我们告诉系统有一个消息需要通知用户的时候,系统首先会在通知栏展示一个 icon,然后通过下拉通知栏我们可以查看详细的通知内容。非常适合于在推送新闻、好友消息、广告等场景使用,目前几乎所有的 App 都有这种类型的通知,大家平时在使用 Android 系统的时候一定会经常遇到,今天我们就一起来学习这种通知方式的用法。

1. Notification 的特性

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

Notification通知栏样式

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

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)

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

  • 设置小图标
    mBuilder.setSmallIcon(R.drawable.notification_icon);
    
  • 设置通知标题
    mBuilder.setContentTitle("Notification Alert, Click Me!");
    
  • 设置通知内容
    mBuilder.setContentText("Hi, This is Android Notification Detail!");
    

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);     

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

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
notificationManager.notify(notificationID, builder.build());

其中 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>

样式效果如下:
新课程通知

3.2.2 编写 MainActivity 逻辑

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

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

代码如下:

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());
   }
}

弹出的通知样式如下:

Notification列表样式

注意: 在代码中我们为 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>

然后创建一个空白的 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);
   }
}

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

NotificationActivity

4. 小结

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

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