帮你快速理解、总结文档立即下载
文档中心>即时通信 IM>推送服务（Push）>快速接入>SDK 接入>HarmonyOS

HarmonyOS

最近更新时间：2026-09-01 17:30:30
我的收藏

本页目录：

前提条件

请确认已 开通 Push 服务 并完成 厂商配置。

AI 集成

通过 npx 安装 @tencent-rtc/trtc-push-skill 到本地 AI IDE 中，辅助完成 TIMPush 离线推送集成。安装后，您可以直接向 AI 输入“集成 Harmonyos 离线推送”等需求，AI 将根据项目类型引导您完成环境检测、厂商通道配置、凭据填写、代码接入和验证等步骤。详情可参考 AI Coding。

手动集成

步骤1：集成 TIMPush

集成 SDK：
// 版本号 “VERSION” 请前往 更新日志 中获取配置。
// oh-package.json5 中配置集成包
dependencies: {
    "@tencentcloud/timpush": "^VERSION",
    "@tencentcloud/imsdk": "^VERSION",
}

步骤2：注册推送

调用接口推送注册成功后，就可以收到离线推送通知了。
import { TIMPushListener, TIMPushManager, TIMPushMessage } from '@tencentcloud/timpush';

TIMPushManager.getInstance()
  .registerPush(context, 您的 sdkAppId, "客户端密钥", IM 控制台证书 ID)
  .then((result) => {
    console.log("registerPush success：", result.message);
  })
  .catch((error: Error) => {
    console.log("registerPush failed", error.code, error.message);
  })

步骤3：消息触达统计配置

如果您需要统计触达数据，请按照如下完成配置：

回执地址：https://api.im.qcloud.com/v3/offline_push_report/harmony

步骤4：发送推送消息

您可以在 接入测试 指定 RegistrationID/userID 进行离线推送测试。REST API 接口详细说明可参见：全员/标签推送。

步骤5：解析离线推送消息

收到推送消息后点击通知栏，组件会回调该点击事件和透传离线消息。
注意：
1. 注册回调时机必须放在应用 UIAbility 的 onCreate() 函数中。
2. 控制台配置点击后续动作按如下配置，选择打开应用内指定界面，请勿修改默认值。

let pushListener: TIMPushListener = {
  onNotificationClicked: (data) => {
    console.log("onNotificationClicked", data);
  }
}

TIMPushManager.getInstance().addPushListener(pushListener);

接入排查

如果接入完成收不到推送，请使用 排查工具 查看具体原因。排查后依然异常，请 联系我们 提交反馈。
中国站