导入 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 仓库。
打开根目录下的
build.gradle
(Project 视图下),声明融云的 Maven 代码库。allprojects { repositories { ... //融云 maven 仓库地址 maven {url "https://maven.rongcloud.cn/repository/maven-releases/"} } }
已复制1
2
3
4
5
6
7在应用的
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' // 美颜扩展库(可选) }
已复制1
2
3
4
5
6
7
8
9- 各个 SDK 的最新版本号可能不相同,还可能是 x.y.z.h,可前往 融云官网 SDK 下载页面 或 融云的 Maven 代码库 查询。
- 从 5.2.0 版本开始,CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致(前三位必须保持一致)。
Android 本地库模块 (Module)
在导入 SDK 前,您需要 前往融云官网 SDK 下载页面,将音视频通话(含 UI)SDK 下载到本地。
在 Android Studio 中打开工程后,依次点击 File > New > Import Module,找到下载的 Module 组件并导入。
在应用的
build.gradle
中,添加本地库模块依赖项。dependencies { implementation project(':CallKit') implementation project(':CallLib') implementation project(':IMKit') implementation project(':IMLib') }
已复制1
2
3
4
5
6
源码手动导入
融云提供 CallKit 源码,是为方便开发者根据 App 风格对呼叫 UI 做个性化的修改,比如色调搭配,按钮位置等,都可以自由定制。
CallKit Github 源代码地址:GitHub · Gitee
先按照 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' }
已复制1
2
3
4
5- 融云不提供老版本 CallKit 开源代码下载。用户配合 CallKit 所使用的 CallLib、IMKit、IMLib 版本需要是官网当前最新版本。
- 从 5.2.0 版本开始,CallKit/CallLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致(前三位必须保持一致)。
进入工程目录,克隆 CallKit 源码:
cd <ProjectFolder> git clone https://github.com/rongcloud/callkit-android.git
已复制1
2在
settings.gradle
文件中,添加引用:include ':callkit-android'
已复制1在应用的
build.gradle
中,添加依赖:dependencies { ... implementation project(':callkit-android') }
已复制1
2
3
4