在 Xamarin.Android 中使用 Notification.Builder 构建通知

0 背景

在 Android 4.0 以后，系统支持一种更先进的 Notification.Builder 类来发送通知。但 Xamarin 文档含糊其辞，多方搜索无果，遂决定自己摸索。

之前的代码：

//定义通知管理类
NoitficationManager nMgr;
nMgr = (NotificationManager)GetSystemService(NotificationService);

//设置通知的图标以及显示的简介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);

如果在 VS2015 ，Xamarin 4.0 版本时，使用此方法，会报错：

“Notification.SetLatestEventInfo(Context, string, string, PendingIntent)”已过时:“deprecated”

1 Android 通知结构

一个通知的最基本元素：

1. SmallIcon - 图标
2. ContentTitle - 通知标题
3. ContentText - 通知内容

可选元素

1. Sound - 通知声音
2. Priority - 通知优先级
3. Ticker - 通知摘要。在 Android 5.0 以下版本，表现为在状态栏闪过的文字
4. Number - 通知计数，显示为通知横幅右下角的角标数字
5. 还有更多，本文不再赘述

2 使用Notification.Builder 构建普通通知

下面，以在 Activity 中构建通知为例。

首先，新建项目，并声明通知管理类。

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

		protected override void OnCreate(Bundle bundle)
		{
			base.OnCreate(bundle);
			SetContentView(Resource.Layout.Main);
            //声明通知管理类
			nMgr = (NotificationManager)GetSystemService(NotificationService);
		}
	}
}

第二步，使用 Notification.Builedr 构建一个通知。

var notify = new Notification.Builder(this)
				.SetContentTitle("ContentTitle")
				.SetContentText("ContentText")
				.SetSmallIcon(Resource.Drawable.Icon);

发送通知时，需要用到当前 Activity 的 Context ，就是这个 this 。

第三步，发送通知！

nMgr.Notify(1, notify.Build());

值得注意的是 Notify() 方法的第一个参数 int id 。这个 id 唯一标识 Android App 里面的每个通知，也就是在同一个 App 中， id 不能重复。否则后发出的通知会覆盖之前的通知。

当然，也可以用此方法达到“覆盖通知”的目的。

3 给通知添加声音

即调用 Notification.Builder 的 SetSound 方法。这里使用默认铃声做演示，因为自定义铃声的方法。。。跟这个差很多 = =

需要添加引用： Android.Media

var notify = new Notification.Builder(this)
    //省略了其他参数
    .SetSound(RingtoneManager.GetDefaultUri(RingtoneType.Notification))

这样发送的通知就可以带音效了。是不是很酷炫

4 在 Android 5.0 以上发送浮动通知

这很简单，只要把通知的 Priority 设为 High 即可。

不过需要注意的是，高优先级的通知必须设置通知铃声。

var notify = new Notification.Builder(this)
    //省略了其他参数
    .SetPriority((int)NotificationPriority.High)
    .SetSound(RingtoneManager.GetDefaultUri(RingtoneType.Notification))

5 自定义通知声音

这才是本文的灵魂所在！

调用此方法，需要把通知铃声文件放置在 Recourse 文件夹中。通常要再新建一个子文件夹（这里使用了 raw ，别问我为什么，我也不知道。也许是写起来方便吧）用来存储所有的声音文件。

目录结构：

• HelloNotification
  
  * Recourse
  
  * raw
  
  * AnotherRingTone.mp3
  
  * MyRingTone.mp3

引用外部声音文件时，需要使用文件的 Uri 。具体用法及介绍，请看代码。

//注意添加引用！！
using Uri = Android.Net.Uri;

notify = new Notification.Builder(this)
	//省略的其他参数
	.SetPriority((int)NotificationPriority.High)
	//从 Uri 设置声音
	.SetSound(Uri.Parse("android.resource://" + PackageName + "/" + Resource.Raw.MyRingTone));

可以看到，Xamarin 似乎把目录转化为了 .Net 对象，使用 . 运算符直接可以调用到，并不需要在什么奇怪的地方进行注册。

下面说一点个人理解：

SetSound 方法需要使用类型为 Android.Net.Uri 的参数，而此 Uri 只能在自己包名的目录下寻找吧 = =

所以要用 Uri.Prase 转换路径为 Uri

声明通知之后，便可以使用 nMgr.Notify(1,notify.Build()); 发送此通知了。这是便可以听见 狂拽酷炫 的自定义铃声。

6 所有代码

using System;
using Android.App;
using Android.Content;
using Android.Runtime;
using Android.Views;
using Android.Widget;
using Android.OS;
using Android.Media;

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

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

			nMgr = (NotificationManager)GetSystemService(NotificationService);

			var notify = new Notification.Builder(this)
				.SetContentTitle("ContentTitle")
				.SetContentText("ContentText")
				.SetPriority((int)NotificationPriority.High)
				.SetSound(Uri.Parse("android.resource://" + PackageName + "/" + Resource.Raw.MyRingTone));
				.SetSmallIcon(Resource.Drawable.Icon);

			nMgr.Notify(1, notify.Build());
		}
	}
}