网易云信 NIM SDK 的QChatMessageService类提供getLastMessageOfChannels方法，用于获取多个频道的最后一条消息，该方法的响应QChatGetLastMessageOfChannelsResult返回的结果为 map, key 值对应每一个channelId，value 值是消息体QChatMessage。基于该方法的调用，您可通过在应用上层自行开发相关业务逻辑，实现频道列表动态更新各频道的最后一条消息。

UI 示例

频道列表显示最后一条消息的简易 UI 示例如下：

前提条件

已登录圈组，并已创建圈组服务器和频道。

实现流程

API 调用时序

频道最后一条消息动态更新的业务场景，可分为如下两种。

以下时序图可能因为网络问题而显示异常。如果显示异常，一般刷新当前页面即可正常显示。

流程说明

本节仅对上图中标为橙色的流程进行说明，其他流程请参考相关文档。例如：

• 服务器成员相关说明，可参见圈组服务器成员管理。
• 用户是否能访问某频道的相关说明，可参见频道黑白名单。

1. 登录圈组前，注册如下观察者：

   • 调用observeReceiveMessage方法注册消息接收观察者，监听消息接收事件。
   • 调用observeMessageRevoke方法注册消息撤回状态变化观察者，监听消息撤回事件。
   • 调用observeMessageUpdate方法注册消息更新观察者，监听消息更新事件。
   • 调用observeMessageDelete方法注册消息删除观察者，监听消息删除事件。

   示例代码如下：

   监听消息接收

   NIMClient.getService(QChatServiceObserver.class).observeReceiveMessage(new Observer<List<QChatMessage>>() {
       @Override
       public void onEvent(List<QChatMessage> qChatMessages) {
           //收到消息qChatMessages
           for (QChatMessage qChatMessage : qChatMessages) {
               //处理消息
           }
       }
   }, true);
   

   监听消息撤回

   NIMClient.getService(QChatServiceObserver.class).observeMessageRevoke(new Observer<QChatMessageRevokeEvent>() {
       @Override
       public void onEvent(QChatMessageRevokeEvent event) {
           //收到撤回后的消息qChatMessage
           QChatMessage message = event.getMessage();
   
       }
   }, true);
   
   

   监听消息更新

   NIMClient.getService(QChatServiceObserver.class).observeMessageUpdate(new Observer<QChatMessageUpdateEvent>() {
       @Override
       public void onEvent(QChatMessageUpdateEvent event) {
           //收到更新后的消息qChatMessage
           QChatMessage message = event.getMessage();
   
       }
   }, true);
   
   

   监听消息删除

   NIMClient.getService(QChatServiceObserver.class).observeMessageDelete(new Observer<QChatMessageDeleteEvent>() {
       @Override
       public void onEvent(QChatMessageDeleteEvent event) {
           //收到删除后的消息qChatMessage
           QChatMessage message = event.getMessage();
   
       }
   }, true);
   

2. 获取频道最后一条消息的初始数据。

   1. 调用getChannelsByPage拉取频道列表。

   2. 调用getLastMessageOfChannels方法获取若干个频道的最后一条消息。

      • 最多只能传入 20 个频道 ID 获取它们的最后一条消息。
      • 您需自行维护调用该方法返回的结果。
      • 被撤回的消息仍能通过调用该方法查到，但被删除的消息无法查到。如果最后一条消息是撤回消息，推荐把对应的最后一条消息置空，并给出提示表明“撤回消息”。

   3. 在您的应用内存中维护相关频道的最后一条消息。

   示例代码如下：

   long serverId = 943445L;
   long searchTime = System.currentTimeMillis();
   int limit = 100;
   NIMClient.getService(QChatChannelService.class)
           .getChannelsByPage(new QChatGetChannelsByPageParam(serverId,searchTime,limit))
           .setCallback(
                   new RequestCallback<QChatGetChannelsByPageResult>() {
                       @Override
                       public void onSuccess(QChatGetChannelsByPageResult result) {
                           //查询Channel列表成功
                           List<QChatChannel> channels = result.getChannels();
                           if(channels != null && channels.size() > 0){
                               List<Long> channelIds = new ArrayList<>();
                               for (QChatChannel channel : channels) {
                                   channelIds.add(channel.getChannelId());
                               }
                               //获取频道最后一条消息
                               NIMClient.getService(QChatMessageService.class)
                                       .getLastMessageOfChannels(new QChatGetLastMessageOfChannelsParam(serverId,channelIds))
                                       .setCallback(new RequestCallback<QChatGetLastMessageOfChannelsResult>() {
                                           @Override
                                           public void onSuccess(QChatGetLastMessageOfChannelsResult result) {
                                               //查询成功,返回频道最后一条消息map，key为channelId
                                               Map<Long, QChatMessage> channelMsgMap = result.getChannelMsgMap();
                                           }
   
                                           @Override
                                           public void onFailed(int code) {
                                               //查询失败，返回错误code
                                           }
   
                                           @Override
                                           public void onException(Throwable exception) {
                                               //查询异常
                                           }
                                       });
                           }
   
   
                       }
   
                       @Override
                       public void onFailed(int code) {
                           //查询Channel列表失败，返回错误code
                       }
   
                       @Override
                       public void onException(Throwable exception) {
                           //查询Channel列表异常
                       }
                   });
   

3. 参照下表，在应用层自行开发，实现后续频道最后一条消息在不同场景下的动态更新。

   场景	场景说明	推荐处理方法
   事件回调触发更新	频道内，其他用户发送消息或重发消息，触发消息接收回调	更新频道最后一条消息
   	频道内，其他用户撤回、更新或删除消息，触发消息更新回调	判断撤回、更新、删除的消息是否为频道最后一条消息，若非最后一条消息，则忽略；若为最后一条消息，且： 为撤回或删除消息，则把最后一条消息置空 为更新消息，则更新频道最后一条消息
   自己发送或变更消息触发更新	自己在频道内发送、重发或更新消息	更新频道内最后一条消息
   	自己在频道内撤回或删除消息	判断撤回或删除的消息是否为频道最后一条消息，若非最后一条消息，则忽略；若为最后一条消息，则把最后一条消息置空

相关信息

圈组各端 （Android、iOS、Windows 和 增强版 Web）监听消息更新、消息撤回和消息删除的方式略有差异，具体为：Android 将消息更新、消息撤回和消息删除三个事件进行区分；而其他端的消息撤回和消息删除事件，都并入消息更新事件，不进行区分。

各端的相关事件回调接口如下：

	Android	iOS	Windows	增强版 Web
监听消息更新	observeMessageUpdate	onMessageUpdate:	RegUpdatedCb	messageUpdate
监听消息撤回	observeMessageRevoke
监听消息删除	observeMessageDelete