HarmonyOS：给您的应用添加通知

embedded/2025/2/7 13:44:39/

一、通知介绍

通知旨在让用户以合适的方式及时获得有用的新消息，帮助用户高效地处理任务。应用可以通过通知接口发送通知消息，用户可以通过通知栏查看通知内容，也可以点击通知来打开应用，通知主要有以下使用场景：

  • 显示接收到的短消息、即时消息等。
  • 显示应用的推送消息，如广告、版本更新等。
  • 显示当前正在进行的事件，如下载等。

1.1 通知表现形式

通知会在不同场景以不同形式提示用户，例如通知在状态栏上显示为图标、在通知栏上会显示通知详细信息。重要的信息还可以使用横幅通知，浮动在界面顶部显示。

在这里插入图片描述

1.2 通知结构

下面以基础的文本通知为例，介绍通知的基本结构。

在这里插入图片描述

  1. 通知小图标：表示通知的功能与类型。
  2. 通知名称：应用名称或功能名称。
  3. 时间：发送通知的时间，系统默认显示。
  4. 展开箭头：点击标题区，展开被折叠的内容和按钮。若无折叠的内容和按钮，不显示此箭头。
  5. 内容标题：描述简明概要。
  6. 内容详情：描述具体内容或详情。

二、请求通知授权

应用需要获取用户授权才能发送通知。在通知发布前调用requestEnableNotification()方法，弹窗让用户选择是否允许发送通知，后续再次调用requestEnableNotification()方法时，则不再弹窗。

2.1 接口说明

通知授权接口功能介绍

接口名描述
isNotificationEnabled():Promise查询通知是否授权。
requestEnableNotification(context: UIAbilityContext): Promise请求发送通知的许可，第一次调用会弹窗让用户选择。
2.2 开发步骤

效果图1

在这里插入图片描述

效果图2

在这里插入图片描述

  1. 导入NotificationManager模块
import { notificationManager } from '@kit.NotificationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { common } from '@kit.AbilityKit';const TAG: string = '[PublishOperation]';
const DOMAIN_NUMBER: number = 0xFF00;
  1. 请求通知授权

可通过requestEnableNotification的错误码判断用户是否授权。若返回的错误码为1600004，即为拒绝授权。

let context = getContext(this) as common.UIAbilityContext;
notificationManager.isNotificationEnabled().then((data: boolean) => {hilog.info(DOMAIN_NUMBER, TAG, "isNotificationEnabled success, data: " + JSON.stringify(data));if(!data){notificationManager.requestEnableNotification(context).then(() => {hilog.info(DOMAIN_NUMBER, TAG, `[ANS] requestEnableNotification success`);}).catch((err : BusinessError) => {if(1600004 == err.code){hilog.error(DOMAIN_NUMBER, TAG, `[ANS] requestEnableNotification refused, code is ${err.code}, message is ${err.message}`);} else {hilog.error(DOMAIN_NUMBER, TAG, `[ANS] requestEnableNotification failed, code is ${err.code}, message is ${err.message}`);}});}
}).catch((err : BusinessError) => {hilog.error(DOMAIN_NUMBER, TAG, `isNotificationEnabled fail, code is ${err.code}, message is ${err.message}`);
});

三、创建通知

本节将介绍几种常见类型通知的创建，在创建通知前需要先导入notificationManager模块，该模块提供通知管理的能力，包括发布、取消发布通知，创建、获取、移除通知通道等能力。

2.1 发布基础类型通知

基础类型通知主要应用于发送短信息、提示信息、广告推送等，支持普通文本类型、长文本类型、多行文本类型，可以通过ContentType指定通知的内容类型。下面以普通文本类型为例来介绍基础通知的发布，其它基础类型您可以查阅API。

发布普通文本类型通知，需要设置ContentType类型为ContentType.NOTIFICATION_CONTENT_BASIC_TEXT。

效果图

在这里插入图片描述

NotificationDemo1.ets 代码


import { notificationManager } from '@kit.NotificationKit'
import { common } from '@kit.AbilityKit'
import { BusinessError } from '@kit.BasicServicesKit';@Entry
@Component
struct NotificationDemo1 {@State message: string = '应用消息通知';checkNotificationPerrmission() {let context = getContext(this) as common.UIAbilityContextnotificationManager.isNotificationEnabled().then((data: boolean) => {if (data) {console.log("已获取通知权限")this.publishNotification()return}console.log("发起请求通知授权")notificationManager.requestEnableNotification(context).then(() => {console.log("发起请求通知授权成功")this.publishNotification()}).catch((err: BusinessError) => {if (1600004 == err.code) {console.log("发起请求通知授权被拒绝，错误码: ", err.code)} else {console.log("发起请求通知授权失败，错误码: ", err.code)}})})}/*** 发布消息通知*/publishNotification() {let notificationRequest: notificationManager.NotificationRequest = {// 描述通知的请求id: 1, // 通知IDcontent: {// 通知内容notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, // 普通文本类型通知normal: {// 基本类型通知内容title: '通知内容标题',text: '通知内容详情'}}}notificationManager.publish(notificationRequest).then(() => {console.info("消息通知发布成功")}).catch((err: Error) => {console.error(`消息通知发布失败了, 异常信息是： ${err}`)})}build() {Column() {Text(this.message).id('NotificationDemo1HelloWorld').fontSize(30).fontWeight(FontWeight.Bold)Button("发送通知").onClick((_event) => {this.checkNotificationPerrmission()})}.height('100%').width('100%')}
}
2.2 发布进度类型通知

进度条通知也是常见的通知类型，主要应用于文件下载、事务处理进度显示。目前系统模板仅支持进度条模板，效果示意如下图所示：

在这里插入图片描述

在发布进度类型通知前需要查询系统是否支持进度条模板。

  checkisSupportTemplate() {notificationManager.isSupportTemplate('downloadTemplate').then(isSupport => {if (!isSupport) {promptAction.showToast({message: "该设备不支持进度类型通知"})return}});}

构造进度条模板，name字段当前需要固定配置为downloadTemplate。

publishNotificationDownloadTemplate() {let templateData: notificationManager.NotificationTemplate = {name: 'downloadTemplate',data: {progressValue: 60, // 当前进度值progressMaxValue: 100, // 最大进度值title: 'File Title3',// 注意这里的标题和文件名要有，否则会报错，参数无效：Error: Invalid parameterfileName: '3music.mp4'}}let notificationRequest: notificationManager.NotificationRequest = {id: 1,content: {notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,normal: {title: '文件下载：music.mp4',text: 'senTemplate',additionalText: '60%'}},template: template}// 发布通知notificationManager.publish(notificationRequest).then(() => {console.info(`publish success`);}).catch((err: Error) => {console.error(`publish failed,message is ${err}`);})}
2.4 更新通知

在发出通知后，使用您之前使用的相同通知ID，再次调用notificationManager.publish来实现通知的更新。如果之前的通知是关闭的，将会创建新通知。

2.5 移除通知
  • 通过通知ID和通知标签取消已发布的通知。
    notificationManager.cancel(notificationId)
  • 取消所有已发布的通知。
    notificationManager.cancelAll()

四、设置通知通道

通过通知通道，您可让通知有不同的表现形式，比如社交类型的通知是横幅显示的，并且有提示音，而一般的通知则不会横幅显示，您可以使用slotType来实现，设置slotType为SlotType.SOCIAL_COMMUNICATION，表示为社交类型通知。示例代码如下：

notificationManager.addSlot(notificationManager.SlotType.SOCIAL_COMMUNICATION).then(() => {console.info("addSlot success");
}).catch((err: Base.BusinessError) => {console.error(`addSlot fail: ${JSON.stringify(err)}`);
});

通知通道类型主要有以下几种：

  • SlotType.SOCIAL_COMMUNICATION：社交类型，状态栏中显示通知图标，有横幅和提示音。
  • SlotType.SERVICE_INFORMATION：服务类型，状态栏中显示通知图标，没有横幅但有提示音。
  • SlotType.CONTENT_INFORMATION：内容类型，状态栏中显示通知图标，但没有横幅或提示音。
  • SlotType.OTHER_TYPES：其它类型，状态栏中不显示通知图标，且没有横幅或提示音。

效果图

在这里插入图片描述

五、创建通知组

将不同类型的通知分为不同的组，以便用户可以更好的管理他们。当同组的通知有多条的时候，会自动折叠起来，避免通知比较多的时候，通知界面比较杂乱，例如当通知栏里有聊天消息通知和商品推荐通知时，我们只需要通过设置字段groupName，就可以对通知进行分组，给groupName设置不同的值可以将通知分为不同的组。

效果图

在这里插入图片描述

可以使用groupName来指定通知组来实现，示例代码如下：

testGroupName() {let notifyId = 0;let chatRequest1: notificationManager.NotificationRequest = {id: notifyId++,groupName: 'ChatGroup',content: {notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,normal: {title: '新框架即将发布1',text: '新框架优化代码结构，提升性能1'}}};notificationManager.publish(chatRequest1).then(() => {console.info("chatRequest1 消息通知发布成功")}).catch((err: Error) => {console.error(`chatRequest1 消息通知发布失败了, 异常信息是： ${err}`)});let chatRequest2: notificationManager.NotificationRequest = {id: notifyId++,groupName: 'ChatGroup',content: {notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,normal: {title: '新框架即将发布2',text: '新框架优化代码结构，提升性能2'}}};notificationManager.publish(chatRequest2).then(() => {console.info("chatRequest2 消息通知发布成功")}).catch((err: Error) => {console.error(`chatRequest2 消息通知发布失败了, 异常信息是： ${err}`)});let productRequest1: notificationManager.NotificationRequest = {id: notifyId++,groupName: 'ProductGroup',content: {notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,normal: {title: '有机食品 1',text: '新鲜蔬菜，健康1'}}};notificationManager.publish(productRequest1).then(() => {console.info("productRequest1 消息通知发布成功")}).catch((err: Error) => {console.error(`productRequest1 消息通知发布失败了, 异常信息是： ${err}`)})let productRequest2: notificationManager.NotificationRequest = {id: notifyId++,groupName: 'ProductGroup',content: {notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,normal: {title: '有机食品 2',text: '新鲜蔬菜，健康2'}}};notificationManager.publish(productRequest2).then(() => {console.info("productRequest2 消息通知发布成功")}).catch((err: Error) => {console.error(`productRequest2 消息通知发布失败了, 异常信息是： ${err}`)});}

六、为通知添加行为意图

WantAgent提供了封装行为意图的能力，这里所说的行为意图主要是指拉起指定的应用组件及发布公共事件等能力。给通知添加行为意图后，点击通知后可以拉起指定的UIAbility或者发布公共事件，您可以按照以下步骤来实现：

6.1 导入模块。
import { notificationManager } from '@kit.NotificationKit'; 
import { wantAgent, WantAgent } from '@kit.AbilityKit';

创建WantAgentInfo信息。

场景一：拉起UIAbility

let wantAgentInfo = { wants: [ { bundleName: "com.example.notification", abilityName: "EntryAbility" } ], operationType: wantAgent.OperationType.START_ABILITY, requestCode: 100 
}

场景二：发布公共事件

let wantAgentInfo = { wants: [ { action: 'event_name', // 设置事件名 parameters: {}, } ], operationType: wantAgent.OperationType.SEND_COMMON_EVENT, requestCode: 100, wantAgentFlags: [wantAgent.WantAgentFlags.CONSTANT_FLAG], 
}
6.2 创建WantAgent对象
let wantAgentObj = null;  
wantAgent.getWantAgent(wantAgentInfo) .then((data) => { wantAgentObj = data; }) .catch((err: Error) => { console.error(`get wantAgent failed because ${JSON.stringify(err)}`); })
6.3 构造NotificationRequest对象
let notificationRequest: notificationManager.NotificationRequest = {id: 1, content: { notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, normal: { title: "通知标题", text: "通知内容" } }, // wantAgentObj使用前需要保证已被赋值wantAgent: wantAgentObj!
};
6.4 发布WantAgent通知
notificationManager.publish(notificationRequest).then(() => { // 发布通知console.info("publish success"); 
}).catch((err: Error) => { console.error(`publish failed, code is ${err.code}, message is ${err.message}`); 
});

用户通过点击通知栏上的通知，即可触发WantAgent的动作。


http://www.ppmy.cn/embedded/160311.html

相关文章

【Redis】主从模式，哨兵，集群

【Redis】主从模式，哨兵，集群

主从复制 单点问题： 在分布式系统中，如果某个服务器程序，只有一个节点（也就是一个物理服务器）来部署这个服务器程序的话，那么可能会出现以下问题： 1.可用性问题：如果这个机器挂了…
阅读更多...
C语言switch case语句详解（非常详细）

C语言switch case语句详解（非常详细）

在C语言中，switch case 语句是一种多分支选择结构，用于根据变量的值执行不同的代码块。 相比于if else语句，switch case在处理多个固定值的条件判断时更加简洁和高效。本文将详细讲解switch case语句的用法、语法格式、实例代码、注意事项&a…
阅读更多...
Hive修复分区

Hive修复分区

Hive修复分区 简介 Hive的MSCK REPAIR TABLE命令用于修复（即添加丢失的）表分区。通常用于那些已在HDFS中存在，但尚未在Hive元数据中注册的分区。 当你在HDFS文件系统中手动添加或删除分区目录，Hive并不会自动识别这些更改。为同步…
阅读更多...
网络安全——Span 安全监控

网络安全——Span 安全监控

SPAN释义： SPAN技术我们可以把交换机上某些想要被监控端口（以下简称受控端口）的数据流COPY或MIRROR一 份，发送给连接在监控端口上的流量分析仪，比如CISCO的IDS或是装SNIFFE工具的PC受控端口和 监控端口可以在同一台交…
阅读更多...
（2024|Nature Medicine，生物医学 AI，BiomedGPT）面向多种生物医学任务的通用视觉-语言基础模型

（2024|Nature Medicine，生物医学 AI，BiomedGPT）面向多种生物医学任务的通用视觉-语言基础模型

BiomedGPT: A generalist vision–language foundation model for diverse biomedical tasks 目录 1. 摘要 2. 引言 3. 相关研究 3.1 基础模型与通用生物医学 AI 3.2 生物医学 AI 的局限性 3.3 BiomedGPT 的创新点 4. 方法 4.1 架构及表示 4.1.1 模型架构选择 4.1.2 …
阅读更多...
LabVIEW自定义测量参数怎么设置?

LabVIEW自定义测量参数怎么设置?

以下通过一个温度采集案例，说明在 LabVIEW 中设置自定义测量参数的具体方法： 案例背景 ​ 假设使用 NI USB-6009 数据采集卡 和 热电偶传感器 监测温度，需自定义以下参数： 采样率：1 kHz 输入量程：0~10 V&a…
阅读更多...
MySQL的 MVCC详解

MySQL的 MVCC详解

MVCC是多版本并发控制，允许多个事务同时读取和写入数据库，而无需互相等待，从而提高数据库的并发性能。 在 MVCC 中，数据库为每个事务创建一个数据快照。每当数据被修改时，MySQL不会立即覆盖原有数据，而是生…
阅读更多...
chrome插件模板；使用 React 18 和 Webpack 5 的 Chrome 扩展样板

chrome插件模板；使用 React 18 和 Webpack 5 的 Chrome 扩展样板

一、软件介绍（文末提供下载） 这是一个基本的 Chrome 扩展样板，可帮助您编写模块化和现代的 Javascript 代码，轻松加载 CSS，并在代码更改时自动重新加载浏览器。 github地址：https://github.com/lxieyang/c…
阅读更多...
最新文章

Copyright @ 2022~2023