Android通知---创建通知(附加代码)
1. 创建基本通知
(1) 创建基本通知
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("textTitle")
.setContentText("textContent")
.setPriority(NotificationCompat.PRIORITY_DEFAULT); //设置通知重要性,支持 Android 7.1 及更低版本，使用 NotificationCompat.Builder 对象设置通知的内容和渠道。以下示例展示了如何创建包含以下内容的通知：
-
小图标，通过 setSmallIcon() 设置。这是所必需的唯一用户可见内容。
-
标题，通过 setContentTitle() 设置。
-
正文文本，通过 setContentText() 设置。
-
通知优先级，通过 setPriority() 设置。优先级决定了通知在 Android 7.1 及更低版本上的干扰程度。对于 Android 8.0 及更高版本，请改为设置渠道重要性，如下一部分所示。
NotificationCompat.Builder 构造函数要求您提供渠道 ID。这是与 Android 8.0（API 级别 26）及更高版本兼容所必需的，但被早期版本忽略。
默认情况下，通知的文字内容会被截断以放在一行。您可以通过创建展开式通知显示更多信息。
图 1. 处于收起和展开状态的展开式通知
如果想要更长的通知，可以使用 setStyle() 添加样式模板，以启用可展开的通知。后面会介绍.
(2) 创建渠道并设置重要性
先将 NotificationChannel 的实例传递给 createNotificationChannel(),在系统中注册应用的通知渠道，然后才能在 Android 8.0 及更高版本上发送通知.
NotificationChannel 构造函数需要一个 importance，它使用 NotificationManager 类中的一个常量。此参数确定对于属于此渠道的任何通知，如何干扰用户。将优先级设置为 setPriority()，以支持 Android 7.1 及更低版本，如上例所示。
private void createNotificationChannel() {
// Android 8.0 及更高版本上发送通知,需要创建NotificationChannel
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
int importance = NotificationManager.IMPORTANCE_DEFAULT;//设置通知重要性,针对Android 8.0 及更高版本上; 用setPriority()以支持 Android 7.1 及更低版本，
NotificationChannel channel = new NotificationChannel("channel_id", "channel_name", importance);
channel.setDescription("channel_description");
// 向系统注册通知渠道,此后您无法更改重要性或其他通知行为。
NotificationManager notificationManager = getSystemService(NotificationManager.class);
notificationManager.createNotificationChannel(channel);
}
}(3) 设置通知的点按操作
如需显示通知，请调用 NotificaitonManagerCompat.notify() , 并向其传递通知的唯一 ID 和 NotificationCompat.Builder.build() 的结果。具体可见以下示例：
int NOTIFICATION_ID = 10 ; //唯一标识该通知,在更新和清除通知时需要
notificationManager.notify(NOTIFICATION_ID, builder.build());注意: 从 Android 8.1（API 级别 27）开始，应用每秒最多只能发出一次通知提示音。如果应用在一秒内发布了多条通知，这些通知都会按预期显示，但每秒中只有第一条通知会发出声音。
2 . 创建大文本通知 : BigTextStyle
void createBigTextStyleNotification() {
Intent intent = new Intent(this, MainActivity1.class);
PendingIntent pendingIntent = PendingIntent.getActivity(MainActivity.this, 0, intent, PendingIntent.FLAG_MUTABLE);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("BigTextStyle")
.setContentText("hi i am big text style notification")
.setContentIntent(pendingIntent);
//设置 BigTextStyle
.setStyle(new NotificationCompat.BigTextStyle()
.bigText("Much longer text that cannot fit one line...") //设置需要显示的内容
.setBigContentTitle("通知列表中,通知展开后,显示的标题") )
.setPriority(NotificationCompat.PRIORITY_DEFAULT);
NotificationManager notificationManager = (NotificationManager.class);
NotificationChannel channel = new NotificationChannel("11", "channel-name", NotificationManager.IMPORTANCE_DEFAULT);
notificationManager.createNotificationChannel(channel);
notificationManager.notify(11, builder.build());
}3 . 创建大图片通知 : BigpictureStyle
void createBigPictureStyleNotification() {
Intent intent = new Intent(this, MainActivity1.class);
PendingIntent pendingIntent = PendingIntent.getActivity(MainActivity.this, 0, intent, PendingIntent.FLAG_MUTABLE);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("BigPictureStyle")
.setContentText("hi i am big picture style notification")
.setContentIntent(pendingIntent);
//设置 BigPictureStyle
.setStyle(new NotificationCompat.BigPictureStyle()
.bigPicture(BitmapFactory.decodeResource(getResources(), R.drawable.pictiure)) //设置需要展示的图片
.setBigContentTitle("通知列表中,通知展开后,显示的标题") )
.setPriority(NotificationCompat.PRIORITY_DEFAULT);
NotificationManager notificationManager = (NotificationManager.class);
NotificationChannel channel = new NotificationChannel("11", "channel-name", NotificationManager.IMPORTANCE_DEFAULT);
notificationManager.createNotificationChannel(channel);
notificationManager.notify(11, builder.build());
}4 . 创建带操作按钮的通知
通知最多可以提供三个操作按钮，以便用户快速响应，例如暂停提醒或回复短信。但这些操作按钮不能重复用户在 点按通知 时执行的操作。添加操作按钮，通过 addAction() 添加按钮的动作. 下面例子中,设定第一个Button的name="确定",点击后跳转到MainActivity1; 设定第二个Button的name="取消",点击后跳转到MainActivity2;
void createActionNotification() {
Intent intent1 = new Intent(MainActivity.this, MainActivity1.class);
Intent intent2 = new Intent(MainActivity.this, MainActivity2.class);
PendingIntent PendingIntent1 = PendingIntent.getActivity(MainActivity.this, 0, intent1, PendingIntent.FLAG_MUTABLE);
PendingIntent PendingIntent2 = PendingIntent.getActivity(MainActivity.this, 0, intent2, PendingIntent.FLAG_MUTABLE);
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("Action Notification")
.setContentText("hi i am action notification")
.setColorized(true)
.setColor(Color.RED) //设置颜色
.setSubText("重要提醒") //设置 通知显示的一些附加信息
.addAction(R.mipmap.ic_launcher_round, "确定", PendingIntent1) //添加第一个按钮
.addAction(R.mipmap.ic_launcher_round, "取消", PendingIntent2) //添加第二个按钮
.setPriority(NotificationCompat.PRIORITY_DEFAULT);
NotificationManager notificationManager = (NotificationManager.class);
NotificationChannel channel = new NotificationChannel("11", "channel-name", NotificationManager.IMPORTANCE_DEFAULT);
notificationManager.createNotificationChannel(channel);
notificationManager.notify(11, builder.build());
}效果如下:
注意 ：在 Android 10（API 级别 29）及更高版本中，如果应用不提供自己的通知操作按钮，平台会自动生成通知操作按钮。如果您不希望应用通知显示任何建议的回复或操作，可以使用 setAllowGeneratedRepies() 和 setAllowSystemGneratedContextualActions() 选择停用系统生成的回复和操作。
5. 创建带直接回复的通知
Android 7.0（API 级别 24）中引入的直接回复操作,可在通知中输入文本。然后，文本会传递给应用，而不会打开 activity。例如，您可以使用直接回复操作，让用户从通知中回复短信.
void createResultNotification() {
//1.定义回复的操作
Intent replyIntent = new Intent();
replyIntent.setAction("reply"); //定义广播的Action
replyIntent.setClass(MainActivity.this, NotificationReceiver.class);//如需要接收广播,请自行实现NotificationReceiver.class
PendingIntent replyPendingIntent = PendingIntent.getBroadcast(MainActivity.this, (int) SystemClock.uptimeMillis(), replyIntent, PendingIntent.FLAG_MUTABLE);
//2.默认的回复内容,可以不设置
CharSequence[] choices = {"A.参加", "B.不参加", "C.需要考虑,晚间再回复"};
//3.添加回复按钮
RemoteInput remoteInput = new RemoteInput.Builder("key_text_reply") //key_text_reply是唯一标识该回复按钮
.setLabel("请输入回复的内容") //输入框的提示文字
.setChoices(choices)
.setEditChoicesBeforeSending(RemoteInput.EDIT_CHOICES_BEFORE_SENDING_DISABLED)//设置是否能编辑默认的回复内容
.build();
//4.创建回复操作并添加远程输入
NotificationCompat.Action action = new NotificationCompat.Action.Builder(R.drawable.icon, "快速回复", replyPendingIntent) //输入编辑框的入口,点击该按钮后,便可编辑回复的内容,按钮的text="快速回复",有些手机定制化原因,可能会不显示,如下面例子
.addRemoteInput(remoteInput) //添加远程输入
.setAllowGeneratedReplies(false)
.build();
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("聚餐通知")
.setContentText("请问今晚您会参加聚餐活动吗?")
.setColorized(true)
.setColor(Color.BLUE) //设置颜色
.setSubText("工作通知") //设置 通知显示的一些附加信息
.addAction(action)
.setPriority(NotificationCompat.PRIORITY_DEFAULT);
NotificationManager notificationManager = (NotificationManager.class);
NotificationChannel channel = new NotificationChannel("11", "channel-name", NotificationManager.IMPORTANCE_DEFAULT);
notificationManager.createNotificationChannel(channel);
notificationManager.notify(11, builder.build());
}当用户触发通知操作时，系统会提示用户输入回复,效果如下图:
(1) 从回复中检索用户输入
如需从通知的回复界面接收用户输入，调用 RemoteInput.getResultsFromIntent(), 在广播的onReceive() 中处理新通知.
private CharSequence getMessageText(Intent intent) {
Bundle remoteInput = RemoteInput.getResultsFromIntent(intent);
if (remoteInput != null) {
return remoteInput.getCharSequence(KEY_TEXT_REPLY); //获取远程输入的内容
}
return null;
}KEY_TEXT_REPLY 是在上一图中3.添加回复按钮RemoteInput 中定义的.
6. 创建带进度条的通知
通知可以包含动画形式的进度指示器，向用户显示正在进行的操作的状态。如下所示:
通过setProgress( int max, int progress, boolean false) ,操作在任何时间的完成进度，其中第一个参数是设置进度条的最大值(如100),默认为0; 第二个参数是当前的进度值。最后一个是否在通知中显示通知进度值。其中,通过在后台不断调用setProgress( int max, int progress, boolean false),将更新的progress当前值更新到通知中.
void createProgressNotification() {
int PROGRESS_MAX = 100; //最大值
int PROGRESS_CURRENT = 0; //当前值
NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "channel_id")
.setSmallIcon(R.drawable.notification_icon)
.setContentTitle("Picture Download")
.setContentText("Download in progress")
.setPriority(NotificationCompat.PRIORITY_LOW)
.setLargeIcon(BitmapFactory.decodeResource(getResources(),R.drawable.icon)) //设置大图片
.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false); // 设置进度, false:显示进度
NotificationManager notificationManager = (NotificationManager.class);
NotificationChannel channel = new NotificationChannel("11", "channel-name", NotificationManager.IMPORTANCE_DEFAULT);
notificationManager.createNotificationChannel(channel);
notificationManager.notify(11, builder.build());
//模拟后台更新进度
new Thread(new Runnable() {
@Override
public void run() {
for (int i = 0; i < PROGRESS_MAX ; i++) { //
builder.setProgress(PROGRESS_MAX ,i,false);
notificationManager.notify(15,builder.build());
builder.setContentText("下载中..."+i+"%");
try {
Thread.sleep(50);
}catch (InterruptedException e){
e.printStackTrace();
}
}
//当前进度值到达 PROGRESS_MAX=100 后,重新设置通知的标题和内容
builder.setContentTitle("start install!!")
.setContentText("installing.....")
.setProgress(0,0,true); //移除进度条
notificationManager.notify(15,builder.build());
try {
//清除通知
Thread.sleep(4000);
notificationManager.cancel(15);
}catch (InterruptedException e){
e.printStackTrace();
}
}
}).start();
}操作结束时，当前进度 progress 必须等于设定的最大值 max。当完成进度时,可以通过 setProgress(0,0,false) 来移除进度条.
如需显示不定的进度条（不指示完成百分比的进度条），调用 setProgress(0, 0, true)。器。
显示进度的效果如下所示:
