Notificationhtml
Notification,俗稱通知,是一種具備全局效果的通知,它展現在屏幕的頂端,首先會表現爲一個圖標的形式,當用戶向下滑動的時候,展現出通知具體的內容。android
注意:由於一些Android版本的兼容性問題,對於Notification而言,Android3.0是一個分水嶺,在其以前構建Notification推薦使用Notification.Builder構建,而在Android3.0以後,通常推薦使用NotificationCompat.Builder構建。本文的全部代碼環境均在4.3中完成,若是使用4.1一下的設備測試,請注意兼容性問題。數組
通知通常經過NotificationManager服務來發送一個Notification對象來完成,NotificationManager是一個重要的系統級服務,該對象位於應用程序的框架層中,應用程序能夠經過它像系統發送全局的通知。這個時候須要建立一個Notification對象,用於承載通知的內容。可是通常在實際使用過程當中,通常不會直接構建Notification對象,而是使用它的一個內部類NotificationCompat.Builder來實例化一個對象(Android3.0之下使用Notification.Builder),並設置通知的各類屬性,最後經過NotificationCompat.Builder.build()方法獲得一個Notification對象。當得到這個對象以後,可使用NotificationManager.notify()方法發送通知。app
NotificationManager類是一個通知管理器類,這個對象是由系統維護的服務,是以單例模式得到,因此通常並不直接實例化這個對象。在Activity中,可使用Activity.getSystemService(String)方法獲取NotificationManager對象,Activity.getSystemService(String)方法能夠經過Android系統級服務的句柄,返回對應的對象。在這裏須要返回NotificationManager,因此直接傳遞Context.NOTIFICATION_SERVICE便可。框架
雖然通知中提供了各類屬性的設置,可是一個通知對象,有幾個屬性是必需要設置的,其餘的屬性均是可選的,必須設置的屬性以下:ide
更新與移除通知函數
在使用NotificationManager.notify()發送通知的時候,須要傳遞一個標識符,用於惟一標識這個通知。對於有些場景,並非無限的添加新的通知,有時候須要更新原有通知的信息,這個時候能夠重寫構建Notification,而使用與以前通知相同標識符來發送通知,這個時候舊的通知就被被新的通知所取代,起到更新通知的效果。佈局
對於一個通知,當展現在狀態欄以後,可是使用事後,如何取消呢?Android爲咱們提供兩種方式移除通知,一種是Notification本身維護,使用setAutoCancel()方法設置是否維護,傳遞一個boolean類型的數據。另一種方式使用NotificationManager通知管理器對象來維護,它經過notify()發送通知的時候,指定的通知標識Id來操做通知,可使用cancel(int)來移除一個指定的通知,也可使用cancelAll()移除全部的通知。測試
使用NotificationManager移除指定通知示例:ui
1 NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); 2 mNotificationManager.cancel(0);
PendingIntent
對於一個通知而言,它顯示的消息是有限的,通常僅用於提示一些概要信息。可是通常簡短的消息,並不能表達須要告訴用戶的所有內容,因此須要綁定一個意圖,當用戶點擊通知的時候,調用一個意圖展現出一個Activity用來顯示詳細的內容。而Notification中,並不使用常規的Intent去傳遞一個意圖,而是使用PendingIntent。
先來聊聊Intent和PendingIntent的區別,PendingIntent能夠看作是對Intent的包裝,經過名稱能夠看出PendingIntent用於處理即將發生的意圖,而Intent用來處理立刻發生的意圖。而對於通知來講,它是一個系統級的全局的通知,並不肯定這個意圖被執行的時間。當在應用外部執行PendingIntent時,由於它保存了觸發App的Context,使得外部App能夠若是當前App同樣執行PendingIntent裏的Intent,就算執行時觸發通知的App已經不存在了,也能經過存在PendingIntent裏的Context照常執行Intent,而且還能夠處理Intent所帶來的額外的信息。
PendingIntent提供了多個靜態的getXxx()方法,用於得到適用於不一樣場景的PendingIntent對象。通常須要傳遞的幾個參數都很常規,只介紹一個flag參數,用於標識PendingIntent的構造選擇:
Notification視覺風格
Notification有兩種視覺風格,一種是標準視圖(Normal view)、一種是大視圖(Big view)。標準視圖在Android中各版本是通用的,可是對於大視圖而言,僅支持Android4.1+的版本。
從官方文檔瞭解到,一個標準視圖顯示的大小要保持在64dp高,寬度爲屏幕標準。標準視圖的通知主體內容有一下幾個:
下面經過一個示例,模仿上面效果的通知。
btnNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Bitmap btm = BitmapFactory.decodeResource(getResources(), R.drawable.msg); NotificationCompat.Builder mBuilder = new NotificationCompat.Builder( MainActivity.this).setSmallIcon(R.drawable.msg) .setContentTitle("5 new message") .setContentText("twain@android.com"); mBuilder.setTicker("New message");//第一次提示消息的時候顯示在通知欄上 mBuilder.setNumber(12); mBuilder.setLargeIcon(btm); mBuilder.setAutoCancel(true);//本身維護通知的消失 //構建一個Intent Intent resultIntent = new Intent(MainActivity.this, ResultActivity.class); //封裝一個Intent PendingIntent resultPendingIntent = PendingIntent.getActivity( MainActivity.this, 0, resultIntent, PendingIntent.FLAG_UPDATE_CURRENT); // 設置通知主題的意圖 mBuilder.setContentIntent(resultPendingIntent); //獲取通知管理器對象 NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(0, mBuilder.build()); } });
顯示效果:
而對於大視圖(Big View)而言,它的細節區域只能顯示256dp高度的內容,而且只對Android4.1+以後的設備才支持,它比標準視圖不同的地方,均須要使用setStyle()方法設定,它大體的效果以下:
setStyle()傳遞一個NotificationCompat.Style對象,它是一個抽象類,Android爲咱們提供了三個實現類,用於顯示不一樣的場景。分別是:
若是僅僅顯示一個圖片,使用BigPictureStyle是最方便的;若是須要顯示一個富文本信息,則可使用BigTextStyle;若是僅僅用於顯示一個文本的信息,那麼使用InboxStyle便可。後面會以一個示例來展現InboxStyle的使用,模仿上面圖片的顯示。
實現代碼:
btnBigViewNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Bitmap btm = BitmapFactory.decodeResource(getResources(), R.drawable.msg); Intent intent = new Intent(MainActivity.this, ResultActivity.class); PendingIntent pendingIntent = PendingIntent.getActivity( MainActivity.this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT); Notification noti = new NotificationCompat.Builder( MainActivity.this) .setSmallIcon(R.drawable.msg) .setLargeIcon(btm) .setNumber(13) .setContentIntent(pendingIntent) .setStyle( new NotificationCompat.InboxStyle() .addLine( "M.Twain (Google+) Haiku is more than a cert...") .addLine("M.Twain Reminder") .addLine("M.Twain Lunch?") .addLine("M.Twain Revised Specs") .addLine("M.Twain ") .addLine( "Google Play Celebrate 25 billion apps with Goo..") .addLine( "Stack Exchange StackOverflow weekly Newsl...") .setBigContentTitle("6 new message") .setSummaryText("mtwain@android.com")) .build(); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(0, noti); } });
展現效果:
進度條樣式的通知
對於一個標準通知,有時候顯示的消息並不必定是靜態的,還能夠設定一個進度條用於顯示事務完成的進度。
Notification.Builder類中提供一個setProgress(int max,int progress,boolean indeterminate)方法用於設置進度條,max用於設定進度的最大數,progress用於設定當前的進度,indeterminate用因而否是一個肯定進度只的進度條。經過indeterminate的設置,能夠實現兩種不一樣樣式的進度條,一種是有進度的(false),一種是循環流動的(false)。下面分別用兩個示例演示:
有進度的進度條,實現代碼:
btnProgreNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); builder = new NotificationCompat.Builder(MainActivity.this) .setSmallIcon(R.drawable.ic_launcher) .setContentTitle("Picture Download") .setContentText("Download in progress"); builder.setAutoCancel(true); //經過一個子線程,動態增長進度條刻度 new Thread(new Runnable() { @Override public void run() { int incr; for (incr = 0; incr <= 100; incr += 5) { builder.setProgress(100, incr, false); manager.notify(0, builder.build()); try { Thread.sleep(300); } catch (InterruptedException e) { Log.i(TAG, "sleep failure"); } } builder.setContentText("Download complete") .setProgress(0, 0, false); manager.notify(0, builder.build()); } }).start(); } });
顯示效果:
對於循環流動的進度條,下面是實現代碼:
btnProNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { manager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); builder = new NotificationCompat.Builder(MainActivity.this) .setSmallIcon(R.drawable.ic_launcher) .setContentTitle("Picture Download") .setContentText("Download in progress"); builder.setProgress(0, 0, true);//設置爲true,表示流動 manager.notify(0, builder.build()); //5秒以後還中止流動 new Thread(new Runnable() { @Override public void run() { try { Thread.sleep(5000); } catch (InterruptedException e) { e.printStackTrace(); } builder.setProgress(100, 100, false);//設置爲true,表示刻度 manager.notify(0, builder.build()); } }).start(); } });
效果展現:
自定義通知
和Toast同樣,通知也可使用自定義的XML來自定義樣式,可是對於通知而言,由於它的全局性,並不能簡單的經過inflate膨脹出一個View,由於可能觸發通知的時候,響應的App已經關閉,沒法獲取當指定的XML佈局文件。因此須要使用單獨的一個RemoteViews類來操做。
RemoteViews,描述了一個視圖層次的結構,能夠顯示在另外一個進程。層次結構也是從佈局文件中「膨脹」出一個視圖,這個類,提供了一些基本的操做求改其膨脹的內容。
RemoteViews提供了多個構造函數,通常使用RemoteViews(String packageName,int layoutId)。第一個參數爲包的名稱,第二個爲layout資源的Id。當獲取到RemoteViews對象以後,可使用它的一系列setXxx()方法經過控件的Id設置控件的屬性。最後使用NotificationCompat.Builder.setContent(RemoteViews)方法設置它到一個Notification中。
下面經過一個示例展現它:
自定義的佈局XML代碼:
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:padding="10dp" > <ImageView android:id="@+id/imageNo" android:layout_width="wrap_content" android:layout_height="match_parent" android:layout_alignParentLeft="true" android:layout_marginRight="10dp" /> <TextView android:id="@+id/titleNo" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_toRightOf="@id/imageNo" /> <TextView android:id="@+id/textNo" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_below="@id/titleNo" android:layout_toRightOf="@id/imageNo" /> </RelativeLayout>
實現代碼:
btnCustomNotification.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { RemoteViews contentViews = new RemoteViews(getPackageName(), R.layout.custom_notification); //經過控件的Id設置屬性 contentViews .setImageViewResource(R.id.imageNo, R.drawable.btm1); contentViews.setTextViewText(R.id.titleNo, "自定義通知標題"); contentViews.setTextViewText(R.id.textNo, "自定義通知內容"); Intent intent = new Intent(MainActivity.this, ResultActivity.class); PendingIntent pendingIntent = PendingIntent.getActivity( MainActivity.this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT); NotificationCompat.Builder mBuilder = new NotificationCompat.Builder( MainActivity.this).setSmallIcon(R.drawable.ic_launcher) .setContentTitle("My notification") .setTicker("new message"); mBuilder.setAutoCancel(true); mBuilder.setContentIntent(pendingIntent); mBuilder.setContent(contentViews); mBuilder.setAutoCancel(true); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(10, mBuilder.build()); } });
效果展現:
設定提示響應
對於有些通知,須要調用一些設備的資源,使用戶能更快的發現有新通知,通常可設定的響應有:鈴聲、閃光燈、震動。對於這三個屬性,NotificationCompat.Builder提供了三個方法設定:
大多數時候,咱們並不須要設定一個特定的響應效果,只須要遵守用戶設備上系統通知的效果便可,那麼可使用setDefaults(int)方法設定默認響應參數,在Notification中,對它的參數使用常量定義了,咱們只需使用便可:
而在Android中,若是須要訪問硬件設備的話,是須要對其進行受權的,因此須要在清單文件AndroidManifest.xml中增長兩個受權,分別授予訪問振動器與閃光燈的權限:
<!-- 閃光燈權限 --> <uses-permission android:name="android.permission.FLASHLIGHT"/> <!-- 振動器權限 --> <uses-permission android:name="android.permission.VIBRATE"/>
由於只是一個屬性的設定,而且大部分時候,使用系統設定便可,這裏就不提供代碼示例了。