写点什么

Notification(状态栏通知) 详解

作者:向阳逐梦
  • 2023-03-17
    四川
  • 本文字数:3942 字

    阅读完需:约 13 分钟

Notification(状态栏通知)详解

Android 中用于在状态栏显示通知信息的控件:Notification,相信大部分学 Android 都对他都很熟悉,而网上很多关于 Notification 的使用教程都是基于 2.x 的,而现在普遍的 Android 设备基本都在 4.x 以上,甚至是 5.0 以上的都有;他们各自的 Notification 都是不一样的!而本节给大家讲解的是基于 4.x 以上的 Notification。

1.设计文档部分解读

1)Notification 的基本布局


上面的组成元素依次是:
Icon/Photo:大图标 Title/Name:标题 Message:内容信息 Timestamp:通知时间,默认是系统发出通知的时间,也可以通过setWhen()来设置 Secondary Icon:小图标 内容文字,在小图标的左手边的一个文字
复制代码

2)扩展布局

在 Jelly Bean 中你可以为通知提供更多事件的细节。你可以通过扩展布局显示消息的前几行或者图片的预览。这样用户可以看多更多的内容 - 有时甚至可以看到整个消息。用户可以通过 pinch-zoom 或者双手指滑动来打开扩展布局。Android 为单条消息提供了两种扩展布局 (文字和图像) 供你开发应用时使用。
复制代码


2.Notification 的基本使用流程

状态通知栏主要涉及到 2 个类:Notification 和 NotificationManager

Notification:通知信息类,它里面对应了通知栏的各个属性

NotificationManager:是状态栏通知的管理类,负责发通知、清除通知等操作。

使用的基本流程:

  • Step 1. 获得 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()方法取消通知

3.设置相关的一些方法

Notification.Builder mBuilder = new Notification.Builder(this);

后再调用下述的相关的方法进行设置:(官方 API 文档:Notification.Builder)常用的方法如下:

  • 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,而是返回 NULLFLAG_CANCEL_CURRENT 表示相应的 PendingIntent 已经存在,则取消前者,然后创建新的 PendingIntent,这个有利于数据保持为最新的,可以用于即时通信的通信场景 FLAG_UPDATE_CURRENT 表示更新的 PendingIntent。

使用示例:

//点击后跳转ActivityIntent intent = new Intent(context,XXX.class);  PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);  mBuilder.setContentIntent(pendingIntent)  
复制代码
  • setPriority(int):设置优先级:

对应属性:Notification.PRIORITY_HIGH

4.代码示例:最常见的 Notification:

下面我们来写一个最简单的例子来体验下 Notification 的用法:

运行效果图

关键代码

这里直接贴 MainActivity.java 的代码:

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 btn_show_normal; private Button btn_close_normal;

@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mContext = MainActivity.this; //创建大图标的Bitmap LargeBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.iv_lc_icon); mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); bindView();
}

private void bindView() { btn_show_normal = (Button) findViewById(R.id.btn_show_normal); btn_close_normal = (Button) findViewById(R.id.btn_close_normal); btn_show_normal.setOnClickListener(this); btn_close_normal.setOnClickListener(this); }

@Override public void onClick(View v) { switch (v.getId()) { case R.id.btn_show_normal: //定义一个PendingIntent点击Notification后启动一个Activity Intent it = new Intent(mContext, OtherActivity.class); PendingIntent pit = PendingIntent.getActivity(mContext, 0, it, 0);
//设置图片,通知标题,发送时间,提示方式等属性 Notification.Builder mBuilder = new Notification.Builder(this); mBuilder.setContentTitle("叶良辰") //标题 .setContentText("我有一百种方法让你呆不下去~") //内容 .setSubText("——记住我叫叶良辰") //内容下面的一小段文字 .setTicker("收到叶良辰发送过来的信息~") //收到信息后状态栏显示的文字信息 .setWhen(System.currentTimeMillis()) //设置通知时间 .setSmallIcon(R.mipmap.ic_lol_icon) //设置小图标 .setLargeIcon(LargeBitmap) //设置大图标 .setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //设置默认的三色灯与振动器 .setSound(Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.biaobiao)) //设置自定义的提示音 .setAutoCancel(true) //设置点击后取消Notification .setContentIntent(pit); //设置PendingIntent notify1 = mBuilder.build(); mNManager.notify(NOTIFYID_1, notify1); break;
case R.id.btn_close_normal: //除了可以根据ID来取消Notification外,还可以调用cancelAll();关闭该应用产生的所有通知 mNManager.cancel(NOTIFYID_1); //取消Notification break;
} }}
复制代码


发布于: 刚刚阅读数: 5
用户头像

向阳逐梦

关注

人生享受编程,编程造就人生! 2022-06-01 加入

某公司芯片测试工程师,嵌入式开发工程师,InfoQ签约作者,阿里云星级博主,华为云·云享专家。座右铭:向着太阳,追逐梦想!

评论

发布
暂无评论
Notification(状态栏通知)详解_android_向阳逐梦_InfoQ写作社区