融云 SDK IMLib集成文档 – Android Studio

如果您对 UI 有较高订制需求，可集成融云 IMLib ，UI 界面由自已实现。

集成融云 IMLib 主要包括以下方面：

1、将 IMLib SDK 添加到你的 Project 中。

1.1、打开 AndroidManifest 修改 RONG_CLOUD_APP_KEY ，修改为你自己的 key。

注意，如果用 IMLib 集成，AndroidManifest 中的 GET_TASKS 权限可以去掉，其他权限仍然需要保留。

2、在 application 中调用  RongIMClient.init(this) 。

在 app 的 Module 下创建 一个 App 继承 Application，注意 App 需要 在 AndroidManifest 中配置

1. public class App extends Application {  
2.   
3.     @Override  
4.     public void onCreate() {  
5.         super.onCreate();  
6.         /** 
7.          * 初始化融云 
8.          */  
9.         RongIMClient.init(this);  
10.     }  
11. }  

3、在 activity 中连接融云，RongIMClient.connect(token,callback) 操作。

在 MainActivity 中做融云的连接操作。注意此处的 Token 为一个测试 Token，你需要换成你自己的 Token，这个 Token 还需要与 RONG_CLOUD_APP_KEY 匹配。

注意，在上线前请确认在 connect 方法 ConnectCallback 中通过 onTokenIncorrect 回调方法实现重新获取 Token 的逻辑。

1. package rong.io.demo;  
2.   
3. import android.support.v7.app.ActionBarActivity;  
4. import android.os.Bundle;  
5. import android.util.Log;  
6. import android.view.Menu;  
7. import android.view.MenuItem;  
8.   
9.   
10. public class MainActivity extends ActionBarActivity {  
11.   
12.     @Override  
13.     protected void onCreate(Bundle savedInstanceState) {  
14.         super.onCreate(savedInstanceState);  
15.         setContentView(R.layout.activity_main);  
16.   
17.         String Token = “d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==”;//test  
18.         /** 
19.          * IMKit SDK调用第二步 
20.          * 
21.          * 建立与服务器的连接 
22.          * 
23.          */  
24.         RongIMClient.connect(Token, new RongIMClient.ConnectCallback() {  
25.           @Override
26.            public void onTokenIncorrect() {
27.                //Connect Token 失效的状态处理，需要重新获取 Token
28.             }
29.             @Override  
30.             public void onSuccess(String userId) {  
31.                 Log.e(“MainActivity”, “——onSuccess—-” + userId);  
32.             }  
33.   
34.             @Override  
35.             public void onError(RongIMClient.ErrorCode errorCode) {  
36.                 Log.e(“MainActivity”, “——onError—-” + errorCode);  
37.             }  
38.         });  
39.     }  
40.   
41.     @Override  
42.     public boolean onCreateOptionsMenu(Menu menu) {  
43.         getMenuInflater().inflate(R.menu.menu_main, menu);  
44.         return true;  
45.     }  
46.   
47.     @Override  
48.     public boolean onOptionsItemSelected(MenuItem item) {  
49.    
50.         return super.onOptionsItemSelected(item);  
51.     }  
52. } 

4、连接成功后，开发者自已实现应用中逻辑处理。

IMLib API 文档参见：http://rongcloud.cn/docs/api/android/imlib/index.html

5、断开连接，默认断开后接收 Push 消息

调用方法：RongIMClient.disconnect()。

6、注册登录，不再接收 Push 消息

调用方法：RongIMClient.logout()。

IMKit 集成详解地址：http://blog.rongcloud.cn/?p=392