更新记录
5.8.2(2024-08-23) 下载此版本
1、升级原生 SDK 版本,iOS 5.8.2、Android 5.8.2
5.6.10(2024-04-01) 下载此版本
升级原生 RTC SDK 版本,android 5.6.9、iOS 5.6.10
5.6.4(2023-10-22) 下载此版本
升级融云原生 Android、iOS SDK 版本到 5.6.4
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 11.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:9 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
使用时,必须先引入即时通讯 RCUniIMV2
和实时音视频 RCUniCall
原生插件,再安装 Typescript 层 RongCloud-IMWrapper-V2
和 RongCloud-RTCWrapper
的依赖项。
步骤 1:导入 uni 原生插件
由于 uni-app 的 RongCloud-IMWrapper-V2
和 RongCloud-RTCWrapper
SDK 是在 uni 原生插件的基础上封装了 Typescript 调用层,导入 SDK 时,必须先引入 uni 原生插件。
请使用 HBuilder X 将即时通讯 RCUniIMV2
插件和实时音视频 RCUniCall
插件导入应用工程。
-
前往 uni-app 插件市场,购买(0 元)或 下载融云 uni-app 原生插件。
-
使用 HBuilder X 导入原生插件,并完成相应配置。请根据项目打包方式,选择合适的步骤。
-
云打包适用:
- 在插件市场操作
购买(0 元)for 云打包
后,然后在 HBuilder X 中,打开项目的manifest.json
文件。 - 点击 App原生插件配置 -> 选择云端插件 -> 选中 RCUniIMV2 / RCUniCall。
- 在插件市场操作
-
本地打包适用:
- 使用 HBuilder X 在项目根目录下创建
nativeplugins
文件夹。 - 将下载的插件解压之后放入
nativeplugins
文件夹中。 - 在 HBuilder X 中,打开项目的
manifest.json
文件。 -
点击 App原生插件配置 -> 选择本地插件 -> 选中 RCUniIMV2 / RCUniCall。
请参照以下
nativeplugins
文件目录结构:nativeplugins └── RongCloud-IM-V2 └── RongCloud-RTC
插件内部目录说明:
android
目录:包含融云 uni-app Android 原生插件ios
目录:包含融云 uni-app iOS 原生插件package.json
:插件的依赖
- 使用 HBuilder X 在项目根目录下创建
-
步骤 2:安装 Typescript 依赖项
原生插件配置完成后,还需要安装两个 Typescript 层的依赖项。
即时通讯依赖项
请从 uni-app 插件市场安装 RongCloud-IMWrapper-V2
:
https://ext.dcloud.net.cn/plugin?id=9225
音视频通话依赖项
请从 uni-app 插件市场安装 RongCloud-RTCWrapper
:
https://ext.dcloud.net.cn/plugin?id=7419
步骤 3:在代码中导入 SDK
// IM
import RCIMIWEngine from "@/uni_modules/RongCloud-IMWrapper-V2/js_sdk/RCIMEngine"
// RTC
import RCRTCEngine from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCEngine';