跳到主要内容

导入 CallKit SDK

融云支持使用 Maven 远程仓库、本地库模块(Module)和源代码三种方式,将 CallKit SDK 导入到您的应用工程中。

环境要求

  • (SDK ≧ 5.6.3)使用 Android 5.0(API 21)或更高版本
  • (SDK < 5.6.3)使用 Android 4.4(API 19)或更高版本

检查版本

在导入 SDK 前,您可以前往 融云官网 SDK 下载页面 确认当前最新版本号。

Maven

使用 Gradle 添加对 CallKit、CallLib、IMKit、IMLib 四个模块的依赖关系。请注意使用 融云的 Maven 仓库

  1. 打开根目录下的 build.gradleProject 视图下),声明融云的 Maven 代码库。

    allprojects {
    repositories {
    ...
    //融云 maven 仓库地址
    maven {url "https://maven.rongcloud.cn/repository/maven-releases/"}
    }
    }
  2. 在应用的 build.gradle 中,添加如下远程依赖项。注意,融云 RTC 业务依赖 IM 通道,所以必须同时集成 IMLib。

    dependencies {
    // x.y.z,请填写具体的 SDK 版本号,新集成用户建议使用最新版。
    implementation 'cn.rongcloud.sdk:call_kit:x.y.z'
    implementation 'cn.rongcloud.sdk:call_lib:x.y.z'
    implementation 'cn.rongcloud.sdk:im_kit:x.y.z'
    implementation 'cn.rongcloud.sdk:im_lib:x.y.z'

    implementation 'cn.rongcloud.sdk:face_beautifier:x.y.z' // 美颜扩展库(可选)
    }

    注意

    • 各个 SDK 的最新版本号可能不相同,还可能是 x.y.z.h,可前往 融云官网 SDK 下载页面融云的 Maven 代码库 查询。
    • 从 5.2.0 版本开始,CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致(前三位必须保持一致)。

Android 本地库模块 (Module)

在导入 SDK 前,您需要 前往融云官网 SDK 下载页面,将音视频通话(含 UI)SDK 下载到本地。

  1. 在 Android Studio 中打开工程后,依次点击 File > New > Import Module,找到下载的 Module 组件并导入。

  2. 在应用的 build.gradle 中,添加本地库模块依赖项。

    dependencies {
    implementation project(':CallKit')
    implementation project(':CallLib')
    implementation project(':IMKit')
    implementation project(':IMLib')
    }

源码手动导入

融云提供 CallKit 源码,是为方便开发者根据 App 风格对呼叫 UI 做个性化的修改,比如色调搭配,按钮位置等,都可以自由定制。

CallKit Github 源代码地址GitHub · Gitee

  1. 先按照 Maven 导入或本地手动导入的方式,集成 CallLib、IMKit、IMLib 三个 CallKit 依赖库,并确保都是当时官网的最新版本,如下:

    dependencies {
    implementation 'cn.rongcloud.sdk:call_lib:x.y.z'
    implementation 'cn.rongcloud.sdk:im_kit:x.y.z'
    implementation 'cn.rongcloud.sdk:im_lib:x.y.z'
    }

    注意

    • 融云不提供老版本 CallKit 开源代码下载。用户配合 CallKit 所使用的 CallLib、IMKit、IMLib 版本需要是官网当前最新版本。
    • 从 5.2.0 版本开始,CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致(前三位必须保持一致)。
  2. 进入工程目录,克隆 CallKit 源码:

    cd <ProjectFolder>
    git clone https://github.com/rongcloud/callkit-android.git
  3. settings.gradle 文件中,添加引用:

    include ':callkit-android'
  4. 在应用的 build.gradle 中,添加依赖:

    dependencies {
    ...
    implementation project(':callkit-android')
    }