【Android】狀態列通知Notification、NotificationManager詳解

encienqi發表於2012-07-28
Android

在Android系統中，發一個狀態列通知還是很方便的。下面我們就來看一下，怎麼傳送狀態列通知，狀態列通知又有哪些引數可以設定？

 

首先，傳送一個狀態列通知必須用到兩個類：  NotificationManager 、 Notification。

 

NotificationManager ：  是狀態列通知的管理類，負責發通知、清楚通知等。

NotificationManager 是一個系統Service，必須通過 getSystemService()方法來獲取。

NotificationManager nm = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

Notification：是具體的狀態列通知物件，可以設定icon、文字、提示聲音、振動等等引數。

 

下面是設定一個通知需要的基本引數：

 

  • An icon  (通知的圖示)
  • A title and expanded message  (通知的標題和內容)
  • A PendingIntent   (點選通知執行頁面跳轉)

 

可選的設定：

 

  • A ticker-text message (狀態列頂部提示訊息)
  • An alert sound    (提示音)
  • A vibrate setting  (振動)
  • A flashing LED setting  (燈光)
  • 等等

 

一、建立Notification

通過NotificationManager  的 notify(int, Notification) 方法來啟動Notification。

   第一個引數唯一的標識該Notification，第二個引數就是Notification物件。

二、更新Notification

呼叫Notification的 setLatestEventInfo方法來更新內容，然後再呼叫NotificationManager的notify()方法即可。(具體可以看下面的例項)

 

三、刪除Notification

通過NotificationManager  的cancel(int)方法，來清除某個通知。其中引數就是Notification的唯一標識ID。

當然也可以通過  cancelAll() 來清除狀態列所有的通知。

 

四、Notification設定(振動、鈴聲等)

 

1. 基本設定： 

					//新建狀態列通知
					baseNF = new Notification();
					 
					//設定通知在狀態列顯示的圖示
					baseNF.icon = R.drawable.icon;
					
					//通知時在狀態列顯示的內容
					baseNF.tickerText = "You clicked BaseNF!";
					
					//通知的預設引數 DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS. 
					//如果要全部採用預設值, 用 DEFAULT_ALL.
					//此處採用預設聲音
					baseNF.defaults = Notification.DEFAULT_SOUND;
					
					//第二個引數 ：下拉狀態列時顯示的訊息標題 expanded message title
					//第三個引數：下拉狀態列時顯示的訊息內容 expanded message text
					//第四個引數：點選該通知時執行頁面跳轉
					baseNF.setLatestEventInfo(Lesson_10.this, "Title01", "Content01", pd);
					
					//發出狀態列通知
					//The first parameter is the unique ID for the Notification 
					// and the second is the Notification object.
					nm.notify(Notification_ID_BASE, baseNF);

配一張圖作說明:

 

2. 新增聲音

如果要採用預設聲音，只要使用default就可以了。

baseNF.defaults = Notification.DEFAULT_SOUND;
如果要使用自定義聲音，那麼就要用到sound了。如下： 

notification.sound = Uri.parse("file:///sdcard/notification/ringer.mp3");
上面這種方法，使用的是自己的鈴聲，如果想用系統自帶的鈴聲，可以這樣：  

notification.sound = Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, "6");

需要注意一點，如果default、sound同時出現，那麼sound無效，會使用預設鈴聲。

 

預設情況下，通知的聲音播放一遍就會結束。 如果你想讓聲音迴圈播放，需要為flags引數加上FLAG_INSISTENT。 這樣聲音會到使用者響應才結束，比如下拉狀態列。

notification.flags |= notification.FLAG_INSISTENT;

3. 新增振動 如果是使用預設的振動方式，那麼同樣也是使用default。

notification.defaults |= Notification.DEFAULT_VIBRATE;
當然也可以自己定義振動形式，這邊需要用到Long型陣列。 

long[] vibrate = {0,100,200,300};  
notification.vibrate = vibrate;

這邊的Long型陣列中，第一個引數是開始振動前等待的時間，第二個引數是第一次振動的時間，第三個引數是第二次振動的時間，以此類推，隨便定義多長的陣列。但是採用這種方法，沒有辦法做到重複振動。

 

同樣，如果default、vibrate同時出現時，會採用預設形式。

 

另外還需要注意一點：使用振動器時需要許可權，如下：

<uses-permission android:name="android.permission.VIBRATE"></uses-permission>

4. 閃光

 

使用預設的燈光，如下：

notification.defaults |= Notification.DEFAULT_LIGHTS;

[java] view plaincopyprint?
  1. notification.defaults |= Notification.DEFAULT_LIGHTS;  

 

自定義：

notification.ledARGB = 0xff00ff00;  
notification.ledOnMS = 300;  
notification.ledOffMS = 1000;  
notification.flags |= Notification.FLAG_SHOW_LIGHTS;

[java] view plaincopyprint?
  1. notification.ledARGB = 0xff00ff00;  
  2. notification.ledOnMS = 300;  
  3. notification.ledOffMS = 1000;  
  4. notification.flags |= Notification.FLAG_SHOW_LIGHTS;  

其中ledARGB 表示燈光顏色、 ledOnMS 亮持續時間、ledOffMS 暗的時間。

注意：這邊的顏色跟裝置有關，不是所有的顏色都可以，要看具體裝置。

 

5. 其他有用的設定：

flags：

Notification.FLAG_INSISTENT;  //讓聲音、振動無限迴圈，直到使用者響應

Notification.FLAG_AUTO_CANCEL;    //通知被點選後，自動消失

Notification.FLAG_NO_CLEAR;  //點選'Clear'時，不清楚該通知(QQ的通知無法清除，就是用的這個)

 



 

下面附上我做的例子，供大家參考。 裡面包括建立通知、更新通知、清除通知、設定自定義鈴聲、自定義振動、自定義通知檢視等。

  

 

 

附上程式碼：

 

主類：

package com.yfz;  
import android.app.Activity;  
import android.app.Notification;  
import android.app.NotificationManager;  
import android.app.PendingIntent;  
import android.content.Intent;  
import android.net.Uri;  
import android.os.Bundle;  
import android.provider.MediaStore.Audio;  
import android.util.Log;  
import android.view.View;  
import android.view.View.OnClickListener;  
import android.widget.Button;  
import android.widget.RemoteViews;  
import android.widget.SeekBar;  
import android.widget.TextView;  
/** 
 * Notification 
 * @author Administrator 
 * 
 */  
public class Lesson_10 extends Activity {  
      
    //BaseNotification  
    private Button bt01;  
      
    //UpdateBaseNotification  
    private Button bt02;  
      
    //ClearBaseNotification  
    private Button bt03;  
      
    //MediaNotification  
    private Button bt04;  
      
    //ClearMediaNotification  
    private Button bt05;  
      
    //ClearALL  
    private Button bt06;  
      
    //CustomNotification  
    private Button bt07;  
      
    //通知管理器  
    private NotificationManager nm;  
      
    //通知顯示內容  
    private PendingIntent pd;  
      
    @Override  
     public void onCreate(Bundle savedInstanceState) {  
            super.onCreate(savedInstanceState);  
            /*載入頁面*/  
            setContentView(R.layout.lesson10);  
              
            init();  
    }  
      
    private void init() {  
        bt01 = (Button)findViewById(R.id.le10bt01);  
        bt02 = (Button)findViewById(R.id.le10bt02);  
        bt03 = (Button)findViewById(R.id.le10bt03);  
        bt04 = (Button)findViewById(R.id.le10bt04);  
        bt05 = (Button)findViewById(R.id.le10bt05);  
        bt06 = (Button)findViewById(R.id.le10bt06);  
        bt07 = (Button)findViewById(R.id.le10bt07);  
          
        bt01.setOnClickListener(onclick);  
        bt02.setOnClickListener(onclick);  
        bt03.setOnClickListener(onclick);  
        bt04.setOnClickListener(onclick);  
        bt05.setOnClickListener(onclick);  
        bt06.setOnClickListener(onclick);     
        bt07.setOnClickListener(onclick);  
          
        nm = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);  
          
        Intent intent = new Intent(this,Lesson_10.class);  
          
        pd = PendingIntent.getActivity(Lesson_10.this, 0, intent, 0);  
    }  
      
    OnClickListener onclick = new OnClickListener() {  
          
        //BASE Notification ID  
        private int Notification_ID_BASE = 110;  
          
        private Notification baseNF;  
          
        //Notification ID  
        private int Notification_ID_MEDIA = 119;  
          
        private Notification mediaNF;  
          
        @Override  
        public void onClick(View v) {  
            switch(v.getId()) {  
                case R.id.le10bt01:  
                    //新建狀態列通知  
                    baseNF = new Notification();  
                       
                    //設定通知在狀態列顯示的圖示  
                    baseNF.icon = R.drawable.icon;  
                      
                    //通知時在狀態列顯示的內容  
                    baseNF.tickerText = "You clicked BaseNF!";  
                      
                    //通知的預設引數 DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS.   
                    //如果要全部採用預設值, 用 DEFAULT_ALL.  
                    //此處採用預設聲音  
                    baseNF.defaults |= Notification.DEFAULT_SOUND;  
                    baseNF.defaults |= Notification.DEFAULT_VIBRATE;  
                    baseNF.defaults |= Notification.DEFAULT_LIGHTS;  
                      
                    //讓聲音、振動無限迴圈，直到使用者響應  
                    baseNF.flags |= Notification.FLAG_INSISTENT;  
                      
                    //通知被點選後，自動消失  
                    baseNF.flags |= Notification.FLAG_AUTO_CANCEL;  
                      
                    //點選'Clear'時，不清楚該通知(QQ的通知無法清除，就是用的這個)  
                    baseNF.flags |= Notification.FLAG_NO_CLEAR;  
                      
                      
                    //第二個引數 ：下拉狀態列時顯示的訊息標題 expanded message title  
                    //第三個引數：下拉狀態列時顯示的訊息內容 expanded message text  
                    //第四個引數：點選該通知時執行頁面跳轉  
                    baseNF.setLatestEventInfo(Lesson_10.this, "Title01", "Content01", pd);  
                      
                    //發出狀態列通知  
                    //The first parameter is the unique ID for the Notification   
                    // and the second is the Notification object.  
                    nm.notify(Notification_ID_BASE, baseNF);  
                      
                    break;  
                      
                case R.id.le10bt02:  
                    //更新通知  
                    //比如狀態列提示有一條新簡訊，還沒來得及檢視，又來一條新簡訊的提示。  
                    //此時採用更新原來通知的方式比較。  
                    //(再重新發一個通知也可以，但是這樣會造成通知的混亂，而且顯示多個通知給使用者，對使用者也不友好)  
                    baseNF.setLatestEventInfo(Lesson_10.this, "Title02", "Content02", pd);  
                    nm.notify(Notification_ID_BASE, baseNF);  
                    break;  
                      
                case R.id.le10bt03:  
                      
                    //清除 baseNF  
                    nm.cancel(Notification_ID_BASE);  
                    break;  
                      
                case R.id.le10bt04:  
                    mediaNF = new Notification();  
                    mediaNF.icon = R.drawable.icon;  
                    mediaNF.tickerText = "You clicked MediaNF!";  
                      
                    //自定義聲音  
                    mediaNF.sound = Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, "6");  
                      
                    //通知時發出的振動  
                    //第一個引數: 振動前等待的時間  
                    //第二個引數： 第一次振動的時長、以此類推  
                    long[] vir = {0,100,200,300};  
                    mediaNF.vibrate = vir;  
                      
                    mediaNF.setLatestEventInfo(Lesson_10.this, "Title03", "Content03", pd);  
                      
                    nm.notify(Notification_ID_MEDIA, mediaNF);  
                    break;  
                      
                case R.id.le10bt05:  
                    //清除 mediaNF  
                    nm.cancel(Notification_ID_MEDIA);  
                    break;  
                      
                case R.id.le10bt06:  
                    nm.cancelAll();  
                    break;  
                      
                case R.id.le10bt07:  
                    //自定義下拉檢視，比如下載軟體時，顯示的進度條。  
                    Notification notification = new Notification();  
                      
                    notification.icon = R.drawable.icon;  
                    notification.tickerText = "Custom!";  
                      
                    RemoteViews contentView = new RemoteViews(getPackageName(), R.layout.custom);  
                    contentView.setImageViewResource(R.id.image, R.drawable.icon);  
                    contentView.setTextViewText(R.id.text, "Hello, this message is in a custom expanded view");  
                    notification.contentView = contentView;  
                      
                    //使用自定義下拉檢視時，不需要再呼叫setLatestEventInfo()方法  
                    //但是必須定義 contentIntent  
                    notification.contentIntent = pd;  
                      
                    nm.notify(3, notification);  
                    break;  
            }  
        }  
    };  
      
      
}
主頁面：
<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout  
  xmlns:android="http://schemas.android.com/apk/res/android"  
  android:layout_width="fill_parent"  
  android:layout_height="fill_parent"  
  android:orientation="vertical">  
    <Button  
        android:id="@+id/le10bt01"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="BaseNotification"  
    />  
    <Button  
        android:id="@+id/le10bt02"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="UpdateBaseNotification"  
    />  
    <Button  
        android:id="@+id/le10bt03"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="ClearBaseNotification"  
    />  
    <Button  
        android:id="@+id/le10bt04"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="MediaNotification"  
    />  
    <Button  
        android:id="@+id/le10bt05"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="ClearMediaNotification"  
    />  
    <Button  
        android:id="@+id/le10bt06"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="ClearALL"  
    />  
    <Button  
        android:id="@+id/le10bt07"  
        android:layout_width="fill_parent"  
        android:layout_height="wrap_content"  
        android:text="CustomNotification"  
    />  
</LinearLayout>

自定義檢視頁面：
<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
              android:orientation="horizontal"  
              android:layout_width="fill_parent"  
              android:layout_height="fill_parent"  
              android:padding="3dp"  
              >  
    <ImageView android:id="@+id/image"  
              android:layout_width="wrap_content"  
              android:layout_height="fill_parent"  
              android:layout_marginRight="10dp"  
              />  
    <TextView android:id="@+id/text"  
              android:layout_width="wrap_content"  
              android:layout_height="fill_parent"  
              android:textColor="#000"  
              />  
</LinearLayout>

轉自：http://blog.csdn.net/feng88724/article/details/6259071






相關文章