Push Kit 简介

Push Kit（推送服务）是个推提供的消息推送平台，建立了从云端到终端的消息推送通道。所有 OpenHarmony 应用可通过集成 Push Kit，实现向应用实时推送消息，使消息易见，构筑良好的用户关系，提升用户的感知度和活跃度 。

快速入门

请参考使用入门章节快速了解接入 Push Kit（推送服务）的必要步骤 。

产品优势

• 稳定的消息发送通道：Push Kit 通过提供系统级长链接，即使应用进程不在也能实时推送消息。
• 丰富的消息呈现样式：支持文本样式、通知大图标样式、多行文本样式、角标样式等多种消息展示方式。
• 灵活的场景化消息：开发者可以根据实际场景灵活接入场景化消息，如通过应用内通话消息实现音视频通话，通过语音播报消息实现语音播报业务处理，通过后台消息实现配置更新等。

推送消息提示场景

推送消息指的是应用通过 Push Kit 发送的，在 OpenHarmony 终端设备上显示的通知消息。显示场景主要包括通知中心、锁屏、横幅、桌面图标角标与通知图标。

有关各场景的详细说明请参见通知提示场景 。

推送消息类型

Push Kit 支持以下消息类型 ：

业务流程

说明： 业务流程中的 Push cloud 需对应为个推推送服务。

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

1. 应用调用Push Kit，获取Push Token。
2. 应用成功获取 Token 后，建议及时上报 Token 等信息至应用服务端。
3. 应用服务端向个推 Push Kit 服务端（个推推送服务）发送推送消息请求。应用的通知开关默认关闭，发送请求前，请先请求通知授权 。
4. Push Kit 服务端下发消息到 Push Kit 。
5. Push Kit 进行消息处理。

约束和限制

推送通道接入说明

目前 OpenHarmony 设备的推送功能通过个推通道提供服务 。设备制造商使用 OpenHarmony 系统时需使用推送能力，请与个推进行商务及技术对接 。

影响送达率的因素说明

Push Kit 致力于保障消息成功送达，影响因素如下 ：

• 终端设备是否在线：如果设备离线，Push Kit 会缓存消息，待上线后再推送 。
• 终端设备上应用是否被卸载 。
• 终端设备的网络状况是否稳定 。
• 终端设备的安全控制策略 。

推送消息的及时性

在端设备网络条件良好且不拥堵情况下，Push Kit 将使用智能推送策略以减少推送消息的时延。

说明：
为降低对用户的打扰，系统会学习用户的行为习惯，在预测的睡眠期间实施消息管控并暂时缓存消息（应用内通话或 category=VoIP 的消息除外） 。用户结束睡眠后，消息将重新投递 。

支持的国家/地区

Push Kit 当前支持的设备中，Wearable 设备支持的国家请参考相关说明 。其他设备仅支持中国境内（不含港澳台）。

支持的设备

推送服务能力支持 Phone、Tablet、PC/2in1、Wearable、TV 设备。

云真机说明

Push Kit 不支持云真机调试 。

与相关 Kit 的关系

• Notification Kit（用户通知服务）：如果开发者希望从本地推送通知，可通过此 Kit 创建 。
• Call Service Kit（通话服务）：推送应用内通话消息时，通过此 Kit 管理应用通话能力。

示例代码

Push Kit（推送服务）示例代码，请参考示例代码。