文档管理中心

场景化消息开发Skill

概述

场景化消息开发Skill,旨在帮助开发者快速集成Push Kit推送场景化消息。Skill包含客户端与服务端两部分,可自动生成客户端页面代码与服务端接口工程,支持端到端验证,有效简化接入流程、降低开发成本。

能力覆盖范围

场景化消息开发Skill能帮助开发者快速接入Push Kit,并实现推送场景化消息。其中:

  • 客户端Skill负责生成推送通知消息、后台消息、应用内通话消息的ArkTS代码以及配置工程依赖。
  • 服务端Skill负责生成服务端工程代码,实现Push场景化消息发送能力。

注意事项

  • 客户端Skill生成的代码需在ArkTS工程中运行,当前仅支持ArkTS开发框架。

  • 服务端Skill目前仅支持生成java代码。

  • 请务必在集成发布前,在测试环境中充分验证所生成代码的正确性与安全性。

使用方式

下载并配置Skill

点击下方链接下载对应Skill,并放到AI编码工具(如DevEco CodeGenie、Claude Code等)的Skill配置目录下(不同工具规范不一致,按工具要求处理)。

  • 客户端Skill:生成推送通知消息、后台消息、应用内通话消息的ArkTS代码以及配置工程依赖。
  • 服务端Skill:生成服务端工程代码,实现Push场景化消息发送能力。

DevEco CodeGenie接入示例

  1. 打开DevEco Studio之后,在右侧工具栏点击CodeGenie,详情见DevEco CodeGenie工具概述

  2. 参考操作步骤导入Skill。如图所示,选择在下载并配置Skill中下载的Skill,需要导入名为hmos-push-kit的文件夹,以及4个子文件夹。

  3. 全部导入成功后,如图所示。

  4. 回到对话页面,选择HarmonyOS Act以及合适的模型,并按需求输入提示词。如图所示,CodeGenie调用对应技能接入Push Kit。

  5. 接入完成后,CodeGenie会提示需要开通推送服务等注意事项。

触发Skill

展开
触发方式 示例
关键词触发 “帮我接入推送服务”
Skill名称触发 “使用hmos-push-kit,帮我接入推送服务”
展开
客户端技能 Skill名称 关键词 说明
推送服务集成助手Skill hmos-push-kit 帮我接入推送服务 若使用该关键词正确触发主skill,AI编码工具会向开发者询问具体接入哪种场景。目前支持接入以下三种场景。
通知消息Skill hmos-push-kit-notification 帮我接入通知消息 通知消息场景子skill。还可以触发的关键词,如:接入notification、接入push推送通知消息等相似语义。
后台消息Skill hmos-push-kit-background 帮我接入后台消息 后台消息场景子skill。还可以触发的关键词,如:接入background、添加后台消息功能等相似语义。
应用内通话消息Skill hmos-push-kit-voip 帮我接入应用内通话 应用内通话场景子skill。还可以触发的关键词,如:接入voip、添加应用内通话等相似语义。
展开
服务端技能 Skill名称 关键词 说明
Push Kit服务端Skill hmos-push-kit-server-integration 帮我生成Push消息发送服务端java代码 服务端Skill目前支持通知消息的发送与撤回,以及应用内通话消息的发送。
请输入您想要搜索的关键词