未读会话

本文主要介绍 云上曲率即时通讯IM SDK的未读会话功能。

功能描述

未读会话是指用户离线状态时,接收到的会话。此时服务端会对这些会话进行”未读“标记。当用户重新上线后,通过相关接口可以获取到这些未读会话。

云上曲率IM SDK为开发者提供如下内容:

  • 从服务端获取全部未读会话列表
  • 从服务端获取全部P2P未读会话列表
  • 从服务端获取全部群组未读会话列表
  • 删除未读会话

注意:一般在登录之后,只需要调用未读会话相关接口即可,无需调用获取全部会话。 请注意与用户功能操作中的”未读会话“进行区分。云上曲率IM SDK提供的未读会话功能是表示用户离线时未拉取到的会话新内容,当用户在线后,客户端重新拉取,如果更换终端拉取获取离线后上线再拉取,不会再有重复的未读会话产生。

接口说明

获取全部未读会话列表

通过getAllUnreadConversation接口实现从服务端获取已有会话中有未读消息的会话,并形成会话列表返回给客户端。

如果在用户离线期间,产生了新的会话,也通过未读会话列表返回给客户端。

注意:开发者可以通过此接口获取全部未读会话,也可以根据业务需求单独获取P2P或群组的未读会话。

–> 接口参数说明:

参数 含义 说明
time 时间戳 毫秒级时间戳。大于改时间戳的消息计为未读消息,最后一条未读消息设为会话的最后一套消息。如果传0,默认使用上次离线时间。
clear 清除未读 是否需要将会话的未读状态变为已读
代码说明
public void getAllUnreadConversation(boolean clear, long time, final ICallback<IMUnreadConversationInfo> callback)
清除全部会话未读状态

通过clearUnread接口就可将未读会话变为已读。 如果不使用``接口中的参数clear将未读会话设置为已读,那么可以使用此接口进行设置。

代码说明
public void clearUnread(IEmptyCallback callback)