输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
  • 更多

使用入门

更新时间: 2026-04-30 09:02
本文导读

示例代码

开发者可以参考服务端示例代码，了解推送Push场景化消息的过程。参考客户端示例代码，了解生成Push Token和接收Push场景化消息的功能和流程。

开发流程

开发者需要按照流程来完成应用的开发工作，以推送通知消息为例，完整的开发流程如下：

展开
序号 步骤 说明
1 开通推送服务

在开发应用前，请先参考操作步骤开通推送服务。其中配置签名信息时，请使用手动签名方式。

DevEco Studio 6.0.0 Beta5版本开始，新增自动签名方式。
2 申请通知消息自分类权益

· 请根据通知消息分类标准，申请对应场景化消息权益。不同类型的消息有对应的通知消息分类标准与提醒方式和通知消息推送数量管理规则。

· 若未开通权益，或开通的权益类型与调用REST API推送场景化消息时，请求体中携带的category字段值不一致，消息将会默认归为资讯营销类消息，则会受到“单个应用每日每设备推送数量为2条或5条”的频控限制。若超出限制，设备将会收不到该条消息。

· 调测阶段建议设置testMessage为true，以防发送成功的消息被频控，设备将会收不到该条消息。

· 若消息被频控，请参考频控FAQ进行问题排查。
3 客户端获取Push Token 调用Push Kit REST API时，需要设置token参数，对应的参数值参考获取Push Token进行获取。注意Push Token变化的场景，若设备的Push Token发生变化但服务端调用Push Kit REST API时未更新token的值，将会导致设备收不到该条消息。
4 客户端请求通知授权 为确保应用可正常收到消息，应用发送通知前需调用requestEnableNotification()方法弹出提醒，告知用户需要允许接收通知消息。示例代码参见开发步骤中第2步。
5 客户端配置skills标签 为确保点击消息可以正常跳转应用页面，在应用项目中完成skills标签配置，详情请参见点击消息动作。
6 服务端基于服务账号生成鉴权令牌 调用Push Kit REST API推送场景化消息时，请求头需设置Authorization参数，请参考基于服务账号生成鉴权令牌章节进行获取。
7 服务端调用REST API推送场景化消息 应用服务端参考HarmonyOS NEXT版本请求体结构说明、请求体参数说明发送REST API请求。若请求失败请参考响应参数进行问题排查，若请求成功但设备未收到消息请参考FAQ进行问题排查。
8 （可选）开发消息回执 Push服务端会将消息送达状态以回执消息形式发送给您的应用回执服务端，方便您获取消息下达端侧后的状态，定位问题。详情请参考开发消息回执。
9 （可选）客户端收到并处理消息 通过服务端请求传参和客户端的数据获取，可以进行服务端和客户端的数据传递。

（可选）其他消息类型

Push Kit支持的所有消息类型及使用场景可以参考推送消息类型。

如通过应用内通话消息实现音视频通话，通过语音播报消息实现语音播报业务处理，通过后台消息实现配置更新等。

  • 部分场景化消息类型需要您申请特殊权益才能正常发送，详情请参考场景化消息权益简介。

  • 权益申请通过后，请参考对应消息类型的开发指南章节进行开发。

    说明

    如果您的项目之前已经基于HarmonyOS 3.x/4.x的系统接入过Push Kit，现在需要给HarmonyOS Next/5.x及之后的系统版本推送通知，客户端和服务端仍然需要按照上述开发流程重新进行开发。

简体中文
搜索
请输入您想要搜索的关键词