Notification-通知
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 = "消息内容:美指责“中国放大俄罗斯在乌克兰问题上的声音”,中国驻美使馆回击!";
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 = "消息内容:美指责“中国放大俄罗斯在乌克兰问题上的声音”,中国驻美使馆回击!"; 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());
...
这里还增加了setLargeIcon(bitmap)
来设置通知的大图标。
图片通知
类似的还可以设置一张可收起展开的图片通知,设置style:setStyle(new NotificationCompat.BigPictureStyle().bigLargeIcon(null).bigPicture(bitmap))
:
以上就是通知的常用场景,当然通知还有一些高级用法,比如和前台服务结合的下载进度条、媒体控制等。