接口概览
API | 描述 |
setRegistrationID | 设置注册推送服务使用的推送 ID 标识，即 RegistrationID，需要在注册推送服务之前调用。 |
getRegistrationID | 注册推送服务成功后，获取推送 ID 标识，即 RegistrationID。 |
registerPush | 注册推送服务 (必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务)。 |
unRegisterPush | 反注册关闭推送服务。 |
addPushListener | 订阅推送事件，如点击通知栏事件。 |
removePushListener | 取消订阅推送事件。 |
接口详情
注册推送服务
注意：
必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务。否则可能因提前获取用户隐私导致上架失败。
接口
registerPush(sdkAppID: number, appKey: string): Promise<JSON>;
参数说明
参数 | 类型 | 说明 | 获取路径 |
sdkAppID | number | 推送（Push）应用 ID |  |
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 } |
设置推送 ID 标识 RegistrationID
注意：
需要在注册推送服务之前调用。
接口
setRegistrationID(registrationID: string): Promise<JSON>;
参数说明
参数 | 类型 | 必填 | 说明 |
registrationID | string | 是 | 设备的推送标识 ID，卸载重装会改变 |
返回值说明
返回值 | 说明 |
Promise | 成功返回 {"errCode":0,"errMsg":"success","data":{"token":"xxx"}}，失败返回 { errCode: number, errMsg: string } |
获取推送 ID 标识 RegistrationID
说明：
需要在注册推送服务成功之后调用。
接口
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 | 是 | 推送事件处理方法 |
