(轉)android學習---Notification

原文:http://www.cnblogs.com/plokmju/p/android_Notification.html

 

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

  • 小圖標,使用setSamllIcon()方法設置。
  • 標題,使用setContentTitle()方法設置。
  • 文本內容,使用setContentText()方法設置。 

  

更新與移除通知函數

  在使用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的構造選擇:

  • FLAG_CANCEL_CURRENT:若是構建的PendingIntent已經存在,則取消前一個,從新構建一個。
  • FLAG_NO_CREATE:若是前一個PendingIntent已經不存在了,將再也不構建它。
  • FLAG_ONE_SHOT:代表這裏構建的PendingIntent只能使用一次。
  • FLAG_UPDATE_CURRENT:若是構建的PendingIntent已經存在,則替換它,經常使用。

 

Notification視覺風格

  Notification有兩種視覺風格,一種是標準視圖(Normal view)、一種是大視圖(Big view)。標準視圖在Android中各版本是通用的,可是對於大視圖而言,僅支持Android4.1+的版本。

  從官方文檔瞭解到,一個標準視圖顯示的大小要保持在64dp高,寬度爲屏幕標準。標準視圖的通知主體內容有一下幾個:

  1. 通知標題。
  2. 大圖標。
  3. 通知內容。
  4. 通知消息。
  5. 小圖標。
  6. 通知的時間,通常爲系統時間,也可使用setWhen()設置。

  下面經過一個示例,模仿上面效果的通知。

    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爲咱們提供了三個實現類,用於顯示不一樣的場景。分別是:

  • NotificationCompat.BigPictureStyle, 在細節部分顯示一個256dp高度的位圖。
  • NotificationCompat.BigTextStyle,在細節部分顯示一個大的文本塊。
  • NotificationCompat.InboxStyle,在細節部分顯示一段行文本。

  若是僅僅顯示一個圖片,使用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提供了三個方法設定:

  • setSound(Uri sound):設定一個鈴聲,用於在通知的時候響應。傳遞一個Uri的參數,格式爲「file:///mnt/sdcard/Xxx.mp3」。
  • setLights(int argb, int onMs, int offMs):設定前置LED燈的閃爍速率,持續毫秒數,停頓毫秒數。
  • setVibrate(long[] pattern):設定震動的模式,以一個long數組保存毫秒級間隔的震動。

  大多數時候,咱們並不須要設定一個特定的響應效果,只須要遵守用戶設備上系統通知的效果便可,那麼可使用setDefaults(int)方法設定默認響應參數,在Notification中,對它的參數使用常量定義了,咱們只需使用便可:

  • DEFAULT_ALL:鈴聲、閃光、震動均系統默認。
  • DEFAULT_SOUND:系統默認鈴聲。
  • DEFAULT_VIBRATE:系統默認震動。
  • DEFAULT_LIGHTS:系統默認閃光。

  而在Android中,若是須要訪問硬件設備的話,是須要對其進行受權的,因此須要在清單文件AndroidManifest.xml中增長兩個受權,分別授予訪問振動器與閃光燈的權限:

<!-- 閃光燈權限 -->
<uses-permission android:name="android.permission.FLASHLIGHT"/>
<!-- 振動器權限 -->
<uses-permission android:name="android.permission.VIBRATE"/>

 

  由於只是一個屬性的設定,而且大部分時候,使用系統設定便可,這裏就不提供代碼示例了。 

相關文章
相關標籤/搜索