Notification(狀態(tài)欄通知)詳解
本節(jié)引言:
本節(jié)帶來(lái)的是Android中用于在狀態(tài)欄顯示通知信息的控件:Notification,相信大部分 學(xué)Android都對(duì)他都很熟悉,而網(wǎng)上很多關(guān)于Notification的使用教程都是基于2.x的,而 現(xiàn)在普遍的Android設(shè)備基本都在4.x以上,甚至是5.0以上的都有;他們各自的Notification 都是不一樣的!而本節(jié)給大家講解的是基于4.x以上的Notification,而5.0以上的Notification 我們會(huì)在進(jìn)階教程的Android 5.0新特性的章節(jié)進(jìn)行講解~
官方文檔對(duì)Notification的一些介紹:
設(shè)計(jì)思想:Notifications in Android 4.4 and Lower
譯文:通知
API文檔:Notification
訪問(wèn)上述網(wǎng)站,可能需要梯子哦~
1.設(shè)計(jì)文檔部分解讀
1)Notification的基本布局
上面的組成元素依次是:
- Icon/Photo:大圖標(biāo)
- Title/Name:標(biāo)題
- Message:內(nèi)容信息
- Timestamp:通知時(shí)間,默認(rèn)是系統(tǒng)發(fā)出通知的時(shí)間,也可以通過(guò)setWhen()來(lái)設(shè)置
- Secondary Icon:小圖標(biāo)
- 內(nèi)容文字,在小圖標(biāo)的左手邊的一個(gè)文字
2)擴(kuò)展布局
在 Jelly Bean 中你可以為通知提供更多事件的細(xì)節(jié)。你可以通過(guò)擴(kuò)展布局顯示消息的前幾行或者圖片的預(yù)覽。這樣用戶可以看多更多的內(nèi)容 - 有時(shí)甚至可以看到整個(gè)消息。用戶可以通過(guò) pinch-zoom 或者雙手指滑動(dòng)來(lái)打開(kāi)擴(kuò)展布局。Android 為單條消息提供了兩種擴(kuò)展布局 (文字和圖像) 供你開(kāi)發(fā)應(yīng)用時(shí)使用。
關(guān)于其他一些設(shè)計(jì)的東西,就不一一提及了,有興趣的自行查看上面提供的API文檔,知道下 這個(gè)Notification在4.x以上的版本可以多種多樣就好!我們更多的時(shí)候關(guān)注的是 如何寫(xiě)代碼使用這個(gè)東西,下面我們就來(lái)學(xué)習(xí)下Notification的用法!
2.Notification的基本使用流程
狀態(tài)通知欄主要涉及到2個(gè)類(lèi):Notification 和NotificationManager
Notification:通知信息類(lèi),它里面對(duì)應(yīng)了通知欄的各個(gè)屬性
NotificationManager:是狀態(tài)欄通知的管理類(lèi),負(fù)責(zé)發(fā)通知、清除通知等操作。
使用的基本流程:
- Step 1. 獲得NotificationManager對(duì)象: NotificationManager mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
- Step 2. 創(chuàng)建一個(gè)通知欄的Builder構(gòu)造類(lèi): Notification.Builder mBuilder = new Notification.Builder(this);
- Step 3. 對(duì)Builder進(jìn)行相關(guān)的設(shè)置,比如標(biāo)題,內(nèi)容,圖標(biāo),動(dòng)作等!
- Step 4.調(diào)用Builder的build()方法為notification賦值
- Step 5.調(diào)用NotificationManager的notify()方法發(fā)送通知!
- PS:另外我們還可以調(diào)用NotificationManager的cancel()方法取消通知
3.設(shè)置相關(guān)的一些方法:
Notification.Builder mBuilder = new Notification.Builder(this);
后再調(diào)用下述的相關(guān)的方法進(jìn)行設(shè)置:(官方API文檔:Notification.Builder) 常用的方法如下:
- setContentTitle(CharSequence):設(shè)置標(biāo)題
- setContentText(CharSequence):設(shè)置內(nèi)容
- setSubText(CharSequence):設(shè)置內(nèi)容下面一小行的文字
- setTicker(CharSequence):設(shè)置收到通知時(shí)在頂部顯示的文字信息
- setWhen(long):設(shè)置通知時(shí)間,一般設(shè)置的是收到通知時(shí)的System.currentTimeMillis()
- setSmallIcon(int):設(shè)置右下角的小圖標(biāo),在接收到通知的時(shí)候頂部也會(huì)顯示這個(gè)小圖標(biāo)
- setLargeIcon(Bitmap):設(shè)置左邊的大圖標(biāo)
- setAutoCancel(boolean):用戶點(diǎn)擊Notification點(diǎn)擊面板后是否讓通知取消(默認(rèn)不取消)
- setDefaults(int):向通知添加聲音、閃燈和振動(dòng)效果的最簡(jiǎn)單、 使用默認(rèn)(defaults)屬性,可以組合多個(gè)屬性,
Notification.DEFAULT_VIBRATE(添加默認(rèn)震動(dòng)提醒);
Notification.DEFAULT_SOUND(添加默認(rèn)聲音提醒);
Notification.DEFAULT_LIGHTS(添加默認(rèn)三色燈提醒)
Notification.DEFAULT_ALL(添加默認(rèn)以上3種全部提醒)- setVibrate(long[]):設(shè)置振動(dòng)方式,比如:
setVibrate(new long[] {0,300,500,700});延遲0ms,然后振動(dòng)300ms,在延遲500ms, 接著再振動(dòng)700ms,關(guān)于Vibrate用法后面會(huì)講解!- setLights(int argb, int onMs, int offMs):設(shè)置三色燈,參數(shù)依次是:燈光顏色, 亮持續(xù)時(shí)間,暗的時(shí)間,不是所有顏色都可以,這跟設(shè)備有關(guān),有些手機(jī)還不帶三色燈; 另外,還需要為Notification設(shè)置flags為Notification.FLAG_SHOW_LIGHTS才支持三色燈提醒!
setSound(Uri):設(shè)置接收到通知時(shí)的鈴聲,可以用系統(tǒng)的,也可以自己設(shè)置,例子如下:
.setDefaults(Notification.DEFAULT_SOUND) //獲取默認(rèn)鈴聲
.setSound(Uri.parse("file:///sdcard/xx/xx.mp3")) //獲取自定義鈴聲
.setSound(Uri.withAppendedPath(Audio.Media.INTERNAL_CONTENT_URI, "5")) //獲取Android多媒體庫(kù)內(nèi)的鈴聲setOngoing(boolean):設(shè)置為ture,表示它為一個(gè)正在進(jìn)行的通知。他們通常是用來(lái)表示 一個(gè)后臺(tái)任務(wù),用戶積極參與(如播放音樂(lè))或以某種方式正在等待,因此占用設(shè)備(如一個(gè)文件下載, 同步操作,主動(dòng)網(wǎng)絡(luò)連接)
- setProgress(int,int,boolean):設(shè)置帶進(jìn)度條的通知 參數(shù)依次為:進(jìn)度條最大數(shù)值,當(dāng)前進(jìn)度,進(jìn)度是否不確定 如果為確定的進(jìn)度條:調(diào)用setProgress(max, progress, false)來(lái)設(shè)置通知, 在更新進(jìn)度的時(shí)候在此發(fā)起通知更新progress,并且在下載完成后要移除進(jìn)度條 ,通過(guò)調(diào)用setProgress(0, 0, false)既可。如果為不確定(持續(xù)活動(dòng))的進(jìn)度條, 這是在處理進(jìn)度無(wú)法準(zhǔn)確獲知時(shí)顯示活動(dòng)正在持續(xù),所以調(diào)用setProgress(0, 0, true) ,操作結(jié)束時(shí),調(diào)用setProgress(0, 0, false)并更新通知以移除指示條
setContentIntent(PendingIntent):PendingIntent和Intent略有不同,它可以設(shè)置執(zhí)行次數(shù), 主要用于遠(yuǎn)程服務(wù)通信、鬧鈴、通知、啟動(dòng)器、短信中,在一般情況下用的比較少。比如這里通過(guò) Pending啟動(dòng)Activity:getActivity(Context, int, Intent, int),當(dāng)然還可以啟動(dòng)Service或者Broadcast PendingIntent的位標(biāo)識(shí)符(第四個(gè)參數(shù)):
FLAG_ONE_SHOT 表示返回的PendingIntent僅能執(zhí)行一次,執(zhí)行完后自動(dòng)取消
FLAG_NO_CREATE 表示如果描述的PendingIntent不存在,并不創(chuàng)建相應(yīng)的PendingIntent,而是返回NULL
FLAG_CANCEL_CURRENT 表示相應(yīng)的PendingIntent已經(jīng)存在,則取消前者,然后創(chuàng)建新的PendingIntent, 這個(gè)有利于數(shù)據(jù)保持為最新的,可以用于即時(shí)通信的通信場(chǎng)景
FLAG_UPDATE_CURRENT 表示更新的PendingIntent
使用示例://點(diǎn)擊后跳轉(zhuǎn)Activity Intent intent = new Intent(context,XXX.class); PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0); mBuilder.setContentIntent(pendingIntent)
setPriority(int):設(shè)置優(yōu)先級(jí):
對(duì)應(yīng)屬性:Notification.PRIORITY_HIGH...
優(yōu)先級(jí) 用戶 MAX 重要而緊急的通知,通知用戶這個(gè)事件是時(shí)間上緊迫的或者需要立即處理的。 HIGH 高優(yōu)先級(jí)用于重要的通信內(nèi)容,例如短消息或者聊天,這些都是對(duì)用戶來(lái)說(shuō)比較有興趣的。 DEFAULT 默認(rèn)優(yōu)先級(jí)用于沒(méi)有特殊優(yōu)先級(jí)分類(lèi)的通知。 LOW 低優(yōu)先級(jí)可以通知用戶但又不是很緊急的事件。 MIN 用于后臺(tái)消息 (例如天氣或者位置信息)。最低優(yōu)先級(jí)通知將只在狀態(tài)欄顯示圖標(biāo),只有用戶下拉通知抽屜才能看到內(nèi)容。
4.代碼示例:最常見(jiàn)的Notification:
下面我們來(lái)寫(xiě)一個(gè)最簡(jiǎn)單的例子來(lái)體驗(yàn)下Notification的用法:
運(yùn)行效果圖:
關(guān)鍵代碼:
這里直接貼MainActivity.java的代碼:
private Context mContext;
private NotificationManager mNManager;
private Notification notify1;
Bitmap LargeBitmap = null;
private static final int NOTIFYID_1 = 1;
private Button btn_show_normal;
private Button btn_close_normal;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mContext = MainActivity.this;
//創(chuàng)建大圖標(biāo)的Bitmap
LargeBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.iv_lc_icon);
mNManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
bindView();
}
private void bindView() {
btn_show_normal = (Button) findViewById(R.id.btn_show_normal);
btn_close_normal = (Button) findViewById(R.id.btn_close_normal);
btn_show_normal.setOnClickListener(this);
btn_close_normal.setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.btn_show_normal:
//定義一個(gè)PendingIntent點(diǎn)擊Notification后啟動(dòng)一個(gè)Activity
Intent it = new Intent(mContext, OtherActivity.class);
PendingIntent pit = PendingIntent.getActivity(mContext, 0, it, 0);
//設(shè)置圖片,通知標(biāo)題,發(fā)送時(shí)間,提示方式等屬性
Notification.Builder mBuilder = new Notification.Builder(this);
mBuilder.setContentTitle("葉良辰") //標(biāo)題
.setContentText("我有一百種方法讓你呆不下去~") //內(nèi)容
.setSubText("——記住我叫葉良辰") //內(nèi)容下面的一小段文字
.setTicker("收到葉良辰發(fā)送過(guò)來(lái)的信息~") //收到信息后狀態(tài)欄顯示的文字信息
.setWhen(System.currentTimeMillis()) //設(shè)置通知時(shí)間
.setSmallIcon(R.mipmap.ic_lol_icon) //設(shè)置小圖標(biāo)
.setLargeIcon(LargeBitmap) //設(shè)置大圖標(biāo)
.setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_VIBRATE) //設(shè)置默認(rèn)的三色燈與振動(dòng)器
.setSound(Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.biaobiao)) //設(shè)置自定義的提示音
.setAutoCancel(true) //設(shè)置點(diǎn)擊后取消Notification
.setContentIntent(pit); //設(shè)置PendingIntent
notify1 = mBuilder.build();
mNManager.notify(NOTIFYID_1, notify1);
break;
case R.id.btn_close_normal:
//除了可以根據(jù)ID來(lái)取消Notification外,還可以調(diào)用cancelAll();關(guān)閉該應(yīng)用產(chǎn)生的所有通知
mNManager.cancel(NOTIFYID_1); //取消Notification
break;
}
}
}
注釋很詳細(xì),就不一一細(xì)講了~
5.代碼示例下載:
NotificationDemo.zip
本節(jié)小結(jié):
好的,本節(jié)給大家介紹了Notification在4.x版本的基本用法,非常簡(jiǎn)單是吧~
當(dāng)然你也可以自定義Notification有興趣的可以自己查閱相關(guān)資料,這里就不慢慢 研究了~對(duì)了,本節(jié)部分內(nèi)容參考的下述blog,貼下鏈接,大家也可以去看下:Android 通知欄Notification的整合 全面學(xué)習(xí) (一個(gè)DEMO讓你完全了解它)寫(xiě)得蠻詳細(xì)的~本節(jié)就到這里,謝謝~