HarmonyOS掌上记账APP开发实践第48篇：notificationManager 通知管理：从本地通知到预算超支提醒-育师

048 — notificationManager 通知管理：从本地通知到预算超支提醒

简介

通知是应用与用户保持联系的重要方式。在 MoneyTrack 中，通知系统承载着两个关键场景：一是用户设置的每日记账提醒（通过 reminderAgent，见 044 篇），二是预算超支的主动告警。当用户某个月的支出超过预设预算时，通过notificationManager发布系统通知，告知用户超支详情。结合通知渠道（Notification Channel）的划分和提醒设置页的开关控制，用户可以对通知进行精细化管控。

核心知识点

1. NotificationRequest 构建

系统通知通过NotificationRequest对象描述，以下是其核心属性：

属性	类型	说明
content	NotificationContent	通知内容主体（标题、正文、附加文本等）
notificationId	number	通知唯一标识，用于更新/取消指定通知
slotType	SlotType	通知渠道类型（决定重要等级和提醒方式）
wantAgent	WantAgent	点击通知后的跳转行为
deliveryTime	number	通知下发时间（毫秒时间戳）
groupName	string	通知分组名称，用于折叠展示
badgeNumber	number	角标数字，显示在应用图标上

2. notificationManager 完整 API

notificationManager提供了通知的完整生命周期管理：

发布通知：notificationManager.publish(request)发布一条通知，需要传入 NotificationRequest。
取消通知：notificationManager.cancel(notificationId)取消指定 ID 的通知。
取消所有：notificationManager.cancelAll()取消当前应用的所有通知。
订阅通知：notificationManager.subscribe(subscriber, info)订阅系统通知事件，可监听通知的发布、删除等操作。
取消订阅：notificationManager.unsubscribe(subscriber)取消通知订阅。

3. 通知渠道管理

鸿蒙通知系统要求所有通知归属于某个渠道（Slot），渠道定义了通知的语义类别和系统行为。用户可以在系统设置中为每个渠道独立开启/关闭通知，实现精细化控制。

渠道类型	值	说明	重要等级
SOCIAL_COMMUNICATION	0	社交通信类	高（响铃+振动）
SERVICE_INFORMATION	1	服务信息类	中（振动）
CONTENT_INFORMATION	2	内容资讯类	低（静音）
LIVE_VIEW	3	实况通知类	高（响铃+振动）
CUSTOMER_SERVICE	4	客服消息类	中（振动）

4. 通知点击跳转

通过设置NotificationRequest的wantAgent，用户点击通知时可以跳转到应用内的指定页面。wantAgent支持携带自定义参数，实现精准的页面路由。

5. 通知的完整生命周期

项目代码案例

预算超支提醒：

import{notificationManager}from'@kit.NotificationKit';import{wantAgent}from'@kit.AbilityKit';exportclassBudgetNotifier{// 发布预算超支通知staticasyncpublishOverBudgetAlert(budget:number,spent:number){constwantAgentObj=awaitwantAgent.getWantAgent({wants:[{bundleName:'com.moneytrack',abilityName:'BillListAbility',parameters:{filter:'current_month',fromNotification:true}}],operationType:wantAgent.OperationType.START_ABILITY});constrequest:notificationManager.NotificationRequest={content:{contentType:notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,text:`本月已支出 ¥${spent}，已超预算 ¥${budget}`,title:'预算超支提醒',additionalText:'点击查看本月账单详情'},notificationId:1001,slotType:notificationManager.SlotType.SERVICE_INFORMATION,wantAgent:wantAgentObj,deliveryTime:Date.now(),badgeNumber:1};awaitnotificationManager.publish(request);}// 取消预算超支通知staticasynccancelOverBudgetAlert(){awaitnotificationManager.cancel(1001);}// 订阅通知事件（如统计通知点击率）staticsubscribeNotificationEvents(){constsubscriber={onConsume:(data)=>{console.info(`通知被消费：${JSON.stringify(data.request.content)}`);},onCancel:(data)=>{console.info(`通知被取消：${data.request.notificationId}`);}};notificationManager.subscribe(subscriber);returnsubscriber;// 保留引用以便后续取消订阅}}

提醒设置页控制通知开关：

@Componentstruct NotificationSettings{@StorageProp('budgetAlertEnabled')budgetAlertEnabled:boolean=true;build(){Column(){Toggle({type:ToggleType.Switch,isOn:this.budgetAlertEnabled}).onChange((isOn)=>{AppStorage.set('budgetAlertEnabled',isOn);if(!isOn){BudgetNotifier.cancelOverBudgetAlert();}})}}}

通知渠道管理

用户可以通过系统设置 > 应用 > MoneyTrack > 通知管理，对每个通知渠道独立进行开关控制：

服务信息（SERVICE_INFORMATION）：管控预算超支等应用服务通知。
社交通信（SOCIAL_COMMUNICATION）：管控好友互动等社交类通知。
内容资讯（CONTENT_INFORMATION）：管控推荐内容等资讯通知。

开发者需要通过notificationManager.addSlot()在应用启动时注册渠道，用户此后即可在系统设置中操作。

// 应用启动时注册通知渠道asyncfunctioninitNotificationChannels(){awaitnotificationManager.addSlot(notificationManager.SlotType.SERVICE_INFORMATION);awaitnotificationManager.addSlot(notificationManager.SlotType.SOCIAL_COMMUNICATION);}