android即时通讯，基于环信3.3.4版本，基础功能开发详解

作者: 明天你好_9d3c | 来源:发表于2017-10-18 18:13 被阅读0次

近期，由于公司新开项目，涉及即时通讯，几经对比，选择了环信平台。话不多说，进入正题。

大纲：

1.环信SDK集成，http://docs.easemob.com/im/200androidclientintegration/10androidsdkimport，打开链接，完成最基础的sdk集成，并且初始化SDK，这一步我就略过了。

2.聊天准备，注册，登录，退出登录，设置环信服务连接监听，设置消息接收监听

3.添加好友

4.好友消息列表处理（根据最后聊天发送时间排序）

5.聊天界面消息发送，接收处理

以下是项目中使用环信sdk完成的功能清单：

聊天界面（1对1好友聊天）：

发送消息类别：文字，语音，图片，位置。

好友列表：聊天好友会话列表。

好友消息列表效果图

2.聊天准备，注册，登录，退出登录，设置环信服务连接监听，设置消息接收监听

2.1-注册

注册环信聊天账号，密码，用于app客户端基于环信服务器聊天。这一块，本项目是由后台接口注册，登录后返回，也就是说环信聊天账号的注册交由后台创建，客户端只需在登录成功后返回接收即可。当然可以根据自身需求，也可自己创建。

环信sdk文档是这样描述的：

注册模式分两种，开放注册和授权注册。只有开放注册时，才可以客户端注册。

开放注册是为了测试使用，正式环境中不推荐使用该方式注册环信账号；

授权注册的流程应该是您服务器通过环信提供的 RESTAPI注册，之后保存到您的服务器或返回给客户端。

注册用户名会自动转为小写字母，所以建议用户名均以小写注册。（强烈建议开发者通过后台调用 REST 接口去注册环信 ID，客户端注册方法不提倡使用。）

//注册失败会抛出HyphenateException

EMClient.getInstance().createAccount(username, pwd);//同步方法（不推荐客户端注册）

2.2-登录

app登录成功之后，获取后台创建好的username，password。值得注意的是，回调的三个方法都是位于子线程，不能够在方法体内做ui操作。

调用环信api，EMClient.getInstance().login(userName,password,new EMCallBack());进行环信账号登录。

调用环信登录

EMClient.getInstance().groupManager().loadAllGroups();

EMClient.getInstance().chatManager().loadAllConversations();

以上两个方法是为了保证进入主页面后本地会话和群组都 load 完毕，根据自身业务调用，除登录api成功回调使用，建议每次启动app都在启动页调用一次。

退出登录，直接调用 EMClient.getInstance().logout(true)即可;

环信登录成功后，默认为自动登录，可按需求取消自动登录options.setAutoLogin(false)。

EMClient.getInstance().isLoggedInBefore()，判断环信账号登录状态

2.3-（成功登录环信后）设置环信服务连接监听

注册连接监听，可用作监听设备登录唯一，发生多点登录，作出提示。只需在注册一次即可，建议在应用首页注册，这样首页不销毁就可以做到全局监听的效果，进入app注册监听。

退出app时，调用EMClient.getInstance().removeConnectionListener(MyConnectionListener);销毁监听。MyConnectionListener类实现了EMConnectionListener接口

2.3-（成功登录环信后）设置环信消息接收监听

EMClient.getInstance().chatManager().addMessageListener(msgListener);只需在注册一次即可，建议在应用首页注册，这样首页不销毁就可以做到全局监听的效果，进入app注册监听，退出app调用EMClient.getInstance().chatManager().removeMessageListener(msgListener);

值得注意的是，EMMessageListener的众多回调方法中， onMessageReceived(List messages)是最重要的方法，所有消息接收都在此方法中，但是看方法的参数，竟然是list集合，这里面我们只需要获取list里面的第一个数据即可，List<EMMessage> message = messages.get(0);，这条是最新的消息。EMMessageListener的回调方法依然是在子线程中，所以需要配合handler进行ui操作。

消息接收处理

handler 消息接收

首先是注册监听，我是在MainActivity首页设置的，UserBiz.isLogin() && EMClient.getInstance().isLoggedInBefore()双重判断用户是否已登录，环信账号登录。EMReceiveBiz是我自己写一个处理消息接收的业务类，全局只在MainActivity注册一次监听，避免收到多次消息。

关于MyConnectionListener，上面已经有介绍。与消息监听同理。

设置消息监听，连接监听

然后是销毁监听，当退出app时，把注册的2个监听销毁

EMClient.getInstance().removeConnectionListener(eMConnectionListener);

EMClient.getInstance().chatManager().removeMessageListener(emReceiveBiz.msgListener);

EMReceiveBiz里面用到了handler，所以为了防止内存泄露，把handler监听销毁。

销毁监听

3.添加好友

EMClient.getInstance().contactManager().setContactListener(newEMContactListener()); 注册好友监听

//参数为要添加的好友的username和添加理由

EMClient.getInstance().contactManager().addContact(toAddUsername, reason);

一般添加好友除了环信平台添加好友，本地接口也需要添加到好友列表，所以reason根据需求设置参数，比如本地接口添加好友需要用户userId，那么可以将reason设置为自己的userId，发送成功后，对方将在onContactInvited方法中获取到你的环信账号，与你的userId，这样再处理接收好友请求，调用本地接口添加好友。

添加好友监听

4.好友消息列表处理（根据最后聊天发送时间排序）

我们看到QQ，微信也好，消息列表的排序，都是按发送时间为基准，发送时间距离当前时间越近排序越靠前。

这里面环信并没有直接提供这样的api。所以需要我们自己基于环信api做排序处理。

我把自己处理的代码发出来，List<UserFriend> dataList 是项目中调取本地好友接口获取的好友列表。

EMClientMsgBiz clientBiz1 =newEMClientMsgBiz();

clientBiz1.setImAccount(o1.getFriendImAccount());

List lastMsgInfo1 = clientBiz1.getMessage(1);

o1.getFriendImAccount()是该好友的环信账号，然后调取环信api，getMessage(pagerNum)，pagerNum代表获取多少条数据，这里我们只需要获取最新的消息记录，所以设置为1即可获得与该好友的最后一条聊天EMMessage，如果没有一个消息记录，则conversation==null，所以new 一个集合返回，否则有空指针异常。

获取好友聊天记录api

EMMessage 环信聊天消息实体类，我们调用EMMessage.getMsgTime(，获取消息发送时间，然后把整个列表的会话排序即可。下面的方法便是比对消息发送时间的进行排序。Collections.sort（List list,Comparator c）;是java.util中Collections类中的方法，不了解的可以去查看一下。这样好友消息会话列表的排序就处理好了

消息会话列表时间排序方法

接下来处理会话列表的显示问题。我这里的处理方式是在adapter里面处理的。

处理方式大同小异，通过UserFriend里面的friendImAccount，调取环信api，获取未读消息数量getUnreadMsgCount，获取最后消息发送时间getMsgTime（消息类型为long，时间戳为毫秒数，如何显示按需求处理），获取最后消息发送内容 EaseCommonUtils.getMessageDigest(lastMsgInfo1.get(0))。