文档导航
uni-app
SDK 版本:  5.X

推送概述

更新时间:2024-03-18 PDF

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

集成推送功能

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

  • 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
2
3
4

  1. 重新制作包含 RCUniPush 插件的自定义基座

设置 Android 第三方推送

所属类:RCIMIWEngine

方法:

create(appKey: string, options: RCIMIWEngineOptions)
              
已复制
1

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;
}
              
已复制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

代码示例

// 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);
              
已复制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

文档反馈
意见反馈

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈