# 学习Push Kit接入规范

为维护华为通知生态秩序，保障用户合法权益和良好的使用体验，根据现行法律法规及[《华为开发者服务协议》](https://developer.huawei.com/consumer/cn/doc/start/agreement-0000001052728169)、[《华为APIs使用协议》](https://developer.huawei.com/consumer/cn/doc/20209)、[《华为推送服务使用协议》](https://developer.huawei.com/consumer/cn/doc/app/20213)、[《应用审核指南》](https://developer.huawei.com/consumer/cn/doc/app/50104)、[《元服务审核指南》](https://developer.huawei.com/consumer/cn/doc/app/50129)，特制定本规范。

所有发布上架到华为应用市场且使用推送通知行为的HarmonyOS应用、联运应用及元服务（以下简称应用）应当遵守本规范，若开发者的行为违反本规范或[《华为应用市场联运服务协议》](https://developer.huawei.com/consumer/cn/doc/app/20204)，华为有权根据本规范和[《华为应用市场联运违规处罚规定》](https://developer.huawei.com/consumer/cn/doc/app/20204)对开发者进行处罚。  

#### Push Kit使用基本原则

* HarmonyOS应用的推送消息，需通过华为官方的消息推送平台下发。

* 遵守[通知样式规范](#通知样式规范概要)，禁止采用规范外样式，以保证通知体验的一致性。

* 通知开关需由用户授权允许，应用首次启动时需弹窗询问用户是否允许通知。

* 不可出于商业目的强制改变通知属性（如采用进行中通知强制置顶显示），避免损害用户使用体验。

* 遵守[通知内容管理细则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-detail-rules)。

#### 通知内容

为保障推送内容信息的合法性、真实客观性、一致性、可读性，以及用户良好的通知使用体验，请您遵守[通知内容管理细则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-detail-rules)。  

#### 通知样式

#### 通知样式规范概要

|总体原则|例外|
|:------------------------------|:----------------------------------------------|
|不得伪造其他应用的推送消息，包括伪造应用icon、消息内容等。|-|
|应用通知不得隐藏应用自身的icon。|-|
|禁止使用不符合设计规范的样式。|-|
|不得利用当前系统内仍存在的通知，将特定通知强制置顶显示。|语音、视频通话、媒体播放、进度类通知（下载、更新、上传等）、录音、导航、投屏、运动计时、步数。|
|不得更改一键删除按钮。|-|
|不得伪造横幅通知、锁屏通知。|-|
|不得重复发送相同内容的通知打扰用户。|-|
|通知标题与文本内容不得重复。|-|

#### 文本样式

|描述|图片展示|
|:-------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------|
|通知文本内容最多可显示3行，超长后以"..."截断。|请参考[设计-通知-普通通知](https://developer.huawei.com/consumer/cn/doc/design-guides/system-features-notification-0000001793074217#section4182426382)。|

#### 通知角标

应用收到消息后以数字的形式展示角标，提醒用户查看消息。  

|描述|图片展示|
|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------|
|以数字的形式展示在右上角。|请参考[设计-通知-桌面图标角标](https://developer.huawei.com/consumer/cn/doc/design-guides/system-features-notification-0000001793074217#section20838133494210)。|

![](https://media:301785151505354194)  
Wearable、TV不支持此通知样式。  

#### 通知大图标

|描述|图片展示|
|:-----------|:-------------------------------------------------------------------------------------------------------------------------------------------------|
|适用于有图片预览的通知。|请参考[设计-通知-图片预览通知](https://developer.huawei.com/consumer/cn/doc/design-guides/system-features-notification-0000001793074217#section16214134103817)。|

通知大图标需要满足以下要求：

* 图片格式建议使用JPG/JPEG/PNG/BMP/WEBP，图片像素的总字节数不超过192KB，若超过则图片不展示。

* 避免使用饱和度较高的颜色和纯色（如纯黑色、纯红色），颜色纯度和亮度的范围在10%-90%。

* 图片应清晰可读，避免使用影响图片信息阅读体验的元素，包括但不限于二维码、马赛克、明显噪点、密集排布的文字和符号等。

* 图片品质应与通知整体内容品质一致，避免使用内容复杂、排版凌乱、元素混杂、影响整体视觉效果的图片。

* 图片不可影响通知必要文字内容的阅读。

![](https://media:301785151505378196)  
Wearable不支持此通知样式。  

#### 多行文本样式

应用的通知内容文字较多，且通知消息内容需有序展示。  

|描述|图片展示|
|:--------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------|
|适用于文本内容较长的通知，最多可显示3行内容，每行内容超长后以"..."截断。|请参考[设计-通知-多行文本类通知](https://developer.huawei.com/consumer/cn/doc/design-guides/system-features-notification-0000001793074217#section148485300395)。|

![](https://media:301785151505404198)  
Wearable不支持此通知样式。  

#### 通知跳转

* 不得以推送消息为手段，利用本应用唤醒其他应用。

* 通知点击跳转链接不得为非法网站。

* 不得利用推送消息诱导下载安装第三方应用。

#### 通知开关授权

* 应用首次启动时需询问用户通知开关是否需要开启。

* 未获取用户授权，应用的通知开关默认为关闭状态。

#### 其他

* 应用不得擅自篡改、损坏、反编译Push Kit提供的服务功能，改变Push Kit的基本功能。

* 避免出现其他可能影响终端用户体验的行为。

* 应用使用Push Kit时，推荐接入[应用内通知设置快捷入口](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/notification-shortcut-settings)，便于用户找到应用内的通知分类控制开关，提升用户通知管理的体验，减少应用通知关闭率。