推送服务概述
uni-app 封装了设置推送参数的接口,并提供了推送插件。
集成推送功能
请参考 Android、iOS 端的推送文档进行。
注:仅需参考各个第三方厂商开放平台创建应用和控 制台中应用标识配置两部分内容,其余无需设置。
集成 RCUniPush 推送插件
说明: 本插件为融云 Push 插件,基于 RCUniIMV2。目前 Android 厂商推送支持 华为、小米、oppo、vivo、魅族。
使用步骤:
- 将插件下载到本地,放入项目 nativeplugins 中,在项目 manifest.json --> App原生插件配置 --> 选择本地插件中勾选 RCUniPush 插件
- 在项目 manifest.json --> App模块配置 中勾选 Push 模块,不勾选unipush
- 推送配置
- Android 初始化 im 时,设置 Android 第三方厂商推送的参数。
注意 华为 、vivo 推送需要在项目 manifest.json 本地插件处配置 华为 appId,vivo appId、appKey。 华为推送 需要 将官网下载的 agconnect-services.json 文件放到 nativeplugins/RongCloud-Push/android/assets/ 路径下。
- iOS iOS 集成插件后,会在 im 初始化时自动上报 deviceToken,无需其他代码的配置。
- 获取点击推送的内容
const RCUniPush = uni.requireNativePlugin('RongCloud-Push-RCUniPush')
RCUniPush.setPushEventListener((data) => {
console.log('setPushEventListener', data);
})
- 重新制作包含 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);