融云 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 中配置
- public class App extends Application {
- @Override
- public void onCreate() {
- super.onCreate();
- /**
- * 初始化融云
- */
- RongIMClient.init(this);
- }
- }
3、在 activity 中连接融云,RongIMClient.connect(token,callback) 操作。
在 MainActivity 中做融云的连接操作。注意此处的 Token 为一个测试 Token,你需要换成你自己的 Token,这个 Token 还需要与 RONG_CLOUD_APP_KEY 匹配。
注意,在上线前请确认在 connect 方法 ConnectCallback 中通过 onTokenIncorrect 回调方法实现重新获取 Token 的逻辑。
- package rong.io.demo;
- import android.support.v7.app.ActionBarActivity;
- import android.os.Bundle;
- import android.util.Log;
- import android.view.Menu;
- import android.view.MenuItem;
- public class MainActivity extends ActionBarActivity {
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.activity_main);
- String Token = “d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==”;//test
- /**
- * IMKit SDK调用第二步
- *
- * 建立与服务器的连接
- *
- */
- RongIMClient.connect(Token, new RongIMClient.ConnectCallback() {
- @Override
- public void onTokenIncorrect() {
- //Connect Token 失效的状态处理,需要重新获取 Token
- }
- @Override
- public void onSuccess(String userId) {
- Log.e(“MainActivity”, “——onSuccess—-” + userId);
- }
- @Override
- public void onError(RongIMClient.ErrorCode errorCode) {
- Log.e(“MainActivity”, “——onError—-” + errorCode);
- }
- });
- }
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- getMenuInflater().inflate(R.menu.menu_main, menu);
- return true;
- }
- @Override
- public boolean onOptionsItemSelected(MenuItem item) {
- return super.onOptionsItemSelected(item);
- }
- }
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