前言:
环信应该是国内最早规模最大的即时通讯平台,往往是各大公司快速开发IM通讯的首选SDK。环信提供的EaseUI可谓是再此基础上又大大节省了开发的时间(增多了程序猿们的头发)。
但实际开发中每个公司对产品的要求又各不相同,我们需要简单的修改环信的EaseUI库来满足我们的需求。
下面我们就来介绍一下怎样创建自定义消息!
首先集成环信:
集成环信应该不必长篇大论的再说了,搜索环信,查看文档,还有贴心的视频教您一步步的集成。
这里我们需要集成EaseUI,然后实现他的登陆注册退出登陆等方法后建立聊天的链接。
实现自定义消息的步骤(增加名片消息为例):
第一步:修改菜单
EaseUI库中找到EaseChatFragment.Class文件:
在默认就有的拍照、图片和地理位置常量下面增加card的常量如: static final int ITEM_CARD = 4;
在itemStrings、itemdrawables、itemIds数组中分别增加相应的名称,显示的图片和Id。
然后会走registerExtendMenuItem()来注册,找到各个菜单的监听,是MyItemClickListener的内部类增加刚刚添加的ITME_CARD的case。
class MyItemClickListener implements EaseChatExtendMenu.EaseChatExtendMenuItemClickListener{
@Override
public void onClick(int itemId, View view) {
if(chatFragmentHelper != null){
if(chatFragmentHelper.onExtendMenuItemClick(itemId, view)){
return;
}
}
switch (itemId) {
case ITEM_TAKE_PICTURE:
selectPicFromCamera();
break;
case ITEM_PICTURE:
selectPicFromLocal();
break;
case ITEM_LOCATION:
startActivityForResult(new Intent(getActivity(), EaseBaiduMapActivity.class), REQUEST_CODE_MAP);
break;
//TODO 自定义消息 名片
case ITEM_CARD:
showCard();
break;
default:
break;
}
}
private void showCard() {
//发送扩展消息
EMMessage message = EMMessage.createTxtSendMessage("大眼学长",toChatUsername);
//增加自己的属性
message.setAttribute("cards",true);
message.setAttribute("CARDS","cards");
message.setAttribute("USERNAME","God-Eye");
message.setAttribute("USERID","1");
message.setAttribute("USERHEADER","");
message.setAttribute("USERCITY","青岛");
//设置群聊和聊天室发送消息
if (chatType == EaseConstant.CHATTYPE_GROUP){
message.setChatType(ChatType.GroupChat);
}else if (chatType == EaseConstant.CHATTYPE_CHATROOM){
message.setChatType(ChatType.ChatRoom);
}
//发送扩展消息
EMClient.getInstance().chatManager().sendMessage(message);
messageList.refresh();//刷新消息数据
}
第二步:修改EaseUI的EaseMessageAdapter
声明名片的接收和发送类型的标识
private static final int MESSAGE_TYPE_SEND_CARD = 14;
private static final int MESSAGE_TYPE_RECV_CARD = 15;
增加了2个Type所以找到getViewTypeCount()方法,增加里面的count数量:
public int getViewTypeCount() {
if(customRowProvider != null && customRowProvider.getCustomChatRowTypeCount() > 0){
return customRowProvider.getCustomChatRowTypeCount() + 14 +2;
}
return 14 + 2;
}
接着修改getItemViewType(int position)方法中的:
if(customRowProvider != null && customRowProvider.getCustomChatRowType(message) > 0){
return customRowProvider.getCustomChatRowType(message) + 13 + 2;
}
因为定义的名片类型是EMMessage.Type.TXT,所以在message.getType() == EMMessage.Type.TXT里添加判断:
if (message.getType() == EMMessage.Type.TXT) {
if(message.getBooleanAttribute(EaseConstant.MESSAGE_ATTR_IS_BIG_EXPRESSION, false)){
return message.direct() == EMMessage.Direct.RECEIVE ? MESSAGE_TYPE_RECV_EXPRESSION : MESSAGE_TYPE_SENT_EXPRESSION;
}else if (message.getBooleanAttribute("cards",false)){
return message.direct() == EMMessage.Direct.RECEIVE ? MESSAGE_TYPE_RECV_CARD : MESSAGE_TYPE_SEND_CARD;
}
return message.direct() == EMMessage.Direct.RECEIVE ? MESSAGE_TYPE_RECV_TXT : MESSAGE_TYPE_SENT_TXT;
}
紧接着在它下面的createChatRowPresenter方法中也要加判断
case TXT:
if(message.getBooleanAttribute(EaseConstant.MESSAGE_ATTR_IS_BIG_EXPRESSION, false)){
presenter = new EaseChatBigExpressionPresenter();
}else if (message.getBooleanAttribute("cards",false)){
presenter = new EyeChatCardPresenter();//需要自己创建
}else{
presenter = new EaseChatTextPresenter();
}
break;
EyeChatCardPresenter从何而来?下面看第三步↓
第三步:创建 ChatRow(EyeChatCard) 和 ChatPresenter(EyeChatCardPresenter)
首先需要在easeui/widget/chatrow中创建一个继承EaseChatRow的类(仿照包中其他的类),实现它的构造和4个抽象方法:
- onInflateView()方法
根据接收还是发送来inflater相应的布局,如下:
@Override
protected void onInflateView() {
inflater.inflate(message.direct() == EMMessage.Direct.RECEIVE ? R.layout.eye_row_received_cards : R.layout.eye_row_sent_cards,this);
}
- onFindViewById()方法
顾名思义findViewById - onViewUpdate()方法
数据更新,通知刷新adapter - onSetUpView()方法
设置View的值
然后再在easeui/widget/presenter包下创建一个类继承EaseChatRowPresenter(也是仿照包中其他类写)
只有一个抽象方法必须实现,其他的方法根据需求是否实现,常用的是onBubbleClick()方法,点击后的操作在此实现。
然后一个简单的自定义消息就完成了,更多的功能可以参照环信的文档。最后附上一个简单的demo,希望能帮助到大家。
GitHub:https://github.com/bigeyechou/EyeIMForEase
喜欢的话请点赞,懒癌患者今年刚开始分享心得和Git,有不足请帮忙指出,Github中暂时有用的应该就一套Retrofit+OKhttp+Rxjava的框架,希望能帮到大家,喜欢别忘了给个星星~