====== SDK 2.x 至 3.x 升级指南 ====== ----- ===== API 大致变动介绍 ===== 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(); } } } } ===== 3.x 后续API改动 ===== * [[im:200androidclientintegration:3.1.5apichange|3.1.5api修改]] * [[im:200androidclientintegration:3.2.3apichange|3.2.3api修改]] * [[im:200androidclientintegration:3.3.0apichange|3.3.0api修改]] ---- 上一页:[[im:200androidclientintegration:120androidsdkjavadoc|Android SDK API Doc]] 下一页:[[im:200androidclientintegration:160androidreleasenote|Android SDK 更新日志]]