Notification-通知

通知是一种消息，这种消息呈现在应用UI之外，通过通知可以对用户进行提醒、可以和其他用户收发信息等。通过点击通知，可以唤起app页面或者直接在通知上执行一些操作。下面介绍通知的一些常用用法。

展示一条普通通知

先来看一个效果：

从这张截图上，可以看到有一条通知消息，如果要实现这个效果，参考以下实现逻辑：

private static final String CHANNEL_ID_1 = "CHANNEL_ID_1";

public void doNotify(View v) {
    NotificationManagerCompat notificationManagerCompat = NotificationManagerCompat.from(this);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel(CHANNEL_ID_1, CHANNEL_NAME_1, NotificationManager.IMPORTANCE_DEFAULT);
        notificationManagerCompat.createNotificationChannel(channel);
    }

    final String content = "独行侠大胜太阳拖入“抢七” 热火击败76人挺进东决";
    NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID_1);
    builder.setSmallIcon(android.R.drawable.ic_dialog_alert)
            .setContentTitle("通知标题")
            .setContentText(content)
            .setPriority(NotificationCompat.PRIORITY_DEFAULT);

    final int notificationId = 101;
    notificationManagerCompat.notify(notificationId, builder.build());
}

这里有几点需要说明：

NotificationManagerCompat是对NotificationManager进行了版本差异化的封装，本质为(NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
Android 8.0开始，发送任何通知前，都要先创建通知通道NotificationChannel；创建一个已存在的通知通道会被忽略，因此重复创建通知通道是安全；官方推荐是app启动时创建通道；
创建通知通道NotificationChannel的参数需要注意2点：
- channelId包内唯一；
- important参数，不同级别对用户的提醒方式和打扰程度不同如声音等，详情可以参考NotificationManager中IMPORTANCE_*说明，这里使用默认important；
创建单个通知渠道notificationManagerCompat.createNotificationChannel(channel)实际执行了mNotificationManager.createNotificationChannel(channel)(除了提供创建单个通知渠道外，内部还提供了创建多个通知渠道的重载方法：public void createNotificationChannels(@NonNull List<NotificationChannel> channels));
NotificationCompat.Builder: NotificationCompat对Notification进行了版本差异化封装，采用建造者模式创建Notification;
- builder.setSmallIcon(R.mipmap.ic_launcher): 设置通知小图标，这是一条通知的必须元素！
- setPriority(NotificationCompat.PRIORITY_DEFAULT): 7.1及以下版本，通过此方法设置通知权重，即打扰用户程度；8.0及以上版本，需要用NotificationChannel来设置相关属性。
notificationManagerCompat.notify(notificationId, builder.build()): 注意notificationId必须唯一，之后可对该通知进行更新，如下载进度更新；

这是一条最简单的通知，还没有给通知添加用户行为，下面对其增加点击交互。

通知点击交互

先看效果

从图上可以看到，A页面只有一个发送通知的按钮，而在成功发送通知并点击通知后，A页面展示了通知上的内容，通知也随即消失。要实现这个功能，只需要改造上一节的实例代码如下：

AndroidManifest.xml修改启动模式：android:launchMode="singleTop";

doNotify()方法调整：

public void doNotify(View v) {
        NotificationManagerCompat notificationManagerCompat = NotificationManagerCompat.from(this);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel(CHANNEL_ID_1, CHANNEL_NAME_1, NotificationManager.IMPORTANCE_DEFAULT);
            notificationManagerCompat.createNotificationChannel(channel);
        }

        final String content = "独行侠大胜太阳拖入“抢七” 热火击败76人挺进东决";

        Intent intent = new Intent(this, NotificationActivity.class);
        intent.putExtra("content", content);
        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);

        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID_1);
        builder.setSmallIcon(R.mipmap.ic_launcher)
                .setContentTitle("通知标题")
                .setContentIntent(pendingIntent)
                .setContentText(content)
                .setPriority(NotificationCompat.PRIORITY_DEFAULT)
                .setAutoCancel(true);

        final int notificationId = 101;
        notificationManagerCompat.notify(notificationId, builder.build());
}

这里有几点需要说明：

PendingIntent: 将Intent封装为PendingIntent, 并且标记设置flags为PendingIntent.FLAG_UPDATE_CURRENT用以设置Intent中的额外参数;
如果将flags设置为PendingIntent.FLAG_IMMUTABLE，则intent中的附加参数将不会生效;

Activity中增加onNewIntent()回调逻辑：

protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        if (intent.hasExtra("content")) {
            ((TextView) findViewById(R.id.tv_notification_content)).setText(intent.getStringExtra("content"));
        }
}

上面的例子中，可以发现消息内容被截取成了单行显示，接下来展示如何显示完整的消息。

可收起和展开的消息

文本消息：

看效果

要实现可展开收起的消息比较简单，在上述代码基础上添加一行代码即可setStyle(new NotificationCompat.BigTextStyle().bigText(content))：

...

NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID_1);
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), android.R.drawable.star_big_on);
builder.setSmallIcon(android.R.drawable.stat_notify_chat)
        .setLargeIcon(bitmap)
        .setContentTitle("通知标题")
        .setContentText(content)
        .setStyle(new NotificationCompat.BigTextStyle().bigText(content))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .setAutoCancel(true);

final int notificationId = 101;
notificationManagerCompat.notify(notificationId, builder.build());
...