跳转至

Quick start

有两种方式可以将 SDK 导入您的项目中:

  • 通过 maven 管理依赖 (推荐使用)
  • 手动导入 SDK 并管理依赖

开发者在集成 RongRTCLib 之前首先需要集成 RongIMLib,如果开发者项目中已经依赖 RongIMLib 则不需要重复集成,初始化 IMSDK,并且与服务器建立连接参考 IM 文档

Maven 集成

1、在项目根 build.gradle 设置 maven 仓库

    mavenCentral()
    maven {url  "https://dl.bintray.com/rongcloud/maven"}

2、根据需要版本添加如下依赖

    api 'cn.rongcloud.rtclib:rtc_lib:3.1.3'

手动导入

1、下载音视频SDK,将下载的 RongRTCLib.jar 和 lib_RongRTC_so.so 按照下图展示拷贝到 app 的 libs 文件夹下。

image

2、gradle 中 android 节点 添加 jniLib 依赖

sourceSets.main {
    jniLibs.srcDir 'libs'
    jni.srcDirs = []
}

3、gradle 中 dependencies 节点添加 jar 依赖

implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation project(':IMLib')

4、权限配置,AndroidManifest.xml 中添加如下权限。

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

快速集成示例

快速集成流程

加入房间

设置本地预览视图,发布资源

订阅远端用户音视频资源,设置远端预览视图

离开房间

代码示例:

 // 详情请查看demo
 RongRTCEngine.getInstance().joinRoom(mRoomId, new JoinRoomUICallBack() {
                    @Override
                    protected void onUiSuccess(RongRTCRoom rongRTCRoom) {
                        mRongRTCRoom = rongRTCRoom;
                        mLocalUser = rongRTCRoom.getLocalUser();
                        RongRTCCapture.getInstance().setRongRTCVideoView(local); //设置本地预览视图
                        RongRTCCapture.getInstance().startCameraCapture();       //开始采集数据
                        setEventListener();                                      //设置监听
                        addRemoteUsersView();
                        subscribeAll();                                          //订阅资源
                        publishDefaultStream();                                  //发布资源
                    }

                    @Override
                    protected void onUiFailed(RTCErrorCode rtcErrorCode) {

                    }
                });

集成 Demo 示例

融云在 GitHub 上提供了快速集成 Demo 代码示例,方便开发者参考。