Link: www.jianshu.com/p/d2051a785…
Demo: github.com/czy1121/Not…
1. 简单用法
创建通知
创建通知至少包含 小图标、标题、内容 才能显示
NotificationCompat.Builder builder = new NotificationCompat.Builder(this)
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("My notification")
.setContentText("Hello World!");复制代码发送通知
NotificationManager manager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());复制代码取消通知
NotificationManager manager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
// 取消notifyId关联的通知
manager.cancel(notifyId);
// 取消所有通知
manager.cancelAll();复制代码2. 基本信息
标题/内容/小图标
必要信息
// 标题
builder.setContentTitle("这是通知标题");
// 内容
builder.setContentText("这是通知内容");
// 小图标
builder.setSmallIcon(R.mipmap.ic_small_icon);复制代码大图标
大图标，未设置时使用小图标代替
// 大图标
Bitmap bitmap = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_large_icon);
builder.setLargeIcon(bitmap);复制代码次要内容
setContentInfo 在 api 24 被废弃，不再显示，用 setSubText 代替
setNumber 在 api 24 被废弃，不再显示
// 次要内容
builder.setSubText("这是通知的次要内容");
// 附加文本
builder.setContentInfo("INFO");
// 附加数字，等价于 setContentInfo, 为了显示效果用一个不同的字体尺寸显示数字
builder.setNumber(123);复制代码时间
setShowWhen 在 api 17 被添加
setChronometerCountDown 在 api 24 添加
// 设置时间
builder.setWhen(System.currentTimeMillis())
// 设置是否显示时间
builder.setShowWhen(false);
// 设置是否显示时钟表示时间(count up)
builder.setUsesChronometer(false););
// 设置时钟是否为倒计时(count down)
builder.setChronometerCountDown(false);复制代码进度条
当使用了 setSubText() 后，进度条将不显示
api 24 之后，setSubText() 不再影响进度条
int max = 100; // 进度最大值
int progress = 50; // 当前进度
int indeterminate = false; // 是否是不明确的进度条
builder.setProgress(max, progress, indeterminate);复制代码状态栏摘要(ticker)
在 api 21 后不再显示，仅用于辅助服务。
builder.setTicker("this is ticker");复制代码3. 标志符(Flags)
| Flag | 描述 |
|---|---|
| Notification.FLAG_SHOW_LIGHTS | 是否使用呼吸灯提醒 |
| Notification.FLAG_INSISTENT | 持续提醒(声音/振动)直到用户响应(点击/取消) |
| Notification.FLAG_ONLY_ALERT_ONCE | 提醒(铃声/震动/滚动通知摘要)只执行一次 |
| Notification.FLAG_ONGOING_EVENT | 正在进行中通知 |
| Notification.FLAG_AUTO_CANCEL | 用户点击通知后自动取消 |
| Notification.FLAG_NO_CLEAR | 用户无法取消 |
| Notification.FLAG_FOREGROUND_SERVICE | 表示正在运行的服务 |
设置是否使用呼吸灯提醒(FLAG_SHOW_LIGHTS)
通过 builder.setLights 或 builder.setDefaults 设置使用呼吸灯时会自动添加 FLAG_SHOW_LIGHTS
设置提醒只执行一次(FLAG_ONLY_ALERT_ONCE)
设置提醒只执行一次
builder.setOnlyAlertOnce(true);复制代码设置自动取消(FLAG_AUTO_CANCEL)
需要同时设置了 setContentIntent() 才有效
builder.setAutoCancel(true);
builder.setContentIntent(pendingIntent);复制代码设置通知为进行中(FLAG_ONGOING_EVENT)
通常表示一个用户积极参与的后台任务，比如电话，下载，播放音乐等
用户不能取消，效果类似FLAG_NO_CLEAR
用户点击通知且设置了自动取消时会被删除
builder.setOngoing(true);复制代码设置 FLAG_INSISTENT/FLAG_NO_CLEAR
NotificationCompat.Builder 未提供设置方法，只能通过 Notification
Notification n = builder.build();
// 持续提醒直到用户响应
n.flags |= Notification.FLAG_INSISTENT;
// 用户无法取消
n.flags |= Notification.FLAG_NO_CLEAR;
manager.notify(notifyId, n);复制代码4. 优先级
| 优先级 | 描述 |
|---|---|
| Notification.PRIORITY_MAX | 重要而紧急的通知，通知用户这个事件是时间上紧迫的或者需要立即处理的。 |
| Notification.PRIORITY_HIGH | 高优先级用于重要的通信内容，例如短消息或者聊天，这些都是对用户来说比较有兴趣的 |
| Notification.PRIORITY_DEFAULT | 默认优先级用于没有特殊优先级分类的通知 |
| Notification.PRIORITY_LOW | 低优先级可以通知用户但又不是很紧急的事件。只显示状态栏图标 |
| Notification.PRIORITY_MIN | 用于后台消息 (例如天气或者位置信息)。只有用户下拉通知抽屉才能看到内容 |
设置优先级
builder.setPriority(Notification.PRIORITY_HIGH);复制代码5. 提醒通知到达
提供了 铃声/振动/呼吸灯 三种提醒方式，可以使用一种或同时使用多种
使用默认提醒
| FLAG | 描述 |
|---|---|
| Notification.DEFAULT_SOUND | 添加默认声音提醒 |
| Notification.DEFAULT_VIBRATE | 添加默认震动提醒 |
| Notification.DEFAULT_LIGHTS | 添加默认呼吸灯提醒 |
| Notification.DEFAULT_ALL | 同时添加以上三种默认提醒 |
// 添加默认声音提醒
builder.setDefaults(Notification.DEFAULT_SOUND);
// 添加默认呼吸灯提醒，自动添加FLAG_SHOW_LIGHTS
builder.setDefaults(Notification.DEFAULT_LIGHTS);复制代码添加自定义提醒
// 添加自定义声音提醒
builder.setSound(Uri.parse("path/to/sound"));
// 添加自定义震动提醒
// 延迟200ms后震动300ms，再延迟400ms后震动500ms
long[] pattern = new long[]{200,300,400,500};
builder.setVibrate(pattern);
// 添加自定义呼吸灯提醒，自动添加FLAG_SHOW_LIGHTS
int argb = 0xffff0000; // led灯光颜色
int onMs = 300; // led亮灯持续时间
int offMs = 100; // led熄灯持续时间
builder.setLights(argb, onMs, offMs);复制代码6. 事件
点击内容事件
int flags = PendingIntent.FLAG_UPDATE_CURRENT;
Intent intent = new Intent(this, ResultActivity.class);
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, flags);
builder.setContentIntent(pi);复制代码取消通知事件
通知被用户取消时发送(清除所有，右滑删除)
“自动取消(FLAG_AUTO_CANCEL)”不会产生该事件
Intent intent = new Intent(ACTION);
intent.putExtra("op", op);
PendingIntent pi = PendingIntent.getBroadcast(this, 0, intent, 0);
builder.setDeleteIntent(pi);复制代码全屏通知事件
响应紧急事件(比如来电)
Intent intent = new Intent(ACTION);
intent.putExtra("op", op);
PendingIntent pi = PendingIntent.getBroadcast(this, 0, intent, 0);
builder.setFullScreenIntent(pi, true);复制代码7. 浮动通知
Android 5.0(API 21)开始支持浮动通知
设备处于活动状态(设备未锁定且其屏幕已打开)时，可显示浮动通知
满足下列条件之一可触发浮动通知：
- 用户的 Activity 处于全屏模式中（应用使用 fullScreenIntent）
- 通知具有较高的优先级(PRIORITY_MAX 或 PRIORITY_HIGH)并使用铃声或振动
注：国内各种ROM可能由于各种原因导致浮动通知不能显示
8. 锁定屏幕通知
Android 5.0(API 21)开始，通知可显示在锁定屏幕上。
可使用此功能提供媒体播放控件以及其他常用操作。
用户可以通过“设置”选择是否将通知显示在锁定屏幕上。
设置可见性
VISIBILITY_PUBLIC显示通知的完整内容。VISIBILITY_SECRET不会在锁定屏幕上显示此通知的任何部分。VISIBILITY_PRIVATE显示通知图标和内容标题等基本信息，但是隐藏通知的完整内容。
设置 VISIBILITY_PRIVATE 后，还可以通过 setPublicVersion() 提供其中隐藏了某些详细信息的替换版本通知内容。
9. 扩展布局
Android 4.1(API 16) 开始支持扩展布局，下拉抽屉中最顶部的一条通知的扩展布局自动展开
Android 7.0(API 24) 开始每条通知都可以单独展开
操作按钮
api 19 开始支持添加操作按钮，每个展开的通知可包含最多3个操作按钮
// 添加操作按钮
builder.addAction(icon1, title1, pendingIntent1);
builder.addAction(icon2, title2, pendingIntent2);复制代码样式
使用Builder.setStyle()设置扩展布局样式
多行文本通知
Notification notif = new Notification.Builder(mContext)
.setContentTitle("New mail from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_mail)
.setLargeIcon(aBitmap)
.setStyle(new Notification.BigTextStyle().bigText(aVeryLongString))
.build();复制代码大图通知
Notification notif = new Notification.Builder(mContext)
.setContentTitle("New photo from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_post)
.setLargeIcon(aBitmap)
.setStyle(new Notification.BigPictureStyle().bigPicture(aBigBitmap))
.build();复制代码收件箱通知
最多显示5行消息
Notification notif = new Notification.Builder(mContext)
.setContentTitle("5 New mails from " + sender.toString())
.setContentText(subject)
.setSmallIcon(R.drawable.new_mail)
.setLargeIcon(aBitmap)
.setStyle(new Notification.InboxStyle()
.addLine(str1)
.addLine(str2)
.setContentTitle("")
.setSummaryText("+3 more"))
.build();复制代码10. 保留 Activity 返回栈
常规 Activity
默认情况下，从通知启动一个Activity，按返回键会回到主屏幕。
但某些时候有按返回键仍然留在当前应用的需求，这就要用到TaskStackBuilder了。
1、在manifest中定义Activity的关系
<activity
android:name=".ResultActivity"
android:parentActivityName=".MainActivity">
activity>复制代码2、构建带返回栈的PendingIntent并发送通知
// 构建返回栈
TaskStackBuilder tsb = TaskStackBuilder.create(this);
tsb.addParentStack(ResultActivity.class);
tsb.addNextIntent(new Intent(this, ResultActivity.class));
// 构建包含返回栈的 PendingIntent
PendingIntent pi = tsb.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
// 构建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
...
builder.setContentIntent(pi);
// 发送通知
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());复制代码特殊Activity
默认情况下，从通知启动的Activity会在近期任务列表里出现。
如果不需要在近期任务里显示，则需要做以下操作:
1、在manifest中定义Activity
<activity
android:name=".ResultActivity"
android:launchMode="singleTask"
android:taskAffinity=""
android:excludeFromRecents="true">
activity>复制代码2、构建PendingIntent并发送通知
// 创建 Intent
Intent intent = new Intent(this, ResultActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
// 创建 PendingIntent
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
// 构建通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
...
builder.setContentIntent(pi);
// 发送通知
NotificationManager manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
manager.notify(notifyId, builder.build());复制代码Demo
github.com/czy1121/Not…
notifyapi 19 (android 4.4)
api19_big_text api19_big_pictureapi 21 (android 5.0)
api21_big_text api19_big_pictureapi21_progress_bar api21_heads_up
api 24 (android 7.0)
api24_basic api24_progress_barapi24_heads_up
参考
developer.android.com/reference/a…
developer.android.com/reference/a…
developer.android.com/guide/topic…
全面了解Android Notification
www.jianshu.com/p/22e27a639…