# Notification Kit简介

Notification Kit（[用户通知服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-kit用户通知服务)）为开发者提供[本地通知](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#local-notification本地通知)发布通道，开发者可借助Notification Kit将应用产生的通知直接在客户端本地推送给用户，本地通知根据通知类型及发布场景会产生对应的铃声、振动、横幅、锁屏、自动亮屏、状态栏图标和[通知中心](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-center通知中心)的显示。

## 使用场景

当应用进程处于运行时，开发者可以使用Notification Kit向用户发布通知。当应用进程终止后，本地通知发布通道关闭，开发者需要接入[Push Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-kit-introduction)进行云侧离线通知的发布。

开发者可以在多种场景中运用[本地通知](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#local-notification本地通知)能力。如同步用户的上传下载进度、发布即时的客服支付通知、更新运动步数等。

## 能力范围

Notification Kit支持的能力主要包括：

* 发布文本、进度条等类型通知。
* 携带或更新应用通知数字角标。
* 取消曾经发布的某条或全部通知。
* 查询已发布的通知列表。
* 查询应用自身通知开关状态。
* 应用通知用户的能力默认关闭，开发者可拉起授权框，请求用户授权发布通知。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f8/v3/cfAaJ_TmTf-edYnN2G2xtA/zh-cn_image_0000002784583643.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=862295A3D9FFC0E1EFBFB52B2AE8C74A583597BF82047EBF1D94C515501289B6)

## 业务流程

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c/v3/9IMow3okQ9avJwiP5SNXhQ/zh-cn_image_0000002784663823.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=A3D664E81A9CC37915DD86047A220E4FEA2D97FDFA8AE5B3EC5C89C3E0190297)

使用Notification Kit的主要业务流程如下：

1. 请求[通知授权](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-authorization通知授权)。

2. 应用发布通知到通知服务。

3. 将通知展示到[通知中心](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-center通知中心)。

## 通知样式

> 说明
>
> 实际显示效果依赖设备能力和[通知中心](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-center通知中心)UI设计样式。

Notification Kit中常用的通知样式如下：

|类型|通知样式|规格描述|
|:---------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------|
|[文本](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/text-notification)|![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/DpGOIGTnQRCWNohZKPHcIQ/zh-cn_image_0000002755024890.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=39419EBFBB2D94E0AB3AB5BFA1695DF266B6EEDD901B6B0A3475B3137B87E698)|通知文本内容最多显示三行，超长后以"..."截断。|
|[多行文本](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/text-notification)|![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f0/v3/OeSVvH06RDOmsji6Qdb8oQ/zh-cn_image_0000002755184778.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=81C45917AC101EE48F832C04CF050A81CABC69F8F96D6F88B2C07D4FEBCE721E)|最多可显示三行内容，每行内容超长后以"..."截断。|
|[通知角标](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-badge)|![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b6/v3/jgmenS7ATnSO_y1Lsy7-Lw/zh-cn_image_0000002784583645.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=1F4E9C5010815DF234B625274B43F97952FC7FC673DAF9D95BC05532C6D946C7)|以数字的形式展示在右上角。|
|[进度条](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/progress-bar-notification)|![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ac/v3/wldkKhs_QfaWU3RDGUyxhg/zh-cn_image_0000002784663825.png?HW-CC-KV=V1&HW-CC-Date=20261009T092709Z&HW-CC-Expire=31536000000&HW-CC-Sign=6484405E5EA65EA7CB6ECEB1BD6555C82641D900FFBC851564C9E8E0915E8AB1)|进度类通知。|

## 约束限制

* 单个应用已发布的通知在[通知中心](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-center通知中心)等系统入口的留存数量有限（当前规格最多24条）。
* 通知的长度不能超过200KB（跨进程序列化大小限制）。
* 通知的发布频次和更新频次需要满足如下要求，否则会导致发布或更新失败，返回相应错误码。
  * 单个应用发布新通知的频次累计不能超过每秒10条，更新通知的频次累计不能超过每秒20条。
  * 所有三方应用发布新通知的频次累计不能超过每秒15条，更新通知的频次累计不能超过每秒30条。

## 违规处罚

应用发布的云端通知与本地通知都需遵守Push Kit的[消息分类标准](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-apply-right#通知消息分类标准与提醒方式)，如出现分类错误，违反消息分类标准的场景，将被判为违规。本地通知消息分类标准请参见[通知渠道类型说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-slot#通知渠道类型说明)。

违规行为及相应的处理措施请参见[违规分类、违规行为及违规处罚标准](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-punishment-standards)。

## 与相关Kit的关系

* Notification Kit创建的通知会即时显示在[通知中心](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-glossary#notification-center通知中心)等系统入口。如果开发者希望在应用退到后台或进程终止后仍然有一些提醒用户的定时类通知，例如购物类应用抢购提醒等，可通过[Background Tasks Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/background-task-overview)创建。目前支持基于倒计时、日历、闹钟等类型的通知提醒功能。
* 开发者可通过[Ability Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/abilitykit-overview)的[getWantAgent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-wantagent#wantagentgetwantagent)接口设置用户点击通知后的行为意图。
* 开发者可通过[Push Kit](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-kit-introduction)远程推送用户通知到本地。

## 模拟器支持情况

本Kit支持模拟器。

模拟器与真机存在通用差异，详情请参见"[模拟器与真机的差异](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-specification)"。