【Android】狀態列通知Notification、NotificationManager詳解(轉載)

自閉果發表於2020-10-16

原地址:【Android】狀態列通知Notification、NotificationManager詳解

在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;
  1. 新增振動

如果是使用預設的振動方式,那麼同樣也是使用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>
  1. 閃光
    使用預設的燈光,如下:
notification.defaults |= Notification.DEFAULT_LIGHTS;

自定義:

notification.ledARGB = 0xff00ff00;
notification.ledOnMS = 300;
notification.ledOffMS = 1000;
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>

相關文章