Xamarin.Android通知詳解

一、發送通知的機制

在日常的app應用中經常需要使用通知，因為服務、廣播后台活動如果有事件需要通知用戶，則需要通過通知欄顯示，而在Xamarin.Android下的通知需要獲取NotificationManager服務，而該服務需要通過GetSystemService獲取，同時還要傳遞一個標識符。獲取了通知管理器后我們就可以實例化Notification，然后再由NotificationManager發送出去。這就是整個過程了。下面我們將一一詳解通知。

 

二、前期准備

為了下面的學習和演示我們需要做好一些前期的准備

1.打開Main.axml刪除上面的控件

2.打開MainActivity.cs文件並寫入以下內容

    [Activity(Label = "NotificationStudy", MainLauncher = true, Icon = "@drawable/icon")]
    public class MainActivity : Activity
    {
        private NotificationManager nMgr;

        protected override void OnCreate(Bundle bundle)
        {
            base.OnCreate(bundle);
            SetContentView(Resource.Layout.Main);

            //獲取通知管理類
            nMgr = (NotificationManager)GetSystemService(NotificationService);

 

3.右擊項目-》屬性然后按照如下所示加上能夠控制振動的權限

 

三、發送普通通知

首先我們打開Main.axml文件，然后設置如下一個按鈕：

並設置id為@+id/normalButton

 

在MainActivity.cs先獲取按鈕對象：

Button normalButton = FindViewById<Button>(Resource.Id.normalButton);

 

 

監聽normalButton按鈕的點擊事件：

            normalButton.Click += (e, s) =>
            {
                //設置通知的圖標以及顯示的簡介Title
                Notification notify = new Notification(Resource.Drawable.Icon, "普通通知");
                //初始化點擊通知后打開的活動
                PendingIntent pintent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), PendingIntentFlags.UpdateCurrent);
                //設置通知的主體
                notify.SetLatestEventInfo(this, "普通通知標題", "普通通知內容", pintent);
                //發送通知
                nMgr.Notify(0, notify);
            };

 

其中我們先實例化了一個Notification對象，並設置其圖標以及Ticker文字:

Notification notify = new Notification(Resource.Drawable.Icon, "普通通知");

當然眾所周知當我們點擊通知之后都會打開對應的活動，所以我們需要初始化一個延遲意圖，以便通知可以打開：

PendingIntent pintent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), PendingIntentFlags.UpdateCurrent);

這個PendingIntent僅僅只是Intent的一個封裝。最后是設置通知的標題和內容以及對應的活動，最后就是發送這個通知，再發送通知的Notify方法中第一個參數為該通知的ID，有了這個ID后面就可以取消這個通知。

 

下面我們測試，發送該通知：

 

四、取消通知

通過上面的代碼我們已經發送了一個通知，那么我們還需要關閉這個通知，這里我們再在Main.axml中添加一個按鈕：

並設置其id為@+id/cancelNotifyButton

 

打開MainActivity.cs文件，並綁定監聽事件：

            Button cancelNotifyButton = FindViewById<Button>(Resource.Id.cancelNotifyButton);
            cancelNotifyButton.Click += (e, s) =>
            {
                //根據id取消通知
                nMgr.Cancel(0);
            };

 

然后發送一個通知后，點擊取消普通通知，會發現通知欄中不存在我們發送的通知了。

 

五、發送帶有聲音、震動和LED燈的通知

首先我們還是要在Main.axml中添加一個按鈕：

並設置它的id為@+id/lsvButton

 

打開MainActivity.cs並寫入如下代碼：

            Button lsvButton = FindViewById<Button>(Resource.Id.lsvButton);
            lsvButton.Click += (e, s) =>
            {
                Notification notify = new Notification(Resource.Drawable.Icon, "帶有聲音、LED光和震動的通知");
                //設置該通知具有聲音、LED光和震動
                notify.Defaults = NotificationDefaults.All;
                
                //獲取系統默認的通知聲音
Android.Net.Uri ringUri = RingtoneManager.GetDefaultUri(RingtoneType.Notification);
                //設置通知的聲音
                notify.Sound = ringUri;

                //設置一秒的震動
                notify.Vibrate = new long[] { 1000 };

                //設置LED的顏色為綠色
                notify.LedARGB = Color.Green;
                //設置LED顯示時間為1s
                notify.LedOnMS = 1000;
                //設置LED熄滅時間為1s
                notify.LedOffMS = 1000;
                //設置標志位，否則無法顯示LED
                notify.Flags = NotificationFlags.ShowLights | notify.Flags;

                PendingIntent pintent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), 0);

                notify.SetLatestEventInfo(this, "標題", "內容", pintent);

                nMgr.Notify(1, notify);
            };

下面我們來分析一下代碼，既然這個通知帶有聲音等，那么我們需要設置Defaults：

notify.Defaults = NotificationDefaults.All;

因為筆者使用了所有，所以直接是All，當然還可以是Sound、Vibrate和Lights的組合

為了能夠貼近系統，所以我們並沒有設置個性的聲音，而是獲取了系統本身的通知聲音，下面的代碼就是獲取代碼：

Android.Net.Uri ringUri = RingtoneManager.GetDefaultUri(RingtoneType.Notification);

最后是將這個聲音賦給通知：

notify.Sound = ringUri;

 然后就是震動：

notify.Vibrate = new long[] { 1000 };

筆者設置的是震動一秒，當然這是一個數組。而規則就是 震動的毫秒數，靜止的毫秒數，震動的毫秒數…這種規則

 最后就是比較麻煩的LED，首先是指定LED燈的顏色（如果不存在該顏色，系統會選擇臨近的顏色）：

notify.LedARGB = Color.Green;

然后筆者設置了顯示的毫秒數與熄滅的毫秒數：

                //設置LED顯示時間為1s
                notify.LedOnMS = 1000;
                //設置LED熄滅時間為1s
                notify.LedOffMS = 1000;

為了能夠確保LED能夠顯示我們還需要設置Flags：

notify.Flags = NotificationFlags.ShowLights | notify.Flags;

最后發送通知（模擬器上看不出來，建議真機測試）

 

六、通過Builder發送通知

這個方式相對於Notification更簡單，也更快捷，但是只有在Android 3.0以上才支持（面對如今都是Android 4.0以上應該沒有問題了）

 

先在Main.axml中添加對應的按鈕：

並設置對應的id為@+id/builderButton

 

最后就是MainActivity.cs中的代碼：

            Button builderButton = FindViewById<Button>(Resource.Id.builderButton);
            builderButton.Click += (e, s) =>
            {
                var pintent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), 0);

                var notify = new Notification.Builder(this)
                    .SetTicker("來自Builder的通知") //設置通知的簡介文字
                    .SetSmallIcon(Resource.Drawable.Icon) //設置通知的圖標
                    .SetDefaults(NotificationDefaults.All) //設置該通知具備聲音、LED和震動
                    .SetSound(RingtoneManager.GetDefaultUri(RingtoneType.Notification))  //設置通知聲音
                    .SetVibrate(new long[] { 1000 }) //設置震動頻率
                    .SetLights(Color.Red, 1, 0)  //設置LED
                    .SetContentTitle("標題") //設置標題
                    .SetContentText("內容")  //設置內容
                    .SetContentInfo("信息")  //設置右下角顯示的文字
                    .SetAutoCancel(true) //點擊該通知后是否自動消失
                    //通過 SetLargeIcon 可以設置大圖標
                    .SetContentIntent(pintent);

                nMgr.Notify(3, notify.Notification);
            };

這里我們可以看到通過Builder方式創建一個通知是多么的方便，只要通過SetXXXXX就可以完成了，最后只要在發送通知的時候傳入其Notification屬性即可，當然這里很多的方法跟通過Nitification是一樣的就不單獨解釋了，而且也有注釋說明。

 

七、進度條式通知

大家在下載文件的時候，都會看到通知欄會有當前下載任務的進度，而這個通知可以通過Builder方式實現，而且更快捷。

 

在Main.axml中添加對應的按鈕

並設置id為@+id/builderButton

 

其次就是MainActivity.cs文件

            Button progressButton = FindViewById<Button>(Resource.Id.progressButton);
            progressButton.Click += (e, s) =>
            {
                var notify = new Notification.Builder(this)
                .SetTicker("進度條通知")
                .SetSmallIcon(Resource.Drawable.Icon)
                .SetOngoing(true) //設置該通知是否可以被用戶移除 true 表示不可以
                .SetNumber(2) //設置該同時的條數 會在右下角顯示數量
                .SetContentTitle("標題")
                .SetProgress(100, 50, true); //第三個參數如果設置為true則進度條變成不確定進度條

                nMgr.Notify(4, notify.Notification);
            };

這里主要使用了SetProgress方法來設置進度條的最大值，當前值。最后一個參數設置為true則表示該進度條為不確定進度條，就是只會顯示滑動，不會顯示當前的進度。

SetProgress(100, 50, true);

這里我們還使用了一個新方法SetOngoing，通過前面的通知，大家會發現這些通知用戶完全可以通過手動的方式移除掉，但是我們如何創建一個用戶無法移除的通知呢？就是通過使用SetOngoing方法，並傳入一個true即可。

 

下面為實際運行圖：

 

八、自定義視圖通知

大家在使用音樂相關的應用的時候會發現通知欄會有一個簡單的功能界面，有當前歌曲的名稱，專輯圖片和暫停，下一曲等按鈕，這些當然不是通知自帶的，而是通過自定義通知來實現的，而本節我們不僅僅會學習如何使用自定義通知，同時還會學習如何設置自定義通知中控件的值，以及綁定監聽事件。

 

首先我們在Main.axml中添加按鈕

設置其id為@+id/customeViewButton

 

既然是自定義視圖，當然還需要一個視圖，所以我們在Resources/layout下新建一個視圖，並命名為NotificationCustomeView，並在其中寫入如下的xml：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:p1="http://schemas.android.com/apk/res/android"
    p1:minWidth="25px"
    p1:minHeight="25px"
    p1:layout_width="match_parent"
    p1:layout_height="match_parent"
    p1:id="@+id/relativeLayout1"
    p1:padding="5dp">
    <ImageView
        p1:src="@drawable/Icon"
        p1:layout_width="wrap_content"
        p1:layout_height="match_parent"
        p1:id="@+id/imageView1" />
    <RelativeLayout
        p1:minWidth="25px"
        p1:minHeight="25px"
        p1:layout_width="match_parent"
        p1:layout_height="match_parent"
        p1:layout_toRightOf="@id/imageView1"
        p1:id="@+id/relativeLayout2"
        p1:paddingLeft="10dp">
        <TextView
            p1:text="Large Text"
            p1:textAppearance="?android:attr/textAppearanceLarge"
            p1:layout_width="match_parent"
            p1:layout_height="wrap_content"
            p1:id="@+id/ncvTextView" />
        <ProgressBar
            style="?android:attr/progressBarStyleHorizontal"
            p1:layout_width="match_parent"
            p1:layout_height="match_parent"
            p1:layout_below="@id/ncvTextView"
            p1:id="@+id/ncvProgressBar"
            p1:indeterminateOnly="false"
            p1:indeterminate="false" />
    </RelativeLayout>
</RelativeLayout>

當然最終的結果圖如下所示：

 

打開MainActivity.cs文件

            Button customeViewButton = FindViewById<Button>(Resource.Id.customeViewButton);
            customeViewButton.Click += (e, s) =>
            {
                //初始化自定義視圖
                var customeView = new RemoteViews(this.PackageName, Resource.Layout.NotificationCustomeView);

                var notify = new Notification.Builder(this)
                .SetTicker("自定義視圖通知")
                .SetSmallIcon(Resource.Drawable.Icon)
                .SetNumber(2)
                .SetContent(customeView); //設置通知的自定義視圖

                //設置自定義視圖中textview的文字
                notify.Notification.ContentView.SetTextViewText(Resource.Id.ncvTextView, "通過代碼修改");

                //設置自定義視圖中Progressbar的進度
                notify.Notification.ContentView.SetProgressBar(Resource.Id.ncvProgressBar, 100, 40, false);

                //給自定義視圖中的ProgressBar綁定事件
                var pIntent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), 0);
                //綁定事件
                notify.Notification.ContentView.SetOnClickPendingIntent(Resource.Id.ncvProgressBar, pIntent);

                nMgr.Notify(5, notify.Notification);
            };

首先我們需要實例化一個RemoteViews封裝自定義視圖：

var customeView = new RemoteViews(this.PackageName, Resource.Layout.NotificationCustomeView);

然后通過通知的SetContent將其傳入

SetContent(customeView)

下面我們還需要訪問自定義視圖中的控件並設置他們的值，這里我們需要使用ContentView的Setxxxxxx來設置，如下下面我們就設置了TextView的文字和ProgressBar的進度：

                //設置自定義視圖中textview的文字
                notify.Notification.ContentView.SetTextViewText(Resource.Id.ncvTextView, "通過代碼修改");

                //設置自定義視圖中Progressbar的進度
                notify.Notification.ContentView.SetProgressBar(Resource.Id.ncvProgressBar, 100, 40, false);

最后就是綁定事件，通知里面的綁定事件不同於其他的，只能將一個意圖與這個事件綁定（實際運用中也應該如此，比如你點擊了暫停按鈕，將會通過意圖傳遞對應的參數到服務中從而停止播放）

notify.Notification.ContentView.SetOnClickPendingIntent(Resource.Id.ncvProgressBar, pIntent);

 

下面為實際的運行圖

 至此關於通知欄的使用就結束了，本人在Galaxy S4真機上測試成功（需要設置生成的配置）。