Android 消息通知栏用法详解(二) 适配8.0

通知(Notification) 是Android 系统比较有特色的一个功能，当某个应用程序希望向用户发出一些提示信息的时，而该应用程序又处于后台，就可以借助通知来实现。比如微信弹窗。通过这篇文章，我们将学习到

Notification 的基本用法
Notification 声音、优先级、多文字和大图片的显示
Notification 高级玩法
自定义 Notification 的布局

官网 Nitification 资料

一、基本用法

通知可以在广播、activity 或者 service 去创建，不过在 activity 创建得比较少，一般都是应用在后台了，才需要去弄，不过我们是demo，所以写哪都没关系。

创建通知的基本步骤如下：

使用getSystemService 拿到 NotificationManager 的管理类
使用NotificationCompat 设置标题、内容、图片等
最后调用 NotificationManager 的 notify() 调出通知栏

上面中，为什么要使用 NotificationCompat 呢，因为Android系统的每一个版本都会对通知这部分功能进行或多或少的修改，API 比较不稳定，所以这里使用 v4 的包去兼容，当然，如果你使用 androidx，也就没啥问题了。
所以，一个简单的通知实例如下：

以下代码建议在8.0之下运行，8.0以上，请参考下一篇文章

首先创建 NotificationManager

mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);

 mBuilder = new NotificationCompat.Builder(this)          .setContentTitle("这是标题")          .setContentText("我是内容，我是demo")          .setWhen(System.currentTimeMillis())          .setSmallIcon(R.mipmap.ic_launcher)          .setLargeIcon(BitmapFactory.decodeResource(getResources(),R.mipmap.ic_launcher));   //通过 builder.build() 拿到 notification  mNotificationManager.notify(1, mBuilder.build());

解释如下：

setContentTitle 为设置标题
setContentText 为正文内容
setWhen 为通知创建时间，以 ms 为单位
setSmallIcon 通知的小图标，注意只能使用纯 alpha 图层的图片进行设置
setLargeIcon 通知栏的大图标

都设置完成之后，只要使用 nofity() 即可，其中，第一个参数为 id，后面用来取消通知的。所以随便填一个数字即可,效果如下。

可以看到，小图标是灰色的。当然了，google 要求是 alpha 的图层呢。
什么是纯 alpha 的图层图片呢？通俗来讲，就是图片不要带颜色就可以了，当然UI设计师肯定知道，就是用 alpha 层去绘制图片吗，咱们也可以从阿里巴巴的图片库下载，比如：

然后咱们设置一下

但是，发现默认还是灰色的，这里可以使用 setcolor 去设置：

 .setColor(getResources().getColor(R.color.colorPrimary))

这里咱们就设置好了小图标了

1.1 设置点击事件

一般的通知栏都是可以点击的，但是我们点击了一下，发现并没有什么用。当然，我们都没设置点击事件。
notification 的点击事件，可以通过设置 setContentIntent 来实现。它需要传递一个 PendingIntent。从而实现点击之后的跳转意图。
PendingIntent 的用法也很简单，它可以通过 getActivity()，getBroadcast() 和 getService() 来获取不同的实例，一个简单获取 activity 的方法如下：

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

它的参数也比较简单，第一个为 context，第二个为 requestCode，一般用不到，intent 即你要跳转的意图。第四个参数有5种选择，分别如下：

FLAG_CANCEL_CURRENT：如果当前系统中已经存在一个相同的 PendingIntent 对象，那么就将先将已有的 PendingIntent 取消，然后重新生成一个 PendingIntent 对象。
FLAG_IMMUTABLE：创建的PendingIntent不可变，API23加入。
FLAG_NO_CREATE：如果当前系统中不存在相同的 PendingIntent 对象，系统将不会创建该 PendingIntent 对象而是直接返回 null 。
FLAG_ONE_SHOT：该 PendingIntent 只作用一次。
FLAG_UPDATE_CURRENT：如果系统中已存在该 PendingIntent 对象，那么系统将保留该 PendingIntent 对象，但是会使用新的 Intent 来更新之前 PendingIntent 中的 Intent 对象数据，例如更新 Intent 中的 Extras。

一般第四个传输，传递 0 或者FLAG_CANCEL_CURRENT 都可以。
所以，我们的通知代码改一下：

        mBuilder = new NotificationCompat.Builder(this)                 .setContentTitle("这是标题")                 .setContentText("我是内容，我是demo")                 .setWhen(System.currentTimeMillis())                 .setSmallIcon(R.mipmap.ic_launcher)                 .setLargeIcon(BitmapFactory.decodeResource(getResources(),R.mipmap.ic_launcher))                 .setContentIntent(pi);         //通过 builder.build() 拿到 notification         mNotificationManager.notify(1, mBuilder.build());

1.2 取消通知

点击之后，发现确实跳转了，但是通知栏还在。取消共有两种方式

setAutoCancel(true) 在builder 那里，添加自动取消的功能
mNotificationManager.cancel(1); 通过取消 id 取消,如果有 tag ，也可以使用 cancel(tag,id) 来取消

1.3 通知更新

更新通知，只需要重新 notify 相同的 id 即可，如果通知栏还在，则更新内容，如果不存在，则增加一个新的通知栏，如下，我们更新一下内容：

 mBuilder.setContentText("我更新了内容"); mNotificationManager.notify(1,mBuilder.build());

二、通知栏效果

上面，咱们只是简单的实现了通知栏，但是一些好玩的效果，咱们并没有实现，这节，一起来看看通知栏的效果。

(请用真机测试)

2.1 声音

很多通知栏，都有声音的效果，同样，我们也可以设置。使用 setSound 即可实现，比如：

mBuilder = new NotificationCompat.Builder(this)  ...         //这个看各自的手机的铃声的路径          .setSound(Uri.fromFile(new File("system/media/audio/notifications/Argon.ogg")))          .setAutoCancel(true);

除了自定义，还可以使用默认铃声：

.setDefaults(NotificationCompat.DEFAULT_SOUND)

2.2 震动

除了声音，还可以让手机震动，使用的是 setVibrate，它的参数为一个 long 的数组，以 ms 为单位，如果我们想让手机震动1s，延时一秒，再震动一次，当然，它需要向申请权限

.setVibrate(new long[]{0,1000,1000,1000})

同理，也可以使用默认震动效果：

.setDefaults(NotificationCompat.DEFAULT_VIBRATE)

2.3 LED灯

现在手机都LED灯，在手机息屏或者未接来电灯，还是还有必要的。同样，可以使用 setLights() 来实现效果。它又三个参数，第一个是设置灯的颜色，第二个是灯亮的时间，第三个则是灯暗的时间。如下：

.setLights(Color.RED,1000,1000)

同理，用默认的

.setDefaults(NotificationCompat.DEFAULT_LIGHTS)

ps：在国内百花齐放的环境中，上面那玩意基本无效，只能看各自的厂商的说明文档去适配了。

如果你觉得，上面的设置太麻烦，还有一个方法，直接全部设置成默认的：

.setDefaults(NotificationCompat.DEFAULT_ALL)

三、Notification 的高级玩法

在实际应用中，我们常常需要配合一下实际场所来灵活应用通知栏。比如长文字，打图片、回复信息、或者跳转等。下面一起来学习。

3.1 优先级

优先级在 7.1 及以下有用，8.0 则使用 channel 来设置。
通知栏是可以设置优先级的，它有5个常亮可以选

PRIORITY_DEFAULT 默认优先级
PRIORITY_MIN 优先级最低，某个特定场合才显示
PRIORITY_LOW 优先级较低，系统可能将这类通知缩小，或者改变它的显示位置，比如靠后的位置
PRIORITY_HIGH 表示较高程度，系统可能对它进行方法，或者改变位置，比如靠前的位置
PRIORITY_MAX 优先级最高，这类通知会让用户立刻看到

比如，我们设置了 PRIORITY_MAX ，直接回显示出通知栏的效果：

3.2 setStyle 展开式通知

很多时候，我们想显示一段比较长的文字，或者一个比较大的图片，使用默认的 setContentText 或者 setLargeIcon 是不行的，但是可以使用 setStyle ，setStyle 可以让通知栏变大来显示通知。

3.2.1 长文字

比如，显示一段长文字：

.setStyle(new NotificationCompat.BigTextStyle().bigText("我是内容，我是demo\n我不是测试\n 我是长文字啊"))

效果如下：

3.2.2 大图片

设置一张图片：

  .setLargeIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.update_app_top_bg))               .setStyle(new NotificationCompat.BigPictureStyle()                       .bigPicture(BitmapFactory.decodeResource(getResources(),                       R.mipmap.update_app_top_bg)).bigLargeIcon(null)               )

3.3 添加按钮

一个通知最多可以提供三个操作按钮，然该用户可以快速响应，比如暂停，上一曲下一曲这些常用的按钮，这里，可以通过 addAction 去编写，并把 PendingIntent 关联进去，比如广播：

mBuilder = new NotificationCompat.Builder(this)     ......        .addAction(R.mipmap.enter,"上一曲",pi)        .addAction(R.mipmap.enter,"开始",pi)        .addAction(R.mipmap.enter,"下一曲",pi);

效果如下：

3.4 添加回复操作

google 在 Android 7.0 (API 24) 中引入允许用户直接回复的的组件，使用 RemoeInput 设置好key，并把它交给 action，即可实现。先看效果

首先，创建 RemoteInput.Builder() 的实例，并设置好 key 值，这个后面在 intent 会拿到。
然后，创建 PendingIntent，为了方便实验，添加一个广播
最后，创建 Action，把 remoteInput 和 pendingIntent 穿进去，代码如下：

 private NotificationCompat.Action getRemoveAction(){     //添加一个回复组件，     RemoteInput remoteInput = new RemoteInput.Builder(REPLY_KEY)             .build();     //添加一个 pendingIntent 的广播     PendingIntent replyPi = PendingIntent.getBroadcast(this,2,             new Intent("com.zhengsr.test"),PendingIntent.FLAG_UPDATE_CURRENT);     //构建 action     NotificationCompat.Action action = new NotificationCompat.Action.Builder(R.mipmap.enter,             "回复",replyPi).addRemoteInput(remoteInput).build();     return action; }

然后直接添加 action 即可：

        mBuilder = new NotificationCompat.Builder(this)   ....                .addAction(getRemoveAction())            ;

3.4.1 拿到回复内容

如果想要拿到用户的输入内容，则可以调用 RemoteInput.getResultsFromIntent(intent) ，即可拿到 Bundle 并拿到数据，如：

    class  MyBroadcastReceiver extends BroadcastReceiver{        @Override        public void onReceive(Context context, Intent intent) {            Bundle bundle = RemoteInput.getResultsFromIntent(intent);            if (bundle != null) {                String replay = bundle.getString(REPLY_KEY);                Log.d(TAG, "zsr onReceive: "+replay);            }        }    }

同样，也可以使用 NotificationCompat.MessagingStyle 去专门传递消息。具体参考官方资料。

3.5 显示进度条

通知栏还可以显示进度条，在 builder 中使用 setProgress。

setProgress(int max, int progress, boolean indeterminate)

参数都能看得明白。比如，当我们开始的进度条，可以设置为：

setProgress(100,0,false)

更新的话，直接改变 progress 即可，如果想要取消，则 setProgress(0,0,false)就可

3.6 显示紧急通知

在某些情况下，就算屏幕锁屏了，一些通知还是要显示的，比如电话，闹钟等。当然，通知栏也支持，根据设备的情况，会分两种情况

设备锁定：如果设备锁定了，则显示全屏的 Acitivyt，直接覆盖全屏
设备为锁定：则还是以通知栏的形式出现

可以通过设置 setFullScreenIntent(PendingIntent intent ,boolean highPriority) 来设置,如：

        mBuilder = new NotificationCompat.Builder(this)                .setContentTitle("紧急通知")                .setContentText("这是一条紧急通知")                .setWhen(System.currentTimeMillis())                ..                .setFullScreenIntent(pi,true)

其中 pi 为你要跳转的 PendingIntent。除了默认的情况，还可以通过设置 setVisibility(int visibility) 来设置锁屏屏幕的范围，共有三种选择：

VISIBILITY_PUBLIC 显示通知的完整内容。
VISIBILITY_SECRET 不在锁定屏幕上显示该通知的任何部分。
VISIBILITY_PRIVATE 显示基本信息，例如通知图标和内容标题，但隐藏通知的完整内容。你如，显示"您有三条新短信"，但是发件人和内容不可见。

四、自定义布局

一般情况下，系统的通知，并不能满足我们的需求，且为了保证每个版本的样式统一。都会采用自定义布局的形式。
需要注意的是。在创建自定义布局的时候，我们需要提供两个 layout，一个收起的视图，它的高度上限为 64dp。一个是展开之后，它的上限为 256dp。

4.1 为内容区域创建自定义布局

一般的自定义布局中，我们可以借助通用模板去构建一个基本布局，即保留时间戳，通知图标等装饰，而自定义由标题和文本内容的区域。
这个时候，可以使用 NotificationCompat.DecoratedCustomViewStyle 设置到 style 中，一般步骤如下：

构建基本通知，使用NotificationCompat.Builder
调用 setStyle().想其传递 NotificationCompat.DecoratedCustomViewStyle 实例
将其自定义布局扩展为 RemoveteViews 实例
调用 setCustomContentView 设置收起的通知布局
调用 setCustomBigContentView 设置扩展的通知布局

如果为多媒体播放控件创建自定义通知。可以使用NotificationCompat.DecoratedMediaCustomViewStyle 类

例如：

RemoteViews cusRemoveView = new RemoteViews(getPackageName(),R.layout.cus_notify_small);     RemoteViews cusRemoveExpandView = new RemoteViews(getPackageName(),R.layout.cus_notify_large);     mBuilder = new NotificationCompat.Builder(this)             .setWhen(System.currentTimeMillis())             .setSmallIcon(R.mipmap.ic_launcher)             .setStyle(new NotificationCompat.DecoratedCustomViewStyle())             .setCustomContentView(cusRemoveView)             .setCustomBigContentView(cusRemoveExpandView);

其中，当我们在自定义布局时，通知的背景颜色可能因为版本而异，如果要跟随系统，在设置 TextView 控件时，可以使用 TextAppearance_Compat_Notification 样式，比如标题的TextAppearance_Compat_Notification_Title。这样就能保证在不同版本中，textview 始终是正常显示的。比如 R.layout_cus_notify_small:

注意，目前layout只支持 LinearLayout、FrameLayout、RelativeLayout三种基本布局

<?xml version="1.0" encoding="utf-8"?>

而，R.layout_cus_notify_large 中，给其中一个 TextView设置红色，不设置 style，看看效果：

避免在 RemoteViews 上设置背景颜色，可能会导致文办颜色无法读取的问题

4.2 创建完全的自定义通知背景

如果你不想用系统的时间戳，通知图标等。可以去掉 setStyle(),只添加 setCustomContentView 和 setCustomBigContentView 即可。

要支持低于 Android 4.1（API 级别 16）的 Android 版本，您还应调用 setContent()，向其传递同一 RemoteViews 对象。

如需获取更多使用通知的示例代码，请参阅 Android 通知示例。

Android(安卓)消息通知栏用法详解(一)