前言:
環信應該是國內最早規模最大的即時通訊平臺,往往是各大公司快速開發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的框架,希望能幫到大家,喜歡別忘了給個星星~