在 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());
		}
	}
}

posted @ 2016-03-27 21:36  Rocket1184  阅读(1665)  评论(0编辑  收藏  举报