厂商通道

功能描述

SDK默认使用阿里云的长连接通道进行推送，同时SDK也支持通过鸿蒙系统的推送服务进行推送。

接入鸿蒙系统的推送服务后，当应用不在线时，可以通过鸿蒙系统的推送通道进行推送。

准备工作

请参考鸿蒙系统推送服务的开发准备文档开通推送服务、获取Client ID、申请场景化消费权益、获取Push Token。

请参考API Console操作指南-服务账号密钥创建并下载推送服务API的服务账号密钥。并参考配置厂商通道密钥配置鸿蒙厂商通道。

请参考HarmonyOS SDK接入完成设备注册。

注册鸿蒙Push Token

在设备注册之后，获取鸿蒙Push Token，通过SDK注册到阿里云移动推送平台，即可完成鸿蒙厂商通道的接入。示例代码如下：

import { aliyunPush } from '@aliyun/push';
import { pushService } from '@kit.PushKit';
import { BusinessError } from '@kit.BasicServicesKit';

pushService.getToken().then((pushToken) => {
  // ************* 注册PushToken begin *************
  aliyunPush.registerThirdToken(pushToken, (error) => {
    if (error) {
      console.error(`注册PushToken失败，错误码:${error.code} 错误信息${error.message}`);
      return;
    }
    console.info(`注册PushToken成功`);
  })
  // ************* 注册PushToken end *************
}).catch((error: BusinessError) => {
  console.error(`获取PushToken失败，错误码:${error.code} 错误信息${error.message}`);
})

注册鸿蒙PushToken是SDK接入流程的一部分，完整流程代码请参考SDK接入完整代码示例。

接收推送

当通过鸿蒙厂商通道推送时，通知会直接展示在设备通知栏，只有用户点击通知拉起应用时，应用才能感知到推送行为。

从通知中获取推送数据与阿里云的推送通道一样，请参考从通知中获取推送数据。