跳到主要内容

推送服务概述

uni-app 封装了设置推送参数的接口,并提供了推送插件。

集成推送功能

请参考 Android、iOS 端的推送文档进行。

注:仅需参考各个第三方厂商开放平台创建应用和控制台中应用标识配置两部分内容,其余无需设置。

集成 RCUniPush 推送插件

说明: 本插件为融云 Push 插件,基于 RCUniIMV2。目前 Android 厂商推送支持 华为、小米、oppo、vivo、魅族。

使用步骤:

  1. 将插件下载到本地,放入项目 nativeplugins 中,在项目 manifest.json --> App原生插件配置 --> 选择本地插件中勾选 RCUniPush 插件
  2. 在项目 manifest.json --> App模块配置 中勾选 Push 模块,不勾选unipush
  3. 推送配置
  • Android 初始化 im 时,设置 Android 第三方厂商推送的参数。

注意 华为 、vivo 推送需要在项目 manifest.json 本地插件处配置 华为 appId,vivo appId、appKey。 华为推送 需要 将官网下载的 agconnect-services.json 文件放到 nativeplugins/RongCloud-Push/android/assets/ 路径下。

  • iOS iOS 集成插件后,会在 im 初始化时自动上报 deviceToken,无需其他代码的配置。
  1. 获取点击推送的内容
const RCUniPush = uni.requireNativePlugin('RongCloud-Push-RCUniPush')
RCUniPush.setPushEventListener((data) => {
console.log('setPushEventListener', data);
})
  1. 重新制作包含 RCUniPush 插件的自定义基座

设置 Android 第三方推送

所属类:RCIMIWEngine

方法:

create(appKey: string, options: RCIMIWEngineOptions)

RCIMIWEngineOptions 中的推送配置说明

export interface RCIMIWPushOptions {
/**
* 小米推送 Id
*/
idMI?: string;

/**
* 小米推送 appKey
*/
appKeyMI?: string;

/**
* 魅族推送 Id
*/
appIdMeizu?: string;

/**
* 魅族推送 appKey
*/
appKeyMeizu?: string;

/**
* Oppo 推送 appKey
*/
appKeyOPPO?: string;

/**
* Oppo 推送 appSecret
*/
appSecretOPPO?: string;

/**
* 是否开启华为推送
*/
enableHWPush?: boolean;

/**
* 是否开启 Vivo 推送
*/
enableVIVOPush?: boolean;
}

代码示例

// RCIMIWEngineOptions
let options = {};
let pushOptions = {
idMI: 'xxx',
appKeyMI: 'xxx',
appIdMeizu: 'xxx',
appKeyMeizu: 'xxx',
appKeyOPPO: 'xxx',
appSecretOPPO: 'xxx',
enableHWPush: true,
enableVIVOPush: true,
};
options.pushOptions = pushOptions;
// 打开推送功能
options.enablePush = true;
let yourEngine = RCIMIWEngine.create(appKey, options);