Xamarin.Android中NotificationBuilder构建通知


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

xamarin.android


1、背景

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

之前的代码:

  1. //定义通知管理类
  2. NoitficationManager nMgr;
  3. nMgr = (NotificationManager)GetSystemService(NotificationService);
  4. //设置通知的图标以及显示的简介Title
  5. Notification notify = new Notification(Resource.Drawable.Icon, "普通通知");
  6. //初始化点击通知后打开的活动
  7. PendingIntent pintent = PendingIntent.GetActivity(this, 0, new Intent(this, typeof(MainActivity)), PendingIntentFlags.UpdateCurrent);
  8. //设置通知的主体
  9. notify.SetLatestEventInfo(this, "普通通知标题", "普通通知内容", pintent);
  10. //发送通知
  11. nMgr.Notify(0, notify);

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

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

2、Android 通知结构

一个通知的最基本元素:

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

可选元素

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

3、使用Notification.Builder 构建普通通知

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

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

  1. namespace HelloNotification
  2. {
  3. [Activity(Label = "HelloNotification", MainLauncher = true, Icon = "@drawable/icon")]
  4. public class MainActivity : Activity
  5. {
  6. NotificationManager nMgr;
  7. protected override void OnCreate(Bundle bundle)
  8. {
  9. base.OnCreate(bundle);
  10. SetContentView(Resource.Layout.Main);
  11. //声明通知管理类
  12. nMgr = (NotificationManager)GetSystemService(NotificationService);
  13. }
  14. }
  15. }

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

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

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

第三步,发送通知!

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

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

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

4、给通知添加声音

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

需要添加引用: Android.Media

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

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

5、在 Android 5.0 以上发送浮动通知

这很简单,只要把通知的 Priority 设为 High 即可。
不过需要注意的是,高优先级的通知必须设置通知铃声。

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

6、自定义通知声音

这才是本文的灵魂所在!

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

目录结构:

  1. HelloNotification
  2. Recourse
  3. raw
  4. AnotherRingTone.mp3
  5. MyRingTone.mp3

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

  1. //注意添加引用!!
  2. using Uri = Android.Net.Uri;
  3. SometimesNaiveNotify = new Notification.Builder(this)
  4. //省略的其他参数
  5. .SetPriority((int)NotificationPriority.High)
  6. //从 Uri 设置声音
  7. .SetSound(Uri.Parse("android.resource://" + PackageName + "/" + Resource.Raw.MyRingTone));

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

下面说一点个人理解:

SetSound方法需要使用类型为 Android.Net.Uri 的参数,而此 Uri 只能在自己包名的目录下寻找吧 = =
所以要用 Uri.Prase 转换路径为 Uri

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

7、所有代码

  1. using System;
  2. using Android.App;
  3. using Android.Content;
  4. using Android.Runtime;
  5. using Android.Views;
  6. using Android.Widget;
  7. using Android.OS;
  8. using Android.Media;
  9. namespace HelloNotification
  10. {
  11. [Activity(Label = "HelloNotification", MainLauncher = true, Icon = "@drawable/icon")]
  12. public class MainActivity : Activity
  13. {
  14. NotificationManager nMgr;
  15. protected override void OnCreate(Bundle bundle)
  16. {
  17. base.OnCreate(bundle);
  18. SetContentView(Resource.Layout.Main);
  19. nMgr = (NotificationManager)GetSystemService(NotificationService);
  20. var notify = new Notification.Builder(this)
  21. .SetContentTitle("ContentTitle")
  22. .SetContentText("ContentText")
  23. .SetPriority((int)NotificationPriority.High)
  24. .SetSound(Uri.Parse("android.resource://" + PackageName + "/" + Resource.Raw.MyRingTone));
  25. .SetSmallIcon(Resource.Drawable.Icon);
  26. nMgr.Notify(1, notify.Build());
  27. }
  28. }
  29. }

作者:Rocket1184
原文地址:https://www.zybuluo.com/Rocket1184/note/326659

分享到