学习Push Kit接入规范
为维护华为通知生态秩序，保障用户合法权益和良好的使用体验，根据现行法律法规及《华为开发者服务协议》、《华为APIs使用协议》、《华为推送服务使用协议》、《应用审核指南》、《元服务审核指南》，特制定本规范。
所有发布上架到华为应用市场且使用推送通知行为的HarmonyOS应用、联运应用及元服务（以下简称应用）应当遵守本规范，若开发者的行为违反本规范或《华为应用市场联运服务协议》，华为有权根据本规范和《华为应用市场联运违规处罚规定》对开发者进行处罚。
Push Kit使用基本原则
- HarmonyOS应用的推送消息，需通过华为官方的消息推送平台下发。
- 遵守通知样式规范，禁止采用规范外样式，以保证通知体验的一致性。
- 通知开关需由用户授权允许，应用首次启动时需弹窗询问用户是否允许通知。
- 不可出于商业目的强制改变通知属性（如采用进行中通知强制置顶显示），避免损害用户使用体验。
- 遵守通知内容管理细则。
通知内容
为保障推送内容信息的合法性、真实客观性、一致性、可读性，以及用户良好的通知使用体验，请您遵守通知内容管理细则。
通知样式
通知样式规范概要
| 总体原则 | 例外 |
|---|---|
| 不得伪造其他应用的推送消息，包括伪造应用icon、消息内容等。 | - |
| 应用通知不得隐藏应用自身的icon。 | - |
| 禁止使用不符合设计规范的样式。 | - |
| 不得利用当前系统内仍存在的通知，将特定通知强制置顶显示。 | 语音、视频通话、媒体播放、进度类通知（下载、更新、上传等）、录音、导航、投屏、运动计时、步数。 |
| 不得更改一键删除按钮。 | - |
| 不得伪造横幅通知、锁屏通知。 | - |
| 不得重复发送相同内容的通知打扰用户。 | - |
| 通知标题与文本内容不得重复。 | - |
文本样式
| 描述 | 图片展示 |
|---|---|
| 通知文本内容最多可显示3行，超长后以“...”截断。 | 请参考设计-通知-普通通知。 |
通知角标
应用收到消息后以数字的形式展示角标，提醒用户查看消息。
| 描述 | 图片展示 |
|---|---|
| 以数字的形式展示在右上角。 | 请参考设计-通知-桌面图标角标。 |
Wearable、TV不支持此通知样式。
通知大图标
| 描述 | 图片展示 |
|---|---|
| 适用于有图片预览的通知。 | 请参考设计-通知-图片预览通知。 |
通知大图标需要满足以下要求：
- 图片格式建议使用JPG/JPEG/PNG/BMP/WEBP，图片像素的总字节数不超过192KB，若超过则图片不展示。
- 避免使用饱和度较高的颜色和纯色（如纯黑色、纯红色），颜色纯度和亮度的范围在10%-90%。
- 图片应清晰可读，避免使用影响图片信息阅读体验的元素，包括但不限于二维码、马赛克、明显噪点、密集排布的文字和符号等。
- 图片品质应与通知整体内容品质一致，避免使用内容复杂、排版凌乱、元素混杂、影响整体视觉效果的图片。
- 图片不可影响通知必要文字内容的阅读。
Wearable不支持此通知样式。
多行文本样式
应用的通知内容文字较多，且通知消息内容需有序展示。
| 描述 | 图片展示 |
|---|---|
| 适用于文本内容较长的通知，最多可显示3行内容，每行内容超长后以“...”截断。 | 请参考设计-通知-多行文本类通知。 |
Wearable不支持此通知样式。
通知跳转
- 不得以推送消息为手段，利用本应用唤醒其他应用。
- 通知点击跳转链接不得为非法网站。
- 不得利用推送消息诱导下载安装第三方应用。
通知开关授权
- 应用首次启动时需询问用户通知开关是否需要开启。
- 未获取用户授权，应用的通知开关默认为关闭状态。
其他
- 应用不得擅自篡改、损坏、反编译Push Kit提供的服务功能，改变Push Kit的基本功能。
- 避免出现其他可能影响终端用户体验的行为。
- 应用使用推送服务时，推荐接入应用内通知设置快捷入口，便于用户找到应用内的通知分类控制开关，提升用户通知管理的体验，减少应用通知关闭率。