融云 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.     }  

 

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