HarmonyOS

最近更新时间:2025-08-18 17:11:12

我的收藏

TIMPushManager 接口概览

API
描述
registerPush
注册推送服务, (必须在 App 用户同意了隐私政策后,再调用该接口使用推送服务)。
unRegisterPush
反注册关闭推送服务。
setRegistrationID
RegistrationID 是推送接收设备的唯一标识 ID。默认情况下,注册推送服务成功时自动生成该 ID,同时也支持您自定义设置。您可根据 RegistrationID 向指定设备推送消息。需要注意的是,卸载并重新安装设备会更改 RegistrationID,因此需要在注册推送服务之前调用 setRegistrationID 接口。
getRegistrationID
在成功注册推送服务后,调用此接口可获取推送接收设备的唯一标识 ID,即 RegistrationID。
addPushListener
添加 Push 监听器。
removePushListener
移除 Push 监听器。
disablePostNotificationInForeground
应用在前台时,开/关通知栏通知(默认开)。

接口详情

注册推送服务

接口

registerPush(
context: Context,
sdkAppId?: number,
appKey?: string,
businessId?: number
): Promise<TIMPushResult>;

参数说明:

参数
类型
说明
获取路径
context
Context
应用上下文
-
sdkAppId
number
推送服务 Push 的 SDKAppID。



appKey
String
推送服务 Push 的客户端密钥。
businessId
number
IM 控制台分配的证书 ID。


反注册关闭推送服务

接口

unRegisterPush(): Promise<TIMPushResult>;

设置推送 ID 标识 RegistrationID

说明:
1. 如果您调用此接口,请务必在 registerPush 前调用。

接口

setRegistrationID(registrationID: string): Promise<TIMPushResult>;

参数说明:

参数
类型
说明
registrationID
String
自定义的推送 ID 标识。

获取推送 ID 标识 RegistrationID

说明:
若您调用过 setRegistrationID 接口设置标识 ID,此接口将返回您设置的标识 ID,否则返回由 Push SDK 生成的随机值。

接口

getRegistrationID(): Promise<TIMPushResult>;

添加 Push 监听器

接口

addPushListener(listener: TIMPushListener): void;

参数说明:

参数
类型
说明
listener
推送事件处理方法。

移除 Push 监听器

接口

removePushListener(listener: TIMPushListener): void;

参数说明:

参数
类型
说明
listener
推送事件处理方法。

应用在前台时,开/关通知栏通知

接口

disablePostNotificationInForeground(disable: boolean): void;

参数说明:

参数
类型
说明
disable
boolean
应用在前台时,开/关通知栏通知,默认关闭:
true: 应用在前台时,关闭通知栏通知。
false: 应用在前台时,开启通知栏通知。

TIMPushListener 接口概览

API
描述
onRecvPushMessage
收到 Push 消息。
onRevokePushMessage
收到 Push 消息撤回的通知。
onNotificationClicked
点击通知栏消息回调。

接口详情

成员函数说明

onMessageReceived(message: TIMPushMessage): void;
收到 Push 消息,message 消息。
onRevokePushMessage(messageID: string): void;
收到 Push 消息撤回的通知,messageID 消息唯一标识。
onNotificationClicked(ext: string): void;
点击通知栏消息回调。