状态通知栏主要涉及到2个类:Notification 和NotificationManager
Notification:通知信息类,它里面对应了通知栏的各个属性
NotificationManager:是状态栏通知的管理类,负责发通知、清除通知等操作。
使用的基本流程:
- Step1. 获得NotificationManager对象:NotificationManager mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
- Step 2. 创建一个通知栏的Builder构造类:Notification.Builder mBuilder = new Notification.Builder(this);
- Step 3. 对Builder进行相关的设置,比如标题,内容,图标,动作等!
- Step 4.调用Builder的build()方法为notification赋值
- Step 5.调用NotificationManager的notify()方法发送通知!
- PS:另外我们还可以调用NotificationManager的cancel()方法取消通知
Notification.Builder mBuilder = new Notification.Builder(this);
后再调用下述的相关的方法进行设置:常用的方法如下:
- setContentTitle(CharSequence):设置标题
- setContentText(CharSequence):设置内容
- setSubText(CharSequence):设置内容下面一小行的文字
- setTicker(CharSequence):设置收到通知时在顶部显示的文字信息
- setWhen(long):设置通知时间,一般设置的是收到通知时的System.currentTimeMillis()
- setSmallIcon(int):设置右下角的小图标,在接收到通知的时候顶部也会显示这个小图标
- setLargeIcon(Bitmap):设置左边的大图标
- setAutoCancel(boolean):用户点击Notification点击面板后是否让通知取消(默认不取消)
- setDefaults(int):向通知添加声音、闪灯和振动效果的最简单、使用默认(defaults)属性,可以组合多个属性,
Notification.DEFAULT_VIBRATE(添加默认震动提醒);
Notification.DEFAULT_SOUND(添加默认声音提醒);
Notification.DEFAULT_LIGHTS(添加默认三色灯提醒)
Notification.DEFAULT_ALL(添加默认以上3种全部提醒)- setVibrate(long[]):设置振动方式,比如:
setVibrate(new long[] {0,300,500,700});延迟0ms,然后振动300ms,在延迟500ms,接着再振动700ms,关于Vibrate用法后面会讲解!- setLights(int argb, int onMs, int offMs):设置三色灯,参数依次是:灯光颜色,亮持续时间,暗的时间,不是所有颜色都可以,这跟设备有关,有些手机还不带三色灯;另外,还需要为Notification设置flags为Notification.FLAG_SHOW_LIGHTS才支持三色灯提醒!
setSound(Uri):设置接收到通知时的铃声,可以用系统的,也可以自己设置,例子如下:
.setDefaults(Notification.DEFAULT_SOUND) //获取默认铃声
.setSound(Uri.parse("file:///sdcard/xx/xx.mp3")) //获取自定义铃声
.setSound(Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, "5"))//获取Android多媒体库内的铃声setOngoing(boolean):设置为ture,表示它为一个正在进行的通知。他们通常是用来表示一个后台任务,用户积极参与(如播放音乐)或以某种方式正在等待,因此占用设备(如一个文件下载,同步操作,主动网络连接)
- setProgress(int,int,boolean):设置带进度条的通知参数依次为:进度条最大数值,当前进度,进度是否不确定如果为确定的进度条:调用setProgress(max, progress, false)来设置通知,在更新进度的时候在此发起通知更新progress,并且在下载完成后要移除进度条,通过调用setProgress(0, 0, false)既可。如果为不确定(持续活动)的进度条,这是在处理进度无法准确获知时显示活动正在持续,所以调用setProgress(0, 0, true),操作结束时,调用setProgress(0, 0, false)并更新通知以移除指示条
setContentIntent(PendingIntent):PendingIntent和Intent略有不同,它可以设置执行次数,主要用于远程服务通信、闹铃、通知、启动器、短信中,在一般情况下用的比较少。比如这里通过Pending启动Activity:getActivity(Context, int, Intent, int),当然还可以启动Service或者BroadcastPendingIntent的位标识符(第四个参数):
FLAG_ONE_SHOT 表示返回的PendingIntent仅能执行一次,执行完后自动取消
FLAG_NO_CREATE 表示如果描述的PendingIntent不存在,并不创建相应的PendingIntent,而是返回NULL
FLAG_CANCEL_CURRENT 表示相应的PendingIntent已经存在,则取消前者,然后创建新的PendingIntent,这个有利于数据保持为最新的,可以用于即时通信的通信场景
FLAG_UPDATE_CURRENT 表示更新的PendingIntent
使用示例://点击后跳转Activity Intent intent = new Intent(context,XXX.class); PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0); mBuilder.setContentIntent(pendingIntent)
Intent intent = new Intent(context,XXX.class); PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0); mBuilder.setContentIntent(pendingIntent)setPriority(int):设置优先级:
对应属性:Notification.PRIORITY_HIGH...
优先级 用户 MAX 重要而紧急的通知,通知用户这个事件是时间上紧迫的或者需要立即处理的。 HIGH 高优先级用于重要的通信内容,例如短消息或者聊天,这些都是对用户来说比较有兴趣的。 DEFAULT 默认优先级用于没有特殊优先级分类的通知。 LOW 低优先级可以通知用户但又不是很紧急的事件。 MIN 用于后台消息 (例如天气或者位置信息)。最低优先级通知将只在状态栏显示图标,只有用户下拉通知抽屉才能看到内容。
实例效果图如下:
MainActivity.java的代码如下:
package com.deepreality.notificationdemo;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
private Context mContext;
private NotificationManager mNManager;
private Notification notify1;
Bitmap LargeBitmap = null;
private static final int NOTIFYID_1 = 1;
private Button btnNotificationShow, btnNotificationClose;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
componentInit();
componentAddOnClickListener();
mContext = MainActivity.this;
//获得通知消息管理类对象
mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
//获取大图标
LargeBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.iv_lol_icon1);
}
public void componentInit() {
btnNotificationShow = findViewById(R.id.main_btnNotificationShow);
btnNotificationClose = findViewById(R.id.main_btnNotificationClose);
}
public void componentAddOnClickListener() {
btnNotificationShow.setOnClickListener(this);
btnNotificationClose.setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.main_btnNotificationShow:{
//定义一个PendingIntent点击Notification后启动一个Activity
Intent intent = new Intent(MainActivity.this,NotificationActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(mContext, 0, intent, 0);
//设置图片,通知标题,发送时间,提示方式等属性
Notification.Builder builder = new Notification.Builder(mContext);
builder.setContentTitle("北极熊也有微笑") //标题
.setContentText("北极熊是本人认为最棒的动物,没有之一") //内容
.setSubText("--北极熊很Happy~") //内容下面的一小段文字
.setTicker("收到北极熊也有微笑发来的的消息~") //收到信息后状态栏显示的文字信息
.setWhen(System.currentTimeMillis()) //系统显示时间
.setSmallIcon(R.mipmap.ic_launcher) //收到信息后状态栏显示的小图标
.setLargeIcon(LargeBitmap) //大图标
.setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //设置默认的三色灯与振动器
.setDefaults(Notification.DEFAULT_SOUND) //设置系统的提示音
.setAutoCancel(true); //设置点击后取消Notification
builder.setContentIntent(pendingIntent); //绑定PendingIntent对象
notify1 = builder.build();
mNManager.notify(NOTIFYID_1, notify1);
break;
}
case R.id.main_btnNotificationClose:{
//除了可以根据ID来取消Notification外,还可以调用cancelAll();关闭该应用产生的所有通知
mNManager.cancel(NOTIFYID_1);//取消Notification
//mNManager.cancelAll();//关闭该应用产生的所有通知
break;
}
default:break;
}
}
}
备注:其中相关的Activity以及图片等其他文件,自行处理。
特别注意:
一、如果传递数据到相应的Activity,数据接收不到的解决方法:(最后一个参数很重要!!!)
Intent intent = new Intent(mContext, NotificationActivity.class);
Bundle bundle = new Bundle();
bundle.putSerializable("notice", tb_notice);
intent.putExtras(bundle);
PendingIntent pendingIntent = PendingIntent.getActivity(mContext, tb_notice.getId(), intent, PendingIntent.FLAG_UPDATE_CURRENT);
二、针对于Android8.0以上的兼容
特别注意:Android8.0以上必须添加 渠道 才能显示通知!!!
//Android8.0以上必须添加 渠道 才能显示通知栏 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { //创建渠道 String id = "my_channel_01"; String name="渠道名字"; NotificationChannel mChannel = new NotificationChannel(id, name, NotificationManager.IMPORTANCE_LOW); notificationManager.createNotificationChannel(mChannel); //设置图片,通知标题,发送时间,提示方式等属性 NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext, id); builder.setContentTitle("北极熊也有微笑") //标题 .setContentText("北极熊是本人认为最棒的动物,没有之一") //内容 .setSubText("--北极熊很Happy~") //内容下面的一小段文字 .setTicker("收到北极熊也有微笑发来的的消息~") //收到信息后状态栏显示的文字信息 .setWhen(System.currentTimeMillis()) //系统显示时间 .setSmallIcon(R.mipmap.ic_launcher) //收到信息后状态栏显示的小图标 .setLargeIcon(LargeBitmap)//大图标 .setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //设置默认的三色灯与振动器 .setDefaults(Notification.DEFAULT_SOUND) //设置系统的提示音 .setAutoCancel(true); //设置点击后取消Notification builder.setContentIntent(pendingIntent); //绑定PendingIntent对象 notification1 = builder.build(); notificationManager.notify(1, notification1); } else { //设置图片,通知标题,发送时间,提示方式等属性 Notification.Builder builder = new Notification.Builder(mContext); builder.setContentTitle("北极熊也有微笑") //标题 .setContentText("北极熊是本人认为最棒的动物,没有之一") //内容 .setSubText("--北极熊很Happy~") //内容下面的一小段文字 .setTicker("收到北极熊也有微笑发来的的消息~") //收到信息后状态栏显示的文字信息 .setWhen(System.currentTimeMillis()) //系统显示时间 .setSmallIcon(R.mipmap.ic_launcher) //收到信息后状态栏显示的小图标 .setLargeIcon(LargeBitmap)//大图标 .setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //设置默认的三色灯与振动器 .setDefaults(Notification.DEFAULT_SOUND) //设置系统的提示音 .setAutoCancel(true); //设置点击后取消Notification builder.setContentIntent(pendingIntent); //绑定PendingIntent对象 notification1 = builder.build(); notificationManager.notify(1, notification1); }