HarmonyOS之深入解析通知的使用_notificationrequest

一、简介

① 概念

• 通知提供应用的即时消息或通信消息，用户可以直接删除或点击通知触发进一步的操作。
• 通知目前支持六种样式：普通文本、长文本、图片、社交、多行文本和媒体样式。创建通知时必须包含一种样式。
• 通知支持快捷回复。

② 应用场景

• HarmonyOS 提供了通知功能，即在一个应用的 UI 界面之外显示的消息，主要用来提醒用户有来自该应用中的信息。当应用向系统发出通知时，它将先以图标的形式显示在通知栏中，用户可以下拉通知栏查看通知的详细信息。
• 常见的使用场景：
• • 显示接收到短消息、即时消息等。
• • 显示应用的推送消息，如广告、版本更新等。
• • 显示当前正在进行的事件，如播放音乐、导航、下载等。

二、API 说明

• 通知相关基础类包含 NotificationSlot、NotificationRequest和NotificationHelper。基础类之间的关系如下所示：

① NotificationSlot

• NotificationSlot 可以对提示音、振动、锁屏显示和重要级别等进行设置。一个应用可以创建一个或多个 NotificationSlot，在发布通知时，通过绑定不同的 NotificationSlot，实现不同用途。
• NotificationSlot 需要先通过 NotificationHelper 的 addNotificationSlot(NotificationSlot) 方法发布后，通知才能绑定使用；所有绑定该 NotificationSlot 的通知在发布后都具备相应的特性，对象在创建后，将无法更改这些设置，对于是否启动相应设置，用户有最终控制权。
• 不指定 NotificationSlot 时，当前通知会使用默认的 NotificationSlot，默认的 NotificationSlot 优先级为 LEVEL_DEFAULT。
• NotificationSlot 主要接口：

• NotificationSlot 的级别目前支持如下几种， 由低到高：
• • LEVEL_NONE： 表示通知不发布。
• • LEVEL_MIN：表示通知可以发布，但是不显示在通知栏，不自动弹出，无提示音；该级别不适用于前台服务的场景。
• • LEVEL_LOW：表示通知可以发布且显示在通知栏，不自动弹出，无提示音。
• • LEVEL_DEFAULT：表示通知发布后可在通知栏显示，不自动弹出，触发提示音。
• • LEVEL_HIGH：表示通知发布后可在通知栏显示，自动弹出，触发提示音。

② NotificationRequest

• NotificationRequest 用于设置具体的通知对象，包括设置通知的属性，如：通知的分发时间、小图标、大图标、自动删除等参数，以及设置具体的通知类型，如普通文本、长文本等。
• NotificationRequest 主要接口：

• 具体的通知类型：目前支持六种类型，包括普通文本 NotificationNormalContent、长文本 NotificationLongTextContent、图片 NotificationPictureContent、多行 NotificationMultiLineContent、社交 NotificationConversationalContent、媒体 NotificationMediaContent。
• 通知类型的主要接口：

• 通知发布后，通知的设置不可修改。如果下次发布通知使用相同的 id，就会更新之前发布的通知。

③ NotificationHelper

• NotificationHelper 封装了发布、更新、删除通知等静态方法。
• NotificationHelper 主要接口：

三、通知的使用

① 创建 NotificationSlot

• NotificationSlot 可以设置公共通知的震动，锁屏模式，重要级别等，并通过调用 NotificationHelper.addNotificationSlot() 发布 NotificationSlot 对象。

	NotificationSlot slot = new NotificationSlot("slot_001", "slot_default", NotificationSlot.LEVEL_MIN); // 创建notificationSlot对象
	slot.setDescription("NotificationSlotDescription");
	slot.setEnableVibration(true); // 设置振动提醒
	slot.setLockscreenVisibleness(NotificationRequest.VISIBLENESS_TYPE_PUBLIC);// 设置锁屏模式
	slot.setEnableLight(true); // 设置开启呼吸灯提醒
	slot.setLedLightColor(Color.RED.getValue());// 设置呼吸灯的提醒颜色
	try {
	   NotificationHelper.addNotificationSlot(slot);
	} catch (RemoteException ex) {
	   HiLog.error(LABEL, "Exception occurred during addNotificationSlot invocation.");
	}
1
2
3
4
5
6
7
8
9
10
11

② 发布通知

• 构建 NotificationRequest 对象，应用发布通知前，通过 NotificationRequest 的 setSlotId() 方法与 NotificationSlot 绑定，使该通知在发布后都具备该对象的特征。

	int notificationId = 1;
	NotificationRequest request = new NotificationRequest(notificationId);
	request.setSlotId(slot.getId());
1
2
3

• 调用 setContent() 设置通知的内容：

	String title = "title";
	String text = "There is a normal notification content.";
	NotificationNormalContent content = new NotificationNormalContent();
	content.setTitle(title)
	       .setText(text);
	NotificationRequest.NotificationContent notificationContent = new NotificationRequest.NotificationContent(content);
	request.setContent(notificationContent); // 设置通知的内容
1
2
3
4
5
6
7

• 调用 publishNotification() 发布通知：

	try {
	   NotificationHelper.publishNotification(request);
	} catch (RemoteException ex) {
	   HiLog.error(LABEL, "Exception occurred during publishNotification invocation.");
	}
1
2
3
4
5

③ 取消通知

• 取消通知分为取消指定单条通知和取消所有通知，应用只能取消自己发布的通知。
• 调用 cancelNotification() 取消指定的单条通知。

	int notificationId = 1;
	try {
	    NotificationHelper.cancelNotification(notificationId);
	} catch (RemoteException ex) {
	    HiLog.error(LABEL, "Exception occurred during cancelNotification invocation.");
	}
1
2
3
4
5
6

• 调用 cancelAllNotifications() 取消所有通知：

	try {
	    NotificationHelper.cancelAllNotifications();
	} catch (RemoteException ex) {
	    HiLog.error(LABEL, "Exception occurred during cancelAllNotifications invocation.");
	}
1
2
3
4
5