跳到主要内容

安装 CallLib SDK

您可以通过 NPM 或 CDN 安装 CallLib 及其依赖的 IMLib 和 RTCLib。

实时音视频通话功能依赖 IMLib(即时通讯能力库)提供信令通道,同时 CallLib 依赖 RTCLib(音视频基础能力库)实现音视频能力。因此,基于 CallLib 开发应用时,需集成以下库:

  • IMLib(即时通讯能力库),推荐使用 5.X 版本。
  • RTCLib(音视频基础能力库)5.X 版本。
  • CallLib(音视频通话能力库)5.X 版本。

通过 NPM 安装

您需要安装以下三个 NPM 模块。

如为新集成融云 SDK 的用户,可跳过步骤 1、2、3,直接在项目根目录下打开终端,执行以下命令一次性安装全部模块:

shell
npm install @rongcloud/engine@latest @rongcloud/imlib-next --save
npm install @rongcloud/plugin-rtc --save
npm install @rongcloud/plugin-call --save

步骤 1:安装 IMLib

IMLib 支持 2.X、5.X 版本,IM 功能可与其他版本及平台的 IMLib SDK 互通。

新集成用户推荐使用 IMLib 5.X。如需使用 2.X 版本,建议配合对应 Adapter SDK。

  • 安装 IMLib 5.X(推荐)

    shell
    # 安装 IMLib 5.X
    npm install @rongcloud/engine@latest @rongcloud/imlib-next@latest --save
  • 安装 IMLib 2.X 版本 Adapter SDK

    shell
    # @rongcloud/imlib-v2 已停止维护,推荐使用 RongIMLib-v2-Adapter
    # 旧版 imlib-v2 要求版本 ≥ 2.10
    # npm install @rongcloud/imlib-v2 --save
    #
    # 安装 RongIMLib-v2-Adapter
    npm install @rongcloud/engine@latest @rongcloud/imlib-v2-adapter@latest -S

步骤 2:安装 RTCLib

需安装 RTCLib 5.2.0 或更高版本。

shell
# 安装 RTCLib
npm install @rongcloud/plugin-rtc --save

步骤 3:安装 CallLib

shell
# 安装 CallLib
npm install @rongcloud/plugin-call --save

步骤 4:导入模块

全部模块安装完成后,可在代码中导入 IMLib、RTCLib 和 CallLib。

  1. 导入 IMLib。请根据实际安装的 IMLib 版本选择导入方式。

    typescript
    // 导入 IMLib 5.X
    import * as RongIMLib from "@rongcloud/imlib-next";

    // 或,导入 @rongcloud/imlib-v2-adapter
    import { RongIMClient, IMClient } from "@rongcloud/imlib-v2";
  2. 导入 RTCLib 和 CallLib。

    typescript
    // 导入 RTCLib、CallLib
    import { installer as rtcInstaller, RCRTCClient, RCTrack, RCFrameRate, RCResolution } from "@rongcloud/plugin-rtc";

    import { installer as callInstaller, RCCallClient, RCCallSession, RCCallErrorCode, ISessionListener, IEndSummary, ISenderInfo, IMuteUser, IInvitedUsers, RCCallLanguage, RCCallEndReason, RCCallMediaType, IOfflineRecord, RCCallSessionState } from "@rongcloud/plugin-call";

通过 CDN 安装

CallLib 及其依赖的 IMLib、RTCLib 均支持通过 CDN 引入。

  1. 安装 IMLib(推荐新集成用户使用 IMLib 5.X)。

    html
    <!-- 安装 IMLib 5.X(推荐) -->
    <script src="https://cdn.ronghub.com/RongIMLib-5.24.0.prod.js"></script>

    <!-- 或,安装 RongIMLib-v2-Adapter -->
    <script src="https://cdn.ronghub.com/RongIMLib-v2-Adapter-5.24.0.prod.js"></script>
  2. 安装 RTCLib 和 CallLib。

    html
    <!-- RTCLib 5.X -->
    <script src="https://cdn.ronghub.com/RCRTC-5.24.0.prod.js"></script>
    <!-- CallLib -->
    <script src="https://cdn.ronghub.com/RCCall-5.24.0.prod.js"></script>
  3. 全部引入后,可直接在代码中使用 IMLib、RTCLib 和 CallLib。各库的全局变量如下:

    • IMLib 全局变量:RongIMLib
    • RTCLib 全局变量:RCRTC
    • CallLib 全局变量:RCCall

    初始化客户端时需用到上述全局变量,具体用法请参考实现音视频通话文档。