1. 引言

在移动应用生态中，​​系统通知是连接用户与应用的核心桥梁​​——无论是社交APP的消息提醒、电商APP的订单状态更新，还是工具类APP的定时任务通知，及时、精准的通知推送能力直接影响用户体验。然而，随着用户对通知管理的精细化需求增长（如避免打扰的“勿扰模式”、快速识别未读内容的“角标提示”），开发者不仅需要实现基础的通知发送功能，还需适配系统级特性（如角标数字、勿扰模式规则），以确保通知在合适的场景下触达用户，同时尊重用户的个性化设置。

鸿蒙（HarmonyOS）作为面向全场景的操作系统，通过 ​​@ohos.notification 模块​​ 提供了完整的系统通知管理能力，不仅支持发送文本、图片、进度条等多样化通知，还深度集成了 ​​角标（Badge）显示​​ 与 ​​勿扰模式（Do Not Disturb, DND）适配​​ 功能。本文将聚焦 ​​“带角标的通知发送”与“勿扰模式下的通知控制”两大典型场景​​，通过完整的代码示例（基于ArkTS/JS）与原理解析，帮助开发者实现既符合系统规范又满足用户需求的通知功能。

2. 技术背景

​​2.1 鸿蒙通知系统的核心机制​​

鸿蒙的通知功能基于 ​​NotificationManager​​ 服务，开发者通过该服务创建、发送和管理通知，其核心能力包括：

• ​​基础通知​​：支持文本标题/内容、大图标/小图标、点击跳转Intent、分组通知等基础元素；
• ​​角标（Badge）​​：在应用桌面图标上显示未读消息数量（如数字“3”或红点），帮助用户快速识别待处理内容；
• ​​勿扰模式适配​​：自动遵循系统“勿扰模式”规则（如静音时段内禁止通知声音/震动，或完全屏蔽非紧急通知）；
• ​​通知渠道（Channel）​​：将通知分类（如“消息”“提醒”“系统”），用户可针对不同渠道设置优先级、声音、震动等偏好；
• ​​生命周期管理​​：支持通知的更新（如角标数字累加）、取消（如用户已读后清除角标）及分组聚合。

​​关键概念​​：

• ​​通知渠道（NotificationChannel）​​：通知的分类容器，定义了通知的默认行为（如重要性级别、声音、震动），用户可在系统设置中调整每个渠道的偏好；
• ​​角标模式（BadgeMode）​​：控制角标的显示形式（数字/红点），需与应用的未读数据同步（如聊天未读消息数）；
• ​​勿扰模式规则（DoNotDisturbRule）​​：系统预定义的规则（如“睡眠时段静音”“仅允许优先级通知”），开发者需适配这些规则以避免通知干扰用户。

​​2.2 典型应用场景​​

3. 应用使用场景

​​3.1 典型HarmonyOS应用场景​​

• ​​社交类APP​​（如聊天软件、社区论坛）：新消息通知需显示角标数字（未读消息数），勿扰模式下仅@提及或群组紧急消息推送；
• ​​电商类APP​​（如购物平台、外卖服务）：订单状态变更（如“待付款”“已发货”）通知需更新角标（待处理订单数），勿扰时段内避免频繁打扰；
• ​​工具类APP​​（如日历、闹钟、健康管理）：定时提醒通知需在勿扰模式下仍可触发（如早8点的起床闹钟），或根据用户设置静音；
• ​​跨设备场景​​：鸿蒙手机与平板/智慧屏协同时，角标同步显示（如手机未读消息同步到平板图标），勿扰模式规则跨设备一致。

4. 不同场景下的详细代码实现

​​4.1 环境准备​​

​​4.1.1 开发工具与依赖​​

• ​​开发工具​​：DevEco Studio（鸿蒙官方IDE，支持ArkTS/JS开发）；
• ​​核心技术模块​​：
  • ​​@ohos.notification​​：提供通知创建、发送、角标管理及勿扰模式适配的API；
  • ​​@ohos.notification.badge​​（部分版本）：专门用于角标控制的扩展模块（若未直接提供，可通过通知渠道的 badgeNumber 参数实现）；
• ​​关键概念​​：
  • ​​权限声明​​：发送通知需在 module.json5 中声明 ohos.permission.NOTIFICATION 权限（鸿蒙3.0+通常默认允许，但建议显式声明）；
  • ​​通知渠道​​：每个通知需关联一个渠道（如“消息渠道”），渠道的 importance（重要性）决定默认行为（如是否显示角标、是否发声震动）；
  • ​​勿扰模式检测​​：通过 @ohos.distributedhardware.dnsmgmt 模块（或系统API）查询当前是否处于勿扰模式（部分版本可能通过通知渠道的规则间接适配）。

​​4.2 典型场景1：带角标的通知发送（社交消息提醒）​​

​​4.2.1 代码实现步骤​​

​​4.2.1.1 配置权限（module.json5）​​

在应用的配置文件中声明通知权限（通常默认允许，但显式声明更规范）：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.NOTIFICATION",
        "reason": "用于发送社交消息通知及角标更新"
      }
    ]
  }
}

​​4.2.1.2 核心代码（MessageNotification.ets）​​

import notification from '@ohos.notification';
import promptAction from '@ohos.promptAction';

// 通知管理类
export default class MessageNotificationManager {
  private context: common.UIAbilityContext; // Ability上下文
  private notificationManager: notification.NotificationManager; // 通知管理器
  private channelId: string = 'message_channel'; // 通知渠道ID

  constructor(context: common.UIAbilityContext) {
    this.context = context;
    this.notificationManager = notification.getNotificationManager();
    this.initNotificationChannel(); // 初始化通知渠道
  }

  // 初始化通知渠道（设置角标与重要性）
  private async initNotificationChannel(): Promise<void> {
    try {
      // 创建通知渠道（名称、描述、重要性级别）
      const channel = {
        id: this.channelId,
        name: '消息通知',
        description: '社交APP的新消息提醒',
        importance: notification.Importance.HIGH, // 高重要性（默认显示角标与声音）
        badgeNumber: 1, // 允许显示角标（数字）
        enableBadge: true, // 启用角标功能
      };

      // 创建或更新渠道（鸿蒙会自动合并同名渠道）
      await this.notificationManager.createNotificationChannel(channel);
      promptAction.showToast({
        message: '通知渠道初始化成功',
        duration: 1500
      });
    } catch (error: any) {
      console.error('通知渠道初始化失败:', error.message);
    }
  }

  // 发送带角标的通知（模拟新消息）
  public async sendBadgeNotification(title: string, content: string, badgeCount: number): Promise<void> {
    try {
      // 构建通知内容
      const notificationRequest = {
        id: Date.now(), // 唯一通知ID（用于更新/取消）
        channelId: this.channelId,
        title: title,
        text: content,
        badgeNumber: badgeCount, // 角标数字（如未读消息数）
        smallIcon: '$media:icon', // 小图标（需在resources/base/media/下放置icon.png）
        largeIcon: '$media:icon_large', // 大图标（可选）
        showDeliveryTime: true, // 显示发送时间
      };

      // 发送通知
      await this.notificationManager.publish(notificationRequest);
      console.info(`通知已发送，角标数字: ${badgeCount}`);
      promptAction.showToast({
        message: `新消息通知已发送（角标: ${badgeCount}）`,
        duration: 2000
      });
    } catch (error: any) {
      console.error('通知发送失败:', error.message);
    }
  }

  // 更新角标数字（累加未读数）
  public async updateBadgeCount(newCount: number): Promise<void> {
    // 实际项目中需先获取当前角标数（此处简化为直接设置）
    await this.sendBadgeNotification('未读消息更新', `当前未读: ${newCount}条`, newCount);
  }
}

// 在Ability中使用
@Entry
@Component
struct MessageNotificationAbility {
  @State notificationManager: MessageNotificationManager | null = null;

  aboutToAppear() {
    const context = getContext(this) as common.UIAbilityContext;
    this.notificationManager = new MessageNotificationManager(context);
  }

  // 模拟收到3条新消息
  onNewMessages() {
    if (!this.notificationManager) return;
    this.notificationManager.sendBadgeNotification('新消息', '您有3条未读聊天消息', 3);
  }

  // 模拟未读数更新为5条
  onUpdateUnreadCount() {
    if (!this.notificationManager) return;
    this.notificationManager.updateBadgeCount(5);
  }

  build() {
    Column() {
      Text('鸿蒙系统通知 - 角标示例')
        .fontSize(24)
        .margin(20)
      Button('发送新消息通知（角标3）')
        .onClick(() => this.onNewMessages())
        .margin(10)
        .width('90%')
      Button('更新角标为5条未读')
        .onClick(() => this.onUpdateUnreadCount())
        .margin(10)
        .width('90%')
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
    .padding(20)
  }
}

​​4.2.2 代码解析​​

• ​​权限与渠道​​：通过 module.json5 声明 ohos.permission.NOTIFICATION 权限，初始化时创建名为“消息通知”的渠道，设置 importance: HIGH（高重要性，默认启用角标与声音），并启用 enableBadge: true 允许角标显示；
• ​​角标控制​​：通过 badgeNumber 参数指定通知关联的未读数字（如3条消息显示数字“3”），用户点击通知后，应用需自行更新未读数并调用 updateBadgeCount 方法同步角标；
• ​​用户交互​​：点击“发送新消息通知”按钮时，发送一条标题为“新消息”、内容为“您有3条未读聊天消息”的通知，桌面图标显示角标数字“3”；点击“更新角标为5条未读”时，更新角标数字为“5”。

​​4.2.3 运行结果​​

• ​​初始状态​​：应用图标无角标；
• ​​点击“发送新消息通知”​​：设备显示通知（标题/内容），应用桌面图标右上角显示数字角标“3”；
• ​​点击“更新角标为5条未读”​​：通知中心新增一条“未读消息更新”通知，应用图标角标更新为数字“5”；
• ​​用户点击通知​​：通知消失（需应用内逻辑同步更新未读数并调用 cancel 方法清除角标）。

​​4.3 典型场景2：勿扰模式下的通知适配（紧急消息推送）​​

​​4.3.1 场景描述​​

当系统处于“勿扰模式”时（用户设置静音时段或手动开启），普通通知（如营销消息）应被屏蔽或静音，但高优先级通知（如紧急联系人消息、系统警告）仍需推送。本场景模拟在勿扰模式下，仅发送高优先级通知（如“紧急求助”消息）。

​​4.3.2 代码实现（核心逻辑扩展）​​

（在 MessageNotificationManager 类中新增勿扰模式适配方法：

// 检测当前是否处于勿扰模式（部分鸿蒙版本需通过系统API，此处简化为模拟）
private isDoNotDisturbMode(): boolean {
  // 实际项目中需调用系统API（如@ohos.distributedhardware.dnsmgmt）查询勿扰状态
  // 此处模拟：假设当前为勿扰模式（返回true时仅允许高优先级通知）
  return true; // 模拟勿扰模式开启
}

// 发送适配勿扰模式的通知（紧急消息）
public async sendUrgentNotification(title: string, content: string): Promise<void> {
  if (this.isDoNotDisturbMode()) {
    // 勿扰模式下，仅允许高优先级通知（重要性IMPORTANCE_MAX）
    try {
      const urgentChannel = {
        id: 'urgent_channel',
        name: '紧急通知',
        description: '紧急联系人消息',
        importance: notification.Importance.MAX, // 最高重要性（突破勿扰模式限制）
        badgeNumber: 1,
        enableBadge: true,
      };
      await this.notificationManager.createNotificationChannel(urgentChannel);

      const urgentNotification = {
        id: Date.now(),
        channelId: 'urgent_channel',
        title: title,
        text: content,
        badgeNumber: 1,
        smallIcon: '$media:icon',
        // 无声音/震动（用户勿扰模式下可能仍静音，但通知会显示）
      };
      await this.notificationManager.publish(urgentNotification);
      console.info('紧急通知已发送（勿扰模式适配）');
    } catch (error: any) {
      console.error('紧急通知发送失败:', error.message);
    }
  } else {
    // 非勿扰模式，正常发送普通优先级通知
    await this.sendBadgeNotification(title, content, 1);
  }
}

在Ability中新增按钮触发紧急通知：

// 在MessageNotificationAbility中
onUrgentMessage() {
  if (!this.notificationManager) return;
  this.notificationManager.sendUrgentNotification('紧急求助', '您的紧急联系人发送了消息！');
}

// 在build方法中添加按钮
Button('模拟勿扰模式下发送紧急通知')
  .onClick(() => this.onUrgentMessage())
  .margin(10)
  .width('90%')

）

​​4.3.3 运行结果​​

• ​​勿扰模式开启时​​：点击“模拟勿扰模式下发送紧急通知”，仅“紧急求助”通知（通过 IMPORTANCE_MAX 渠道发送）会显示（无声音/震动，或根据用户设置），普通通知被屏蔽；
• ​​勿扰模式关闭时​​：紧急通知与普通通知均按正常逻辑推送（角标与声音/震动遵循渠道设置）。

5. 原理解释

​​5.1 角标与通知的核心工作流程​​

1. ​​通知渠道创建​​：开发者通过 createNotificationChannel 定义通知的分类（如“消息渠道”），设置 importance（重要性）和 enableBadge（是否启用角标）；
2. ​​通知发送​​：通过 publish 方法发送通知，指定 channelId 关联到对应渠道，通过 badgeNumber 参数传递未读数字（如3条消息）；
3. ​​角标显示​​：系统根据 badgeNumber 更新应用桌面图标的角标（数字或红点），用户点击通知后，应用需调用 cancel 方法清除角标或更新未读数；
4. ​​勿扰模式适配​​：系统根据当前勿扰模式规则（如静音时段、用户设置）过滤通知，开发者通过设置通知渠道的 importance: IMPORTANCE_MAX 突破限制（仅紧急通知）。

​​5.2 核心特性总结​​

6. 原理流程图及原理解释

​​6.1 角标通知的完整流程图（社交消息场景）​​

sequenceDiagram
    participant 用户 as 用户
    participant 应用 as 鸿蒙应用（ArkTS）
    participant 系统 as 鸿蒙系统（NotificationManager）
    participant 桌面 as 应用桌面图标

    用户->>应用: 收到3条新消息
    应用->>系统: 创建“消息渠道”（importance=HIGH, enableBadge=true）
    系统-->>应用: 渠道创建成功
    应用->>系统: 发送通知（title=新消息, badgeNumber=3, channelId=消息渠道）
    系统->>桌面: 更新应用图标角标为数字“3”
    用户->>桌面: 点击应用图标
    桌面->>应用: 打开应用（用户查看消息）
    应用->>系统: 清除角标（或更新为未读数2）
    系统->>桌面: 角标更新为数字“2”或红点

​​6.2 原理解释​​

• ​​初始状态​​：用户未读消息数为0，应用桌面图标无角标；
• ​​消息到达​​：应用收到3条新消息，首先创建“消息渠道”（设置 importance: HIGH 启用角标，enableBadge: true 允许显示），然后发送通知并指定 badgeNumber: 3；
• ​​角标显示​​：系统接收到通知后，根据渠道配置将角标数字“3”显示在应用桌面图标右上角；
• ​​用户交互​​：用户点击应用图标查看消息后，应用通过调用 cancel 方法或更新 badgeNumber（如减至2），系统同步更新桌面角标。

7. 实际详细应用代码示例（综合案例：聊天APP通知）

​​7.1 场景描述​​

聊天APP包含“发送普通消息通知”“更新角标未读数”“模拟勿扰模式下发送紧急消息”三个功能，需求如下：

• 用户收到新消息时，发送带角标数字的通知（如“2条未读”）；
• 用户查看部分消息后，更新角标数字（如剩余1条未读）；
• 当系统处于勿扰模式时，仅发送“紧急联系人消息”的高优先级通知。

​​7.2 代码实现（完整示例）​​

（在 MessageNotificationAbility.ets 中扩展综合逻辑：

// 在MessageNotificationManager中新增普通消息与紧急消息方法
public async sendNormalMessage(title: string, content: string) {
  // 普通消息使用默认渠道（importance=HIGH，允许角标）
  const normalNotification = {
    id: Date.now(),
    channelId: this.channelId,
    title: title,
    text: content,
    badgeNumber: 1, // 默认角标+1（实际需根据未读总数计算）
    smallIcon: '$media:icon',
  };
  await this.notificationManager.publish(normalNotification);
}

public async sendEmergencyMessage(title: string, content: string) {
  // 紧急消息使用高优先级渠道（importance=MAX，突破勿扰模式）
  const emergencyChannel = {
    id: 'emergency_channel',
    name: '紧急消息',
    description: '紧急联系人通知',
    importance: notification.Importance.MAX,
    badgeNumber: 1,
    enableBadge: true,
  };
  await this.notificationManager.createNotificationChannel(emergencyChannel);

  const emergencyNotification = {
    id: Date.now(),
    channelId: 'emergency_channel',
    title: title,
    text: content,
    badgeNumber: 1,
    smallIcon: '$media:icon',
  };
  await this.notificationManager.publish(emergencyNotification);
}

// 在Ability中新增按钮
@State notificationManager: MessageNotificationManager | null = null;

// 模拟普通消息
onNormalMessage() {
  if (!this.notificationManager) return;
  this.notificationManager.sendNormalMessage('新聊天', '好友给您发送了一条消息');
}

// 模拟紧急消息（勿扰模式适配）
onEmergencyMessage() {
  if (!this.notificationManager) return;
  this.notificationManager.sendEmergencyMessage('紧急联系', '家人发送了紧急求助消息！');
}

// 在build方法中添加按钮
Button('发送普通消息通知')
  .onClick(() => this.onNormalMessage())
  .margin(10)
  .width('90%')
Button('发送紧急消息（勿扰模式适配）')
  .onClick(() => this.onEmergencyMessage())
  .margin(10)
  .width('90%')

）

8. 运行结果

​​8.1 基础场景（角标通知）​​

• 用户点击“发送新消息通知”后，设备显示通知（标题/内容），应用桌面图标显示角标数字“3”；
• 用户点击“更新角标为5条未读”后，通知中心新增通知，桌面角标更新为数字“5”；
• 用户点击通知后，应用可调用 cancel 方法清除角标（或更新为已读数）。

​​8.2 勿扰模式场景​​

• 模拟勿扰模式开启时，点击“发送普通消息通知”可能无提示（根据系统设置静音），点击“发送紧急消息”后，紧急通知仍会显示（无声音/震动或按用户设置）；
• 勿扰模式关闭时，所有通知按正常逻辑推送（角标与声音/震动遵循渠道配置）。

9. 测试步骤及详细代码

​​9.1 基础功能测试​​

1. ​​角标发送测试​​：点击“发送新消息通知”，检查桌面图标是否显示对应角标数字（如3），通知中心是否存在该通知；
2. ​​角标更新测试​​：点击“更新角标为5条未读”，检查桌面角标是否更新为数字“5”；
3. ​​通知点击测试​​：点击通知后，检查角标是否按逻辑减少（如应用内逻辑调用 cancel 或更新 badgeNumber）。

​​9.2 勿扰模式测试​​

1. ​​勿扰模式开启​​：手动开启设备勿扰模式（或通过系统设置模拟），点击“发送普通消息通知”，验证是否被屏蔽（无声音/震动/角标更新）；
2. ​​紧急消息测试​​：勿扰模式下点击“发送紧急消息”，验证紧急通知是否正常显示（根据系统设置可能无声音但显示角标）；
3. ​​勿扰模式关闭​​：关闭勿扰模式后，点击普通/紧急通知，验证所有功能正常。

10. 部署场景

​​10.1 生产环境部署​​

• ​​权限配置​​：确保 module.json5 中声明 ohos.permission.NOTIFICATION 权限（默认允许但显式声明更规范）；
• ​​用户引导​​：在应用设置中提供“通知管理”入口，引导用户开启角标与声音/震动偏好（如“允许显示未读角标”）；
• ​​兼容性适配​​：在不同鸿蒙设备（如手机、平板、智慧屏）上测试角标显示规则（如部分设备可能仅支持红点而非数字）；
• ​​勿扰模式协同​​：与系统勿扰模式规则对齐（如紧急通知在勿扰时段仍可推送，但避免骚扰用户）。

​​10.2 适用场景​​

• ​​社交类APP​​：聊天消息、群组通知的角标与勿扰模式适配；
• ​​电商类APP​​：订单状态变更通知的角标更新与静音时段控制；
• ​​工具类APP​​：定时提醒、系统警告通知的勿扰模式例外处理；
• ​​跨设备场景​​：手机与平板/智慧屏的角标同步与勿扰规则一致。

11. 疑难解答

​​11.1 问题1：角标数字未显示​​

• ​​可能原因​​：未启用通知渠道的 enableBadge: true，或设备系统不支持角标（如部分平板）；
• ​​解决方案​​：检查渠道配置中的 enableBadge 参数，确认设备型号是否支持角标功能（鸿蒙手机通常支持，平板/智慧屏可能仅支持红点）。

​​11.2 问题2：勿扰模式下紧急通知被屏蔽​​

• ​​可能原因​​：紧急通知的渠道 importance 未设置为 IMPORTANCE_MAX，或系统勿扰规则禁止所有通知；
• ​​解决方案​​：确保紧急通知渠道的 importance: IMPORTANCE_MAX，并测试不同勿扰模式设置（如“仅允许优先级通知”时是否生效）。

​​11.3 问题3：角标数字未更新​​

• ​​可能原因​​：应用未正确调用通知更新逻辑（如未修改 badgeNumber 或未调用 publish 方法）；
• ​​解决方案​​：在用户查看消息后，重新计算未读数并通过 sendBadgeNotification 方法发送更新后的角标数字。

12. 未来展望

​​12.1 技术趋势​​

• ​​多模态角标​​：未来鸿蒙可能支持更丰富的角标形式（如图标叠加、动画效果），而不仅是数字或红点；
• ​​智能勿扰模式​​：系统根据用户行为自动调整勿扰规则（如“工作时段静音营销通知，夜间静音所有通知”）；
• ​​跨设备角标同步​​：手机、平板、智慧屏等设备的应用角标实时同步（如手机未读消息同步到平板图标）；
• ​​通知优先级AI适配​​：通过机器学习预测用户对通知的重视程度，动态调整通知的角标与勿扰模式行为。

​​12.2 挑战​​

• ​​设备碎片化​​：不同鸿蒙设备（如手机、平板、车机）的角标显示规则与勿扰模式策略可能不同，需开发者适配多种场景；
• ​​用户隐私​​：角标数字关联用户的未读数据（如聊天记录），需确保数据安全与隐私合规；
• ​​复杂场景协调​​：多类型通知（如社交+工具+系统）在勿扰模式下的优先级冲突，需更精细的规则管理。

​​13. 总结​​

鸿蒙系统通知通过 ​​@ohos.notification 模块​​ 提供了完整的角标显示与勿扰模式适配能力，开发者可通过 ​​通知渠道配置​​ 控制角标数字与重要性级别，通过 ​​高优先级渠道​​ 突破勿扰模式限制，从而实现既符合系统规范又满足用户需求的通知功能。本文通过 ​​技术背景、典型场景（角标通知/勿扰适配）、完整代码示例（ArkTS）、原理解析（流程图）、测试步骤及疑难解答​​ 的系统解析，揭示了：

• ​​核心原理​​：通知渠道的 importance 与 enableBadge 参数决定角标与勿扰行为，高优先级渠道（IMPORTANCE_MAX）可绕过勿扰限制；
• ​​最佳实践​​：社交APP应关联未读数据更新角标，勿扰模式下仅发送紧急通知（通过高优先级渠道），并引导用户配置个性化偏好；
• ​​技术扩展​​：未来多模态角标与智能勿扰模式将进一步提升用户体验，开发者需持续关注鸿蒙API的演进；
• ​​开发者价值​​：掌握通知管理技术，开发者能够构建更专业、用户友好的鸿蒙应用，在保证信息触达的同时尊重用户的个性化设置。

合理运用角标与勿扰模式适配，是打造高质量鸿蒙通知功能的关键一步！