Notification Kit简介

使用场景

当应用进程处于运行时，开发者可以使用Notification Kit向用户发布通知。当应用进程终止后，本地通知发布通道关闭，开发者需要接入Push Kit进行云侧离线通知的发布。

开发者可以在多种场景中运用本地通知能力。如同步用户的上传下载进度、发布即时的客服支付通知、更新运动步数等。

能力范围

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

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

业务流程

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

1. 请求通知授权。

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

3. 将通知展示到通知中心。

通知样式

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

展开

类型	通知样式	规格描述
文本		通知文本内容最多显示三行，超长后以“...”截断。
多行文本		最多可显示三行内容，每行内容超长后以“...”截断。
通知角标		以数字的形式展示在右上角。
进度条		进度类通知。

约束限制

• 单个应用已发布的通知在通知中心等系统入口的留存数量有限（当前规格最多24条）。
• 通知的长度不能超过200KB（跨进程序列化大小限制）。
• 通知的发布频次和更新频次需要满足如下要求，否则会导致发布或更新失败，返回相应错误码。
  • 单个应用发布新通知的频次累计不能超过每秒10条，更新通知的频次累计不能超过每秒20条。
  • 所有三方应用发布新通知的频次累计不能超过每秒15条，更新通知的频次累计不能超过每秒30条。

违规处罚

应用发布的云端通知与本地通知都需遵守Push Kit的消息分类标准，如出现分类错误，违反消息分类标准的场景，将被判为违规。本地通知消息分类标准请参见通知渠道类型说明。

违规行为及相应的处理措施请参见违规分类、违规行为及违规处罚标准。

与相关Kit的关系

• Notification Kit创建的通知会即时显示在通知中心等系统入口。如果开发者希望在应用退到后台或进程终止后仍然有一些提醒用户的定时类通知，例如购物类应用抢购提醒等，可通过Background Tasks Kit创建。目前支持基于倒计时、日历、闹钟等类型的通知提醒功能。
• 开发者可通过Ability Kit的getWantAgent接口设置用户点击通知后的行为意图。
• 开发者可通过Push Kit远程推送用户通知到本地。

模拟器支持情况

本Kit支持模拟器。

模拟器与真机存在通用差异，详情请参见“模拟器与真机的差异”。