Notification 是一种可以在 App 之外给用户弹出消息通知的控件,当我们告诉系统有一个消息需要通知用户的时候,系统首先会在通知栏展示一个 icon,然后通过下拉通知栏我们可以查看详细的通知内容。非常适合于在推送新闻、好友消息、广告等场景使用,目前几乎所有的 App 都有这种类型的通知,大家平时在使用 Android 系统的时候一定会经常遇到,今天我们就一起来学习这种通知方式的用法。
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)
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 里面要做的事也比较简单,大体上只有两件事:
在点击“弹出课程通知”的时候创建 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()); } }
注意: 在代码中我们为 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 精彩内容" /> </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。
4. 小结
本节介绍了一个可以长时间停留,并且样式更丰富的通知消息,再点击的时候能够跳转到指定的 Activity 执行相应的业务逻辑。
为了更好的对 Notification 做定制化需求,系统为我们提供了一个 Builder 用于设置各种属性及样式,在创建之后通过NotificationManager来弹出通知,并且可以通过PendingIntent设置点击通知之后的跳转页面,只要按照正确的流程来使用,Notification 还是非常简单易用的。