Android及时通讯之--------融云篇
想一想,世界可能会更好。 ---来自未来的诗人杜鹏鹏
前些天项目中接入了融云及时通讯,闲了无事,做一个小小的总结。
使用 Android Studio 集成融云,基本可以分为一下几个步骤:
1.进入融云官网Android 下载页面(附网址:http://www.rongcloud.cn/downloads),分为两种,IMKit SDK和IMLib SDK。IMLib库是属于自己定制需求的,IMKit基本就满足一般项目的需求了,所以我这里用的是IMKit SDK,有兴趣的同学可以研究一下另一个.
2.将 IMKitsdk 作为 Module 导入到 Project 中,在 application 中调用RongIM.init(this);
3.在 activity 中连接融云,RongIM.connect(token,callback)操作。当然这个操作的前提是你已经从公司后台服务器中获取到了Token。因为考虑到登录融云操作可能在其他地方:断网后再来连接/被挤下线等。所以我把这个操作单另写了一个类,具体联网方法:
* **/*建立与融云服务器的连接*/** *public voidconnect() {* *if(context.getApplicationInfo().packageName.equals(BTCollegeApp.getCurProcessName(BTCollegeApp.getAppContext()))) {* */* IMKit SDK调用第二步,建立与服务器的连接*/* *RongIM.connect(token, newRongIMClient.ConnectCallback() {* */*Token错误,在线上环境下主要是因为Token已经过期,您需要向App Server重新请求一个新的Token*/* *@Override* *public voidonTokenIncorrect() {* *Log.e("LoginActivity错误","--onTokenIncorrect");* *}* */*** **连接融云成功* **@paramuserid当前token* **/* *@Override* *public voidonSuccess(String userid) {* *Log.e("LoginActivity成功","--onSuccess"+ userid);* *userID= userid;* *rongCloudInit();* *}* */*** **连接融云失败* **@paramerrorCode错误码,可到官网 查看错误码对应的注释* **/* *@Override* *public voidonError(RongIMClient.ErrorCode errorCode) {* *Log.d("LoginActivity失败","--onError"+ errorCode);* *}* *});* *}* *}* *
4.这里我们分开关注两个点:会话列表和会话界面
1>.会话界面
新建ConversationActivity类,然后在其布局文件中写自己的定制界面(一般是标题栏),对话界面融云已经帮我们写好了,只需要将这段代码复制即可:
<fragment
android:id="@+id/chat_window_fragment"
android:layout_below="@+id/conversation_topbar"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:name="io.rong.imkit.fragment.ConversationFragment"/>
设置标题:
Uri uri= getIntent().getData();
userID= uri.getQueryParameter("targetId").toString();
title= uri.getQueryParameter("title").toString();
2>.会话列表
会话列表分为两种情况:会话列表在activity中,会话类别在fragment中。如果会话列表在activity中,属于常规情况,查阅官方文档即可。下面具体说一下第二种情况:
首先在会话列表所在的fragment类的布局文件中添加以下代码:
android:id="@+id/rong_content"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
然后在此fragment类中添加以下代码
ConversationListFragmentfragment =newConversationListFragment();
Uri uri = Uri.parse("rong://"+ getActivity().getApplicationInfo().packageName).buildUpon()
.appendPath("conversationlist")
.appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(),"false")//设置私聊会话非聚合显示
.appendQueryParameter(Conversation.ConversationType.GROUP.getName(),"true")//设置群组会话聚合显示
.appendQueryParameter(Conversation.ConversationType.DISCUSSION.getName(),"false")//设置讨论组会话非聚合显示
.appendQueryParameter(Conversation.ConversationType.SYSTEM.getName(),"false")//设置系统会话非聚合显示
.build();
fragment.setUri(uri);
FragmentTransaction transaction = getActivity().getSupportFragmentManager().beginTransaction();
transaction.add(R.id.rong_content,fragment);
transaction.commit();
这样会话列表和会话界面就基本实现了,但是问题又来了。。。。
用户想用自己的头像和昵称而不是融云自带的固定的。还有就是很多聊天软件点击对方头像时可以跳到对方资料界面
1.点击:
RongIM.setConversationBehaviorListener(newRongIM.ConversationBehaviorListener() {
@Override//头像
public booleanonUserPortraitClick(Context context,Conversation.ConversationType conversationType,UserInfo userInfo) {
return true;
}
@Override
public booleanonUserPortraitLongClick(Context context,Conversation.ConversationType conversationType,UserInfo userInfo) {
return false;
}
@Override//消息
public booleanonMessageClick(Context context,View view,Message message) {
return false;
}
@Override
public booleanonMessageLinkClick(Context context,String s) {
return false;
}
@Override
public booleanonMessageLongClick(Context context,View view,Message message) {
return false;
}
});
2.设置用户信息:
RongIM.setUserInfoProvider(newRongIM.UserInfoProvider() {
@Override
publicUserInfogetUserInfo(finalString userId) {
UserInfo userInfo=newUserInfo(userId,用户名,Uri.parse(头像的url地址));
return userInfo;
}
}, true);
当然这里可能又会出现问题,融云只返回了用户userid,如果想要设置用户信息,可能还要根据userid联网查询信息,但是联网需要耗时,导致上面return userinfo的时候回为空,解决办法就是:
先不管此代码,在联网获取到用户数据后写如下代码即可:
RongIM.getInstance().refreshUserInfoCache(newUserInfo(userid,UserName,Uri.parse(messageUserImage)));
到此结束,谢谢阅读