环信3.x php类,环信2.x升级3.0变动介绍

SDK 2.x至3.0升级指南

使用升级替换脚本

可以使用SDK中的自动替换脚本替换大部分原有API的变动， 有部分需要手动更新的请见下面的说明。

./replace.sh your_source_folder

注意

该脚本可以允许在linux，mac及cygwin环境下并需要可执行权限

如果在mac下，需要用户用brew或其他方式安装gsed

API大致变动介绍

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

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

消息接发对于以前通过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();

}

}

}

}