导入 SDK

由于 uni-app 的 SDK 是在 uni 原生插件的基础上封装了 Typescript 调用层，导入 SDK 时，必须先引入 uni 原生插件。

步骤 1：导入 uni 原生插件

uni 原生插件均已上架 uni-app 插件市场。

• 即时通讯 uni 原生插件 RCUniIMV2

• 实时音视频 uni 原生插件 RCUniRtc

请使用 HBuilder X 将即时通讯 RCUniIMV2 插件和实时音视频 RCUniRtc 插件导入应用工程。

1.1 下载插件

前往 uni-app 插件市场，购买（0 元）或 下载融云 uni-app 原生插件 RCUniIMV2 和 RCUniRtc。

1.2 导入插件

使用 HBuilder X 导入原生插件，并完成相应配置。请根据项目打包方式，选择合适的步骤。

云打包适用

1. 在插件市场操作购买（0 元）for 云打包后，然后在 HBuilder X 中，打开项目的 manifest.json 文件。
2. 点击 App原生插件配置 -> 选择云端插件 -> 选中 RCUniIM/RCUniRtc。

本地打包适用

1. 使用 HBuilder X 在项目根目录下创建 nativeplugins 文件夹。
2. 将下载的插件解压之后放入 nativeplugins 文件夹中。
3. 在 HBuilder X 中，打开项目的 manifest.json 文件。
4. 点击 App原生插件配置 -> 选择本地插件 -> 选中 RCUniIM/RCUniRtc。

请参照以下 nativeplugins 文件目录结构：

nativeplugins
└── RongCloud-IM
    ├── android
    │   ├── RCUniIM.aar
    ├── ios
    │   ├── RCUniIM.xcframework
    │   ├── RongChatRoom.xcframework
    │   └── RongIMLibCore.xcframework
    └── package.json
└── RongCloud-RTC
    ├── android
    │   ├── RCUniRtc-release.aar
    │   ├── libs
    │       ├── RongRTCWrapper.jar
    ├── ios
    │   ├── RCUniRtc.xcframework
    │   └── RongIMLibCore.xcframework
    │   └── RongRTCLib.xcframework
    │   └── RongRTCLibWrapper.xcframework
    └── package.json

目录说明：

• android 目录：包含融云 uni-app Android 原生插件
• ios 目录：包含融云 uni-app iOS 原生插件
• package.json：插件的依赖

步骤 2：安装 Typescript 依赖项

原生插件配置完成后，还需要安装两个 Typescript 层的依赖项。

uni Typescript 插件均已上架 uni-app 插件市场。

• 即时通讯 Typescript 插件 RongCloud-IMWrapper-V2

• 实时音视频 Typescript 插件 RongCloud-RTCWrapper

2.1 安装依赖

在 HBuilder X 中，通过插件市场安装以下依赖：

1. RongCloud-IMWrapper-V2 - 即时通讯 Typescript 插件
2. RongCloud-RTCWrapper - 实时音视频 Typescript 插件

步骤 3：在代码中导入 SDK

3.1 导入 IM SDK

方法

JavaScript

import RCIMIWEngine from "@/uni_modules/RongCloud-IMWrapper-V2/js_sdk/RCIMEngine";

示例代码

JavaScript

// IM SDK 导入
import RCIMIWEngine from "@/uni_modules/RongCloud-IMWrapper-V2/js_sdk/RCIMEngine";
console.log('IM SDK 导入成功');

3.2 导入 RTC SDK

方法

JavaScript

import RCRTCEngine from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCEngine';

示例代码

JavaScript

// RTC SDK 导入
import RCRTCEngine from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCEngine';
console.log('RTC SDK 导入成功');

3.3 导入类型定义

方法

JavaScript

import {
    RCRTCMediaType,
    RCRTCEngineEventsName,
    RCRTCStatsEventsName,
} from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCDefines';

示例代码

JavaScript

// 导入 RTC 定义（以下为示例，开发者可按需导入类型定义）
import {
    RCRTCMediaType,
    RCRTCEngineEventsName,
    RCRTCStatsEventsName,
} from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCDefines';
console.log('RTC 类型定义导入成功');

3.4 完整导入示例

示例代码

JavaScript

// IM SDK
import RCIMIWEngine from "@/uni_modules/RongCloud-IMWrapper-V2/js_sdk/RCIMEngine";

// RTC SDK
import RCRTCEngine from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCEngine';

// 导入 RTC 定义（以下为示例，开发者可按需导入类型定义）
import {
    RCRTCMediaType,
    RCRTCEngineEventsName,
    RCRTCStatsEventsName,
} from '@/uni_modules/RongCloud-RTCWrapper/lib/RCRTCDefines';

console.log('SDK 导入完成');

版本依赖说明

依赖SDK	版本
RTCLib	5.1.17