更新记录

5.2.2(2022-06-13)

发布 融云 IM 推送插件,支持 iOS、android 推送。支持安卓厂商通道推送。


平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 15

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


融云IM推送 Uni 原生插件

说明

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

使用步骤

1、将插件下载到本地,放入项目 nativeplugins 中,在项目 manifest.json --> App原生插件配置 --> 选择本地插件中勾选 RCUniPush 插件

2、在项目 manifest.json --> App模块配置 中勾选 Push 模块,不勾选unipush

3、配置推送

  • Android

    初始化 im 时,设置厂商推送的参数。厂商推送的申请可参考:融云推送开发指南

    import * as IMLib from "@/uni_modules/RongCloud-IMWrapper/js_sdk/index"
    
    let imSetup = {
    androidPushConfig: {
      miAppId: '小米推送 appId',
      miAppKey: '小米推送 appKey',
      meizuAppId: '魅族推送 appId',
      meizuAppKey: '魅族推送 appKey',
      oppoAppKey: 'oppo推送 appKey',
      oppoAppSecret: 'oppo推送 appSecret',
      enableVIVOPush: true,//true 开启vivo 推送
      enableHWPush: true, // true 开启华为推送
    }
    };
    IMLib.initWithSetup('融云appKey', imSetup);

    注意:

    • 华为vivo 推送需要在项目 manifest.json 本地插件处配置 华为 appIdvivo appIdappKey

    • 华为推送 需要 将官网下载的 agconnect-services.json 文件放到 nativeplugins/RongCloud-Push/android/assets/ 路径下。

  • iOS

    iOS 集成插件后,会在 im 初始化时自动上报 deviceToken,无需其他代码的配置。

4、获取点击推送的内容

const RCUniPush = uni.requireNativePlugin('RongCloud-Push-RCUniPush')

RCUniPush.setPushEventListener((data) => {
  console.log('setPushEventListener', data);
});

5、重新制作包含 RCUniPush 插件的自定义基座。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

"android.permission.RECEIVE_USER_PRESENT", "android.permission.INTERNET", "android.permission.READ_PHONE_STATE", "android.permission.WRITE_EXTERNAL_STORAGE", "android.permission.READ_EXTERNAL_STORAGE", "android.permission.WRITE_SETTINGS", "android.permission.ACCESS_NETWORK_STATE", "android.permission.ACCESS_WIFI_STATE", "android.permission.VIBRATE", "android.permission.CHANGE_NETWORK_STATE","${applicationId}.permission.MIPUSH_RECEIVE", "com.coloros.mcs.permission.RECIEVE_MCS_MESSAGE", "com.heytap.mcs.permission.RECIEVE_MCS_MESSAGE","com.meizu.flyme.push.permission.RECEIVE"

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

融云隐私合规文档: https://docs.rongcloud.cn/v4/5X/views/im/noui/intro/privacy.html

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

作者未提供license.md

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问