[关闭]
@coder-pig 2015-09-29T11:56:52.000000Z 字数 6039 阅读 2057

Android基础入门教程——2.5.2 Notification(状态栏通知)详解

Android基础入门教程


本节引言:

本节带来的是Android中用于在状态栏显示通知信息的控件:Notification,相信大部分
学Android都对他都很熟悉,而网上很多关于Notification的使用教程都是基于2.x的,而
现在普遍的Android设备基本都在4.x以上,甚至是5.0以上的都有;他们各自的Notification
都是不一样的!而本节给大家讲解的是基于4.x以上的Notification,而5.0以上的Notification
我们会在进阶教程的Android 5.0新特性的章节进行讲解~
官方文档对Notification的一些介绍:
设计思想Notifications in Android 4.4 and Lower 译文通知
API文档Notification
访问上述网站,可能需要梯子哦~


1.设计文档部分解读


1)Notification的基本布局

上面的组成元素依次是:

  • Icon/Photo:大图标
  • Title/Name:标题
  • Message:内容信息
  • Timestamp:通知时间,默认是系统发出通知的时间,也可以通过setWhen()来设置
  • Secondary Icon:小图标
  • 内容文字,在小图标的左手边的一个文字

2)扩展布局

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


关于其他一些设计的东西,就不一一提及了,有兴趣的自行查看上面提供的API文档,知道下
这个Notification在4.x以上的版本可以多种多样就好!我们更多的时候关注的是
如何写代码使用这个东西,下面我们就来学习下Notification的用法!


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或者Broadcast
    PendingIntent的位标识符(第四个参数):
    FLAG_ONE_SHOT 表示返回的PendingIntent仅能执行一次,执行完后自动取消
    FLAG_NO_CREATE 表示如果描述的PendingIntent不存在,并不创建相应的PendingIntent,而是返回NULL
    FLAG_CANCEL_CURRENT 表示相应的PendingIntent已经存在,则取消前者,然后创建新的PendingIntent,
    这个有利于数据保持为最新的,可以用于即时通信的通信场景
    FLAG_UPDATE_CURRENT 表示更新的PendingIntent
    使用示例:
  1. //点击后跳转Activity
  2. Intent intent = new Intent(context,XXX.class);
  3. PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
  4. mBuilder.setContentIntent(pendingIntent)
  • setPriority(int):设置优先级:
优先级 用户
MAX 重要而紧急的通知,通知用户这个事件是时间上紧迫的或者需要立即处理的。
HIGH 高优先级用于重要的通信内容,例如短消息或者聊天,这些都是对用户来说比较有兴趣的。
DEFAULT 默认优先级用于没有特殊优先级分类的通知。
LOW 低优先级可以通知用户但又不是很紧急的事件。
MIN 用于后台消息 (例如天气或者位置信息)。最低优先级通知将只在状态栏显示图标,只有用户下拉通知抽屉才能看到内容。

对应属性:Notification.PRIORITY_HIGH...


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

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

运行效果图

关键代码

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

  1. public class MainActivity extends AppCompatActivity implements View.OnClickListener {
  2. private Context mContext;
  3. private NotificationManager mNManager;
  4. private Notification notify1;
  5. Bitmap LargeBitmap = null;
  6. private static final int NOTIFYID_1 = 1;
  7. private Button btn_show_normal;
  8. private Button btn_close_normal;
  9. @Override
  10. protected void onCreate(Bundle savedInstanceState) {
  11. super.onCreate(savedInstanceState);
  12. setContentView(R.layout.activity_main);
  13. mContext = MainActivity.this;
  14. //创建大图标的Bitmap
  15. LargeBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.iv_lc_icon);
  16. mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
  17. bindView();
  18. }
  19. private void bindView() {
  20. btn_show_normal = (Button) findViewById(R.id.btn_show_normal);
  21. btn_close_normal = (Button) findViewById(R.id.btn_close_normal);
  22. btn_show_normal.setOnClickListener(this);
  23. btn_close_normal.setOnClickListener(this);
  24. }
  25. @Override
  26. public void onClick(View v) {
  27. switch (v.getId()) {
  28. case R.id.btn_show_normal:
  29. //定义一个PendingIntent点击Notification后启动一个Activity
  30. Intent it = new Intent(mContext, OtherActivity.class);
  31. PendingIntent pit = PendingIntent.getActivity(mContext, 0, it, 0);
  32. //设置图片,通知标题,发送时间,提示方式等属性
  33. Notification.Builder mBuilder = new Notification.Builder(this);
  34. mBuilder.setContentTitle("叶良辰") //标题
  35. .setContentText("我有一百种方法让你呆不下去~") //内容
  36. .setSubText("——记住我叫叶良辰") //内容下面的一小段文字
  37. .setTicker("收到叶良辰发送过来的信息~") //收到信息后状态栏显示的文字信息
  38. .setWhen(System.currentTimeMillis()) //设置通知时间
  39. .setSmallIcon(R.mipmap.ic_lol_icon) //设置小图标
  40. .setLargeIcon(LargeBitmap) //设置大图标
  41. .setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //设置默认的三色灯与振动器
  42. .setSound(Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.biaobiao)) //设置自定义的提示音
  43. .setAutoCancel(true) //设置点击后取消Notification
  44. .setContentIntent(pit); //设置PendingIntent
  45. notify1 = mBuilder.build();
  46. mNManager.notify(NOTIFYID_1, notify1);
  47. break;
  48. case R.id.btn_close_normal:
  49. //除了可以根据ID来取消Notification外,还可以调用cancelAll();关闭该应用产生的所有通知
  50. mNManager.cancel(NOTIFYID_1); //取消Notification
  51. break;
  52. }
  53. }
  54. }

注释很详细,就不一一细讲了~


5.代码示例下载:

NotificationDemo.zip


本节小结:

好的,本节给大家介绍了Notification在4.x版本的基本用法,非常简单是吧~
当然你也可以自定义Notification有兴趣的可以自己查阅相关资料,这里就不慢慢
研究了~对了,本节部分内容参考的下述blog,贴下链接,大家也可以去看下:
Android 通知栏Notification的整合 全面学习 (一个DEMO让你完全了解它)
写得蛮详细的~本节就到这里,谢谢~

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注