狀態欄通知:Notification
Notification 是一種可以在 App 之外給用戶彈出消息通知的控件,當我們告訴系統有一個消息需要通知用戶的時候,系統首先會在通知欄展示一個 icon,然后通過下拉通知欄我們可以查看詳細的通知內容。非常適合于在推送新聞、好友消息、廣告等場景使用,目前幾乎所有的 App 都有這種類型的通知,大家平時在使用 Android 系統的時候一定會經常遇到,今天我們就一起來學習這種通知方式的用法。
1. Notification 的特性
在上一節我們學習了 Toast,它提供了一種簡單易用的展示提示信息的方法,但是它只能做短暫的提示,而相比之下,Notification 可以讓消息長時間的停留在通知欄,適合于一些內容比較多并且需要長時間停留的消息通知。通常在頂部通知欄會有 icon 顯示,有些手機甚至會配上 LED 燈的閃爍,如圖:
如果想要看詳細的通知內容,可以通過下拉的方式展開通知列表,然后點擊我們想要看的通知欄目即可,如圖:
2. Notification 的基本使用
我們可以直接創建 Notification,但是這樣不利于我們設置自己的樣式,好在 Android 系統為 Notification 提供了一個構建者,我們可以通過 Builder 來自定義各種屬性,Builder 常用 API 如下:
- setAutoCancel(boolean autoCancel):
- 設置當用戶點擊通知之后,通知是否要自動消失。
- setContent(RemoteViews views) :
設置一個自定義的 View 來替換系統標準的 View,從而實現自定義通知樣式。 - setContentInfo(CharSequence info):
設置通知的大文本內容(通常位于通知的右邊)。 - setContentIntent(PendingIntent intent):
設置一個PendingIntent
供Notification被點擊的時候使用。 - setContentText(CharSequence text):
設置通知的內容文本。 - setContentTitle(CharSequence title):
設置通知的標題文本。 - setDefaults(int defaults):
設置Notification的默認選項。 - setSmallIcon(int icon):
設置通知的小 icon(通常位于右下角)。 - setLargeIcon(Bitmap bitmap):
設置通知的大 icon(通常位于左邊)。 - setTicker(CharSequence ticker):
設置收到通知時在系統頂部顯示的提示內容。 - setWhen(long when):
設置通知的時間,通知列表會按照這個值進行排序。 - setVibrate(long[] pattern):
設置收到通知時的振動頻率。 - setLights(int argb, int onMs, int offMs):
設置 LED 燈樣式(需要設備支持且設置 Flag 為Notification.FLAG_SHOW_LIGHTS),方法參數依次是:燈光顏色, 亮的時長,滅的時長。 - setSound(Uri uri):
設置接收到通知時的鈴聲。 - setOngoing(boolean ongoing):
設置當前是否正在進行一個通知。
3. Notification 使用示例
3.1 Notification 的創建與展示
Android 系統為我們提供了一套非常簡單的方法去創建 Notification,只需要按照以下步驟即可輕松使用:
Step 1: 創建 Notification Builder
創建 Notification 之前我們要構建一個 Notification Builder,關于 Builder 我們在前文中提到過,通過它我們可以設置 Notification 各種各樣的屬性,比如大小圖標、標題、內容、優先級等等,創建 Builder 的方式很簡單,通過以下代碼即可完成創建:
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this)
Step 2: 設置 Notification 屬性
一旦創建了 Builder,我們就可以通過它設置 Notification 的屬性從而實現我們的需求了。從第 2 小節中我們了解到 Builder 的 API 非常之多,其實大多數 API 是很少用的,我們只需要了解就好,而以下 3 個是系統強制要求設置的:
- 設置小圖標
mBuilder.setSmallIcon(R.drawable.notification_icon);
- 設置通知標題
mBuilder.setContentTitle("Notification Alert, Click Me!");
- 設置通知內容
mBuilder.setContentText("Hi, This is Android Notification Detail!");
Step 3: 綁定事件
這一步是一個可選項,如果你有一些復雜的邏輯需要執行,那么可以給 Notification 綁定一個事件,讓用戶在點擊通知欄的時候能夠跳轉到對應的 Activity 中完成相應的操作。
我們通過一個 PendingIntent 來完成綁定,PendingIntent 中包含一個可以啟動 Activity 的 Intent。然后使用setContentIntent(PendingIntent intent)
接口將 PendingIntent 和通知關聯上,這樣在通知列表中點擊相應的通知就可以跳轉到對應的 Activity 當中了,使用方法如下:
Intent intent = new Intent(context, Destination.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
Notification.Builder builder = new Notification.Builder(this);
mBuilder.setContentIntent(pendingIntent);
Step 4: 展示通知
最后,我們可以通過設置好的 Builder 構造出我們想要的 Notification,然后調用NotificationManager.notify()
通知系統展示通知,示例代碼如下:
NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
notificationManager.notify(notificationID, builder.build());
其中 notificationID 是當前通知的唯一 ID,后續可以它來更新Notification。
3.2 Notification 完整示例
如果你安裝了慕課網 App,那么一定收到過一些精彩課程的推送信息,接下來我們就一起通過 Notification 完成一個新課程的更新通知。
3.2.1 編寫布局
首先提供一個 Button 用于觸發新課程的推送,然后一個 Button 用于取消這條推送,為了樣式的美觀,我們在加上一條App的標題和內容信息。整個的布局比較簡單,主要由 4 個元素組成,代碼如下:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="MainActivity">
<TextView
android:id="@+id/tv_title"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Android Study"
android:layout_alignParentTop="true"
android:layout_centerHorizontal="true"
android:textSize="30dp" />
<TextView
android:id="@+id/tv_content"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="慕課網新課程通知"
android:textColor="#ff87ff09"
android:textSize="30dp"
android:layout_below="@+id/tv_title"
android:layout_centerHorizontal="true"
android:layout_marginTop="48dp" />
<Button
android:layout_width"wrap_content"
android:layout_height="wrap_content"
android:text="取消課程通知"
android:id="@+id/bt_cancel"
android:layout_marginTop="62dp"
android:layout_below="@+id/bt_show"
android:layout_centerHorizontal="true" />
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/bt_show"
android:text="彈出課程通知"
android:layout_below="@+id/tv_content"
android:layout_centerHorizontal="true"
android:layout_marginTop="42dp" />
</RelativeLayout>
樣式效果如下:
3.2.2 編寫 MainActivity 邏輯
MainActivity 里面要做的事也比較簡單,大體上只有兩件事:
- 在點擊“彈出課程通知”的時候創建 Builder 并通過設置相應的屬性及提示信息,接著構造 Notification 并展示;
- 點擊“取消課程通知”,則隱藏掉已經彈出的課程通知。
代碼如下:
package com.emercy.myapplication;
import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
public class MainActivity extends Activity {
NotificationManager mManager;
private static final int NOTIFICATION_ID = 0;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
((Button)findViewById(R.id.bt_show)).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
addNotification();
}
});
((Button) findViewById(R.id.bt_cancel)).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (mManager != null) {
mManager.cancel(NOTIFICATION_ID);
}
}
});
}
private void addNotification() {
Notification.Builder builder = new Notification.Builder(this)
.setSmallIcon(R.drawable.icon)
.setContentTitle("慕課網 Android 教程更新")
.setContentText("狀態欄通知:Notification");
Intent notificationIntent = new Intent(this, NotificationActivity.class);
PendingIntent contentIntent = PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_UPDATE_CURRENT);
builder.setContentIntent(contentIntent);
mManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
mManager.notify(NOTIFICATION_ID, builder.build());
}
}
彈出的通知樣式如下:
注意: 在代碼中我們為 Notification 設置了 PendingIntent,而 PendingIntent 是通過一個 Intent 構造出來的,通過這個 Intent 我們可以將 Notification 和 NotificationActivity 綁定上,從而實現點擊 Notification 跳轉到相應 Activity 的功能,頁面樣式如下:
3.2.3 編寫 NotificationActivity 及其布局頁面
當用戶在下拉通知菜單中點擊我們彈出的 Notification 后,就可以進入推送的新課程頁面了,這里就簡單放一個TextView表示新課程的內容:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent" >
<TextView
android:layout_width="match_parent"
android:layout_height="400dp"
android:text="想要學習更多 Android 精彩內容,請登錄慕課網官方網站,跟著超哥學 Android" />
</LinearLayout>
然后創建一個空白的 NotificationActivity,設置布局為以上文件:
package com.emercy.myapplication;
import android.os.Bundle;
import android.app.Activity;
public class NotificationActivity extends Activity{
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.notification);
}
}
在通知列表中點擊我們的 Notification 會跳轉到課程的詳情頁,也就是 NotificationActivity,如下:
4. 小結
本節介紹了一個可以長時間停留,并且樣式更豐富的通知消息,再點擊的時候能夠跳轉到指定的 Activity 執行相應的業務邏輯。
為了更好的對 Notification 做定制化需求,系統為我們提供了一個 Builder 用于設置各種屬性及樣式,在創建之后通過NotificationManager
來彈出通知,并且可以通過PendingIntent
設置點擊通知之后的跳轉頁面,只要按照正確的流程來使用,Notification 還是非常簡單易用的。