Android快速集成融云

自己闲暇没事就想搞搞即时通讯，选了融云去集成一下，操作不是很难，一起来看一下。
首先了解一下融云的组成库都有那些：
1、IMKit 集成了会话界面，并且提供了丰富的自定义功能，我们推荐首次接触融云的客户直接使用 IMKit 来快速集成和开发。
2、IMLib 提供了基础的通信能力，较轻量，适用于对 UI 有较高订制需求的开发者，但您需要自己去实现大量的界面和功能。
3、CallKit 融云音视频通话的界面组件，包含了单人、多人音视频通话的界面的各种场景和功能。您可以通过集成该组件来实现丰富的音视频通话界面，并进行自己的 UI 定制开发。同时我们开源了 CallKit，您可以根据您的需要去使用。
4、CallLib 融云音视频通话核心能力组件。
5、LocationLib 位置相关库文件
6、PushLib 融云支持第三方推送（小米），您可以从这里下载对应的第三方推送 jar 包。
7、RedPacket 融云红包相关组件，通过集成该组件，即可快速实现红包功能。
自己测试demo只集成了IMLib 和IMKit 两个库，完成基本的单聊与群聊。需要其他功能的请按官方文档集成。

第一步 注册开发者账号，创建应用。（拿到App Key）

1.png

第二步 下载 SDK
下载地址 http://www.rongcloud.cn/downloads

第三步 将model导入工程

IMLib 是基础包必须导入，同样的方式导入IMKit 包（两个包缺一不可，别忘记让app依赖这两个model）
将 PushLib 中的 jar 包 和 pushDaemon -> libs 目录下应用所支持平台的 so 拷贝到您应用的 libs 目录下，另外还需要将 pushDaemon -> executable 目录下各平台的可执行文件 push_daemon 拷贝到您应用 Module 的 assets 目录下。如图：

2.png

注意 : 放置 so 的文件夹位置需要和您 build.gradle 文件中配置的 jni 目录一致。

3.png

打开 IMLib Module 的 AndroidManifest.xml 文件，把 meta-data RONG_CLOUD_APP_KEY 的值修改为您自己的 AppKey. 如图：

4.png

在应用的 App Module 的 AndroidManifest.xml 文件中，添加 FileProvider 相关配置，修改 android:authorities 为 “您的应用的包名称.FileProvider”。

5.png

到此集成完毕，IMKit 集成方式跟IMLib一样（必须集成）
第四步 初始化
在 application 中调用 RongIM.init(this);
public class App extends Application {

@Override
public void onCreate() {
    super.onCreate();
    //初始化融云
    RongIM.init(this);
}

}
运行程序可能会出现错误 ”初始化 RongIM.init(this) 时报错 Failed resolution of: Lio/rong/push/PushService”
解决办法： http://support.rongcloud.cn/kb/NjY5](http://support.rongcloud.cn/kb/NjY5)

获取Token
可以在融云官网获取 Touken 如图：

6.png

7.png

在 activity 中连接融云，RongIM.connect（token,callback）操作。
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// token 就是你刚刚获取的token
RongIM.connect(token, new RongIMClient.ConnectCallback() {
//token1参数报错
@Override
public void onTokenIncorrect() {
Log.e(“TAG”,”参数错误”);
Toast.makeText(MainActivity.this, “token1参数报错”, Toast.LENGTH_SHORT).show();
}

        @Override
        public void onSuccess(String s) {
            Log.e("TAG","成功");
            // 连接成功，说明你已成功连接到融云Server
            Toast.makeText(MainActivity.this, "连接成功 ", Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onError(RongIMClient.ErrorCode errorCode) {
            Log.e("TAG","失败");
            Toast.makeText(MainActivity.this, errorCode.getValue()+"", Toast.LENGTH_SHORT).show();
        }
    });

第五步 集成单聊
1、配置会话列表
配置布局文件
这是您的会话列表 Activity 对应的布局文件：conversationlist.xml。注意 android:name 固定为融云的 ConversationListFragment。
?xml version=”1.0” encoding=”utf-8”?
LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android”
android:orientation=”vertical” android:layout_width=”match_parent”
android:layout_height=”match_parent”>

 fragment
    android:id="@+id/conversationlist"
    android:name="io.rong.imkit.fragment.ConversationListFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

/LinearLayout>
新建Activity

public class ConversationListActivity extends FragmentActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.conversationlist);
}

}
配置 intent-filter：
融云 SDK 是通过隐式调用的方式来实现界面跳转的。因此您需要在 AndroidManifest.xml 中，您的会话列表 Activity 下面配置 intent-filter，其中，android:host 是您应用的包名，需要手动修改，其他请保持不变。

!–会话列表–
activity
android:name=”io.rong.fast.activity.ConversationListActivity”
android:screenOrientation=”portrait”
android:windowSoftInputMode=”stateHidden|adjustResize”>

 intent-filter>
     action android:name="android.intent.action.VIEW" />

     category android:name="android.intent.category.DEFAULT" />

     data
        android:host="io.rong.fast"
        android:pathPrefix="/conversationlist"
        android:scheme="rong" />
 /intent-filter>

/activity>
2、配置会话界面
会话 Fragment 跟会话列表是完全一致的，您可以用同样的方式快速的配置好。

配置布局文件
这是您的会话列表 Activity 对应的布局文件：conversationlist.xml。注意 android:name 固定为融云的 ConversationListFragment。

?xml version=”1.0” encoding=”utf-8”?>
LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android”
android:layout_width=”match_parent”
android:layout_height=”match_parent”
android:orientation=”vertical”>

 fragment
    android:id="@+id/conversation"
    android:name="io.rong.imkit.fragment.ConversationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

/LinearLayout>
新建Activity

public class ConversationActivity extends FragmentActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.conversation);
}

}
配置 intent-filter：
在 AndroidManifest.xml 中，会话 Activity 下面配置 intent-filter。 注意请修改 android:host 为您应用的包名，其他保持不变。

!–会话界面–>
activity
android:name=”io.rong.fast.activity.ConversationActivity”
android:screenOrientation=”portrait”
android:windowSoftInputMode=”stateHidden|adjustResize”>

  intent-filter>
      action android:name="android.intent.action.VIEW" />

      category android:name="android.intent.category.DEFAULT" />

      data
         android:host="io.rong.fast"
         android:pathPrefix="/conversation/"
         android:scheme="rong" />
  /intent-filter>

/activity>
配置两个界面后就可以进行聊天了。

填写代码
//启动会话界面
findViewById(R.id.btn_chat_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//启动会话界面
if (RongIM.getInstance() != null)
RongIM.getInstance().startPrivateChat(MainActivity.this, “18673668975”, “贝吉塔”);
}
});
//启动会话列表
findViewById(R.id.btn_chatlist_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//启动会话列表
startActivity(new Intent(MainActivity.this, HomeActivity.class));
}
});
//创建群聊
findViewById(R.id.btn_createGroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//创建群聊
final List String> testList = new ArrayList String>();
testList.add(“18673668975”);
testList.add(“18673668976”);
testList.add(“18673668977”);
RongIM.getInstance().createDiscussion(“123”, testList, new RongIMClient.CreateDiscussionCallback() {
@Override
public void onSuccess(String s) {
// s 表示的是群组ID
Toast.makeText(MainActivity.this,s,Toast.LENGTH_SHORT).show();
ed = (EditText) findViewById(R.id.ed_id_main);
ed.setText(s);
roomId=s;

                    }
                    @Override
                    public void onError(RongIMClient.ErrorCode errorCode) {
                        //  Toast.makeText(MainActivity.this,errorCode.getValue()+"",Toast.LENGTH_SHORT).show();
                    }
                });

        }
    });

//进入群聊
findViewById(R.id.btn_joingroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {

            RongIM.getInstance().startDiscussionChat(MainActivity.this,群组ID,"123");
        }
    });

//添加讨论组成员
findViewById(R.id.btn_addgroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
final ArrayList String> userIds = new ArrayList String>();
userIds.add(“10”);//增加 userId。
RongIM.getInstance().addMemberToDiscussion(roomId, userIds, new RongIMClient.OperationCallback() {
@Override
public void onSuccess() {
Toast.makeText(MainActivity.this, “添加成功”, Toast.LENGTH_SHORT).show();
}

                @Override
                public void onError(RongIMClient.ErrorCode errorCode) {
                    Toast.makeText(MainActivity.this,errorCode.getValue()+"",Toast.LENGTH_SHORT).show();
                }
            });
        }
    });

//移除讨论组成员
findViewById(R.id.btn_delgroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {

                        RongIM.getInstance().getRongIMClient().removeMemberFromDiscussion("bac45e36-3ef3-45b5-9047-dd25054c27ae", "10", new RongIMClient.OperationCallback() {
                            @Override
                            public void onSuccess() {
                                Toast.makeText(MainActivity.this, "移除成功", Toast.LENGTH_SHORT).show();
                            }

                            @Override
                            public void onError(RongIMClient.ErrorCode errorCode) {
                                Toast.makeText(MainActivity.this, errorCode.getValue()+"", Toast.LENGTH_SHORT).show();
                            }
                        });
        }
    });
    //发送消息
    findViewById(R.id.btn_sendmessage_main).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {

            // 构造 TextMessage 实例
            TextMessage myTextMessage = TextMessage.obtain("发送消息");
            /* 生成 Message 对象。
            * "7127" 为目标 Id。根据不同的 conversationType，可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id。
            * Conversation.ConversationType.PRIVATE 为私聊会话类型，根据需要，也可以传入其它会话类型，如群组，讨论组等。
            */
            Message myMessage = Message.obtain("18673668975", Conversation.ConversationType.PRIVATE, myTextMessage);

            RongIM.getInstance().sendMessage(myMessage, null, null, new IRongCallback.ISendMessageCallback() {
                @Override
                public void onAttached(Message message) {
                    //消息本地数据库存储成功的回调
                    Toast.makeText(MainActivity.this, "本地数据库存储成功", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onSuccess(Message message) {
                    //消息通过网络发送成功的回调
                    Toast.makeText(MainActivity.this, "网络发送成功", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onError(Message message, RongIMClient.ErrorCode errorCode) {
                    //消息发送失败的回调
                    Toast.makeText(MainActivity.this, "发送失败", Toast.LENGTH_SHORT).show();
                }
            });
        }
    });

}

以上几个方法，自己琢磨一下就能用了，如何集成到项目中你还需要好好考虑一下

六 添加好友
融云没有添加好友这个概念
具体流程思想 看看这个链接你就会懂 http://support.rongcloud.cn/kb/MzQ5
我自己就搞了这么多，需要什么自己下个嗨豹研究一下它的代码，我看了一下不算难。