接口概览
API | 描述 |
registerPush | 注册推送服务， (必须在 App 用户同意了隐私政策后，再调用该接口使用推送服务)。 |
unRegisterPush | 反注册关闭推送服务。 |
setRegistrationID | 设置推送设备标识 ID。 RegistrationID 是推送接收设备的唯一标识 ID。默认情况下，注册推送服务成功时自动生成该 ID，同时也支持您自定义设置。请注意！如您调用此接口，请务必在 registerPush 前调用。适用场景举例： 若您同时集成了消息服务（Chat）和推送服务（Push），在某个设备上，用户登录 Chat 的 userID 假设为 "user123"，如果您想指定向 "user123" 推送消息，则需要调用此接口设置设备标识 ID，如下： Push.setRegistrationID("user123", () => {}); |
getRegistrationID | 在成功注册推送服务后，调用此接口可获取推送接收设备的唯一标识 ID，即 RegistrationID。 注意： 若您调用过 setRegistrationID 接口设置标识 ID，此接口将返回您设置的标识 ID，否则返回由 Push SDK 生成的随机值。 |
getNotificationExtInfo | 收到离线推送时，点击通知栏拉起 App，调用此接口可获取推送扩展信息。 |
addPushListener | 添加 Push 监听器。 |
removePushListener | 移除 Push 监听器。 |
接口详情
注册推送服务
接口
registerPush(SDKAppID: number, appKey: string, onSuccess: (data: string) => void, onError?: (errCode: number, errMsg: string) => void);
参数说明：
参数 | 类型 | 说明 | 获取路径 |
SDKAppID | Number | 推送服务 Push 的 SDKAppID。 |  |
appKey | String | 推送服务 Push 的客户端密钥。 | |
onSuccess | Function | 注册推送成功的回调。 | |
onError | Function ｜undefined | 注册推送失败的回调。 | |
反注册关闭推送服务
接口
unRegisterPush(onSuccess: () => void, onError?: (errCode: number, errMsg: string) => void): void;
参数说明：
参数 | 类型 | 说明 |
onSuccess | Function | 反注册推送成功的回调。 |
onError | Function ｜undefined | 反注册推送失败的回调。 |
设置推送 ID 标识 RegistrationID
说明：
需要在注册推送服务之前调用。
接口
setRegistrationID(registrationID: string, onSuccess: () => void): void;
参数说明：
参数 | 类型 | 说明 |
registrationID | String | 自定义的推送 ID 标识。 |
onSuccess | Function | 设置自定义推送 ID 标识成功后的回调。 |
获取推送 ID 标识 RegistrationID
说明：
需要在注册推送服务成功之后调用。
接口
getRegistrationID(onSuccess: (registrationID: string) => void): void;
参数说明：
参数 | 类型 | 说明 |
onSuccess | Function | 获取推送 ID 标识成功的回调。 |
获取点击透传的内容
说明：
收到离线推送时，点击通知栏拉起 App，调用此接口可获取推送扩展信息。
接口
getNotificationExtInfo(onSuccess: (extInfo: string) => void): void;
参数说明：
参数 | 类型 | 说明 |
onSuccess | Function | 获取点击透传的内容成功的回调。 |
添加 Push 监听器。
接口
addPushListener(eventName: string, listener: (data: any) => void);
参数说明：
参数 | 类型 | 说明 |
eventName | String | 推送事件类型。 |
listener | Function | 推送事件处理方法。 |
移除 Push 监听器。
接口
removePushListener(eventName: string, listener?: (data: any) => void);
参数说明：
参数 | 类型 | 说明 |
eventName | String | 推送事件类型。 |
listener | Function | undefined | 推送事件处理方法。 |
