API | 描述 |
setRegistrationID | 设置注册推送服务使用的推送 ID 标识，即 RegistrationID，需要在注册推送服务之前调用。 |
getRegistrationID | 注册推送服务成功后，获取推送 ID 标识，即 RegistrationID。 |
registerPush | 注册推送服务 (必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务)。 |
unRegisterPush | 反注册关闭推送服务。 |
addPushListener | 订阅推送事件，如点击通知栏事件。 |
removePushListener | 取消订阅推送事件。 |
disablePostNotificationInForeground | 应用在前台时，开/关通知栏通知（默认开）。 |
createNotificationChannel | 创建客户端通知 channel。此接口可实现自定义铃音功能。 |
setCustomBadgeNumber | 设置应用角标数字（仅华为、iOS）。 |
registerPush(sdkAppID: number, appKey: string): Promise<JSON>;
参数 | 类型 | 说明 |
sdkAppID | number | Push 应用的 SDKAppID。 |
appKey | string | Push 应用的客户端密钥。 |
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success","data":{"token":"xxx"}}，失败返回 { errCode: number, errMsg: string }。 |
unRegisterPush(): Promise<JSON>;
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }。 |
setRegistrationID(registrationID: string): Promise<JSON>;
参数 | 类型 | 必填 | 说明 |
registrationID | string | 是 | 设备的推送标识 ID，卸载重装会改变。 |
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }。 |
getRegistrationID(): Promise<JSON>;
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success","data":{"registrationID":"xxx"}}，失败返回 { errCode: number, errMsg: string }。 |
addPushListener(eventName: string, listener: (res: any) => void): void;
参数 | 类型 | 必填 | 说明 |
eventName | string | 是 | 推送事件类型，可查看 Push.EventName。 |
listener | (res: any) => void | 是 | 推送事件处理方法。 |
removePushListener(eventName: string, listener: (res: any) => void): void;
参数 | 类型 | 必填 | 说明 |
eventName | string | 是 | 推送事件类型，可查看 Push.EventName。 |
listener | (res: any) => void | 是 | 推送事件处理方法。 |
disablePostNotificationInForeground(disable: boolean): void;
参数 | 类型 | 必填 | 说明 |
disable | boolean | 是 | 应用在前台时，开/关通知栏通知，默认开： true: 应用在前台时，关闭通知栏通知。 false: 应用在前台时，开启通知栏通知。 |
createNotificationChannel(options: {channelID: string;channelName: string;channelDesc?: string;channelSound?: string;}): Promise<JSON>;
参数 | 类型 | 必填 | 说明 |
options.channelID | String | 是 | 自定义 channel 的 ID。 |
options.channelName | String | 是 | 自定义 channel 的名称。 |
options.channelDesc | String | 否 | 自定义 channel 的描述。 |
options.channelSound | String | 否 | 自定义 channel 铃音的音频文件名，不带文件扩展名，音频文件需要放到 xxx/android/nativeResources/res/raw 中。 例如：options.channelSound = private_ring，即设置 xxx/android/nativeResources/res/raw/private_ring.mp3 为自定义铃音。 |
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }。 |
setCustomBadgeNumber(badgeNumber: number): Promise<JSON>;
参数 | 类型 | 必填 | 说明 |
badgeNumber | number | 是 | 应用角标数字。 |
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success"}，失败返回 { errCode: number, errMsg: string }。 |
文档反馈