android2.3.x,SDK 2.x 至 3.x 升级指南

3.0 中的核心类为 EMClient 类，通过 emclient 类可以获取到 chatmanager、groupmanager、contactmanager、chatroommanager 等 manager 对象，此外和这些 manager 不太相关的方法基本 EMClient 类里面，如登录、设置连接监听等方法。message 里的成员变量的获取都变成 getXXX 获取。

从 2.x 升级到 3.0，大部分的变动只需要改变 API 名称就可以了，但是少部分地方因为架构等原因需要一些稍复杂的改动。

这里先列出API大概的变动列表：

SDK2.x

SDK3.0

登录初始化相关

EMChat

EMClient，emchat里之前的方法基本都在此类里

EMChatManager、EMGroupManger等manager类

都通过EMClient类获取，如：EMClient.getInstance().chatManager()

EMChat.getInstance().init(context);

EMClient.getInstance().init(appContext, options);

options需要初始化的适合一并传入

EMChatOptions，通过chatmanager获取到任何直接设置其值

EMOptions，通过new创建得到，设置其成员的值后，调用init方法时传入此options

options.setUseRoster()

无，登录的时候SDK默认不会获取好友

Chatmanager里的setGCMProjectNumber方法移到EMClient里

EMClient.getInstance().setGCMProjectNumber(projectNumber);同理，设置第三方推送配置的方法也在此类里

EMChat.getInstance().setAutoLogin(false)

初始化通过option.setAutoLogin(false)设置

EMChat.getInstance().isLoggedIn()

EMClient.getInstance().isLoggedInBefore()

EMChatManager.getInstance().logout()

EMClient.getInstance().logout()

EMChatmanager.getInstance().createAccountOnServer()

EMClient.getInstance().createAccount()

连接状态相关

EMChatManager.getInstance().

addConnectionListener(connectionListener)

EMClient.getInstance().addConnectionListener(connectionListener);同理unregister方法调用removeConnectionListener

EMChatManager.getInstance().isConnected()

EMClient.getInstance().isConnected()

消息相关

EMMessage

之前的public的成员变量都只能通过getXxx()的方式获取

MessageBody: TextMessageBody、VideoMessageBody等

都需要在前面加上EM，如:TextMessageBody->EMTextMessageBody

EMEventListener

EMMessageListener，需要注意的是，3.0 的消息没有离线消息的回调，不区分离线消息和在线消息

EMChatManager.getInstance().registerEventListener

EMClient.getInstance().chatManager().addMessageListener，移除监听调用removeMessageListener

conversation.getMsgCount()

无,使用conversation.getAllMessages().size取到count

conversation.loadMoreGroupMsgFromDB()

无，都使用conversation.loadMoreMsgFromDB()

EMChatmanager.getInstance().sendMessage(msg, callback)

无callback，通过message.setMessageStatusCallback(EMCallBack callback)获取消息发送状态

conversation.addMessage(message)

无此方法，发送消息之前无需调用此方法

conversation.getMessage(Pos);

无，重发消息的时候需要传message对象作为intent的参数

EMChatmanager.getInstance().asyncFetchMessage()

语音消息调用EMClient.getInstance().chatManager().downloadAttachment()；图片、视频消息等自动下载缩略图的消息调用downloadThumbnail()方法

EMChatManager.getInstance().clearConversation

无，使用EMClient.getInstance().deleteConversation方法即可

EMChatManager.getInstance().deleteAllConversation();

无，for循环调用删除会话方法即可

群组聊天室相关

EMGroup不再继承自EMContact

-

创建群组

EMClient.getInstance().groupManager().createGroup(groupName, desc, allMembers, reason, option);

具体参数的意思请参考群组管理文档

EMGroupManager.getInstance().

createOrUpdateLocalGroup(group);

无，调用getGroupFromServer方法时，会自动更新本地有记录的群组

EMGroupManager.getInstance().getGroupsFromServer()

EMClient.getInstance().groupManager().getJoinedGroupsFromServer()

EMGroupManager.getInstance().exitFromGroup()

EMClient.getInstance().groupManager().leaveGroup()

EMGroupManager.getInstance().exitAndDeleteGroup()

EMClient.getInstance().groupManager().destroyGroup()

Chatroom相关的api

都移到EMChatRoomManager类，chatroommanager的实例获取方法为EMClient.getInstance().chatroomManager()

用户相关

EMContact::setUsername()

无，需要在new出emcontact对象时传入username

getCurrentUser()移到EMClient类里

EMClient.getInstance().getCurrentUser()

EMChatmanager.getInstance().updateCurrentUserNick()

EMClient.getInstance().updateCurrentUserNick()

EMContactManager.getInstance().getContactUserNames()

EMClient.getInstance().contactManager().getAllContactsFromServer()

EMContactManager.getInstance().

getBlackListUsernamesFromServer()

EMClient.getInstance().contactManager().getBlackListFromServer()

EMContactManager.getInstance().deleteUserFromBlackList()

EMClient.getInstance().contactManager().removeUserFromBlackList()

消息接发对于以前通过 conversation.addConversation() 方法，然后在 adapter 中发送消息的开发者来说变动稍微有点大，这里再单独列出来修改方法：

首先把 conversation.addMessage(message) 删除掉，然后调用 sendmessage 方法，在 messageadapter 显示消息的地方，不再调用 sendmessage 方法，adapter 里只是根据消息的状态显示相应的 UI 即可，通过调用 message.setMessageStatusCallback(messageReceiveCallback)，监听消息是否发送成功等，这里以发送文字消息作为示例：

protected void sendMessage(EMMessage message){

if(chatFragmentListener != null){

//设置扩展属性

chatFragmentListener.onSetMessageAttributes(message);

}

// 如果是群聊，设置chattype,默认是单聊

if (chatType == EaseConstant.CHATTYPE_GROUP){

message.setChatType(ChatType.GroupChat);

}else if(chatType == EaseConstant.CHATTYPE_CHATROOM){

message.setChatType(ChatType.ChatRoom);

}

//发送消息

EMClient.getInstance().chatManager().sendMessage(message);

//刷新ui

messageList.refreshSelectLast();

}

在显示消息的 adpater 中，根据消息状态显示相应 UI 即可。

protected void handleTextMessage() {

if (message.direct() == EMMessage.Direct.SEND) {

setMessageSendCallback();

switch (message.status()) {

case CREATE:

progressBar.setVisibility(View.GONE);

statusView.setVisibility(View.VISIBLE);

break;

case SUCCESS: // 发送成功

progressBar.setVisibility(View.GONE);

statusView.setVisibility(View.GONE);

break;

case FAIL: // 发送失败

progressBar.setVisibility(View.GONE);

statusView.setVisibility(View.VISIBLE);

break;

case INPROGRESS: // 发送中

progressBar.setVisibility(View.VISIBLE);

statusView.setVisibility(View.GONE);

break;

default:

break;

}

}else{

if(!message.isAcked() && message.getChatType() == ChatType.Chat){

try {

EMClient.getInstance().chatManager().ackMessageRead(message.getFrom(), message.getMsgId());

} catch (HyphenateException e) {

e.printStackTrace();

}

}

}

}