IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、账号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMConversationListenerabstract

Public 成员函数

void onSyncServerStart ()
 
void onSyncServerFinish ()
 
void onSyncServerFailed ()
 
void onNewConversation (List< V2TIMConversation > conversationList)
 
void onConversationChanged (List< V2TIMConversation > conversationList)
 
void onConversationDeleted (List< String > conversationIDList)
 
void onTotalUnreadMessageCountChanged (long totalUnreadCount)
 
void onUnreadMessageCountChangedByFilter (V2TIMConversationListFilter filter, long totalUnreadCount)
 
void onConversationGroupCreated (String groupName, List< V2TIMConversation > conversationList)
 
void onConversationGroupDeleted (String groupName)
 
void onConversationGroupNameChanged (String oldName, String newName)
 
void onConversationsAddedToGroup (String groupName, List< V2TIMConversation > conversationList)
 
void onConversationsDeletedFromGroup (String groupName, List< V2TIMConversation > conversationList)
 

成员函数说明

◆ onSyncServerStart()

void onSyncServerStart ( )
inline

同步服务器会话开始,SDK 会在登录成功或者断网重连后自动同步服务器会话,您可以监听这个事件做一些 UI 进度展示操作。

◆ onSyncServerFinish()

void onSyncServerFinish ( )
inline

同步服务器会话完成,如果会话有变更,会通过 onNewConversation | onConversationChanged 回调告知客户

◆ onSyncServerFailed()

void onSyncServerFailed ( )
inline

同步服务器会话失败

◆ onNewConversation()

void onNewConversation ( List< V2TIMConversation conversationList)
inline

有新的会话(比如收到一个新同事发来的单聊消息、或者被拉入了一个新的群组中),可以根据会话的 lastMessage -> timestamp 重新对会话列表做排序

参数
conversationList会话列表

◆ onConversationChanged()

void onConversationChanged ( List< V2TIMConversation conversationList)
inline

某些会话的关键信息发生变化(未读计数发生变化、最后一条消息被更新等等),可以根据会话的 lastMessage -> timestamp 重新对会话列表做排序

参数
conversationList会话列表

◆ onConversationDeleted()

void onConversationDeleted ( List< String >  conversationIDList)
inline

会话被删除的通知(7.2 及以上版本支持)

注意
conversationIDList 表示被删除会话唯一 ID 列表。C2C 单聊组成方式为: String.format("c2c_%s", "userID");群聊组成方式为: String.format("group_%s", "groupID")

◆ onTotalUnreadMessageCountChanged()

void onTotalUnreadMessageCountChanged ( long  totalUnreadCount)
inline

全部会话未读总数变更的通知(5.3.425 及以上版本支持)

注意
  • 当您调用 getTotalUnreadMessageCount 获取全部会话未读总数以后,任意会话的未读数发生变化时,SDK 都会通过该回调把最新的未读总数通知给您。
  • 未读总数会减去设置为免打扰的会话的未读数,即消息接收选项设置为 V2TIMMessage.V2TIM_NOT_RECEIVE_MESSAGE 或 V2TIMMessage.V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE 的会话。

◆ onUnreadMessageCountChangedByFilter()

void onUnreadMessageCountChangedByFilter ( V2TIMConversationListFilter  filter,
long  totalUnreadCount 
)
inline

根据 filter 过滤的未读消息总数变更通知(7.0 及以上版本支持)

注意
  • 您可以调用 subscribeUnreadMessageCountByFilter 注册监听指定 filter 下的未读总数变化,SDK 通过这个回调把最新的未读总数通知给您。
  • 您可以注册监听多个不同 filter 下的未读总数变化,这个回调的 filter 参数就是注册监听时指定的 filter,该 filter 携带了 conversationType、conversationGroup 和 markType 三个字段,通过判断这三字段是不是都相同,来区分出不同的 filter。
  • 未读总数会减去设置为免打扰的会话的未读数,即消息接收选项设置为 V2TIMMessage.V2TIM_NOT_RECEIVE_MESSAGE 或 V2TIMMessage.V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE 的会话。

◆ onConversationGroupCreated()

void onConversationGroupCreated ( String  groupName,
List< V2TIMConversation conversationList 
)
inline

会话分组被创建

◆ onConversationGroupDeleted()

void onConversationGroupDeleted ( String  groupName)
inline

会话分组被删除

◆ onConversationGroupNameChanged()

void onConversationGroupNameChanged ( String  oldName,
String  newName 
)
inline

会话分组名变更

◆ onConversationsAddedToGroup()

void onConversationsAddedToGroup ( String  groupName,
List< V2TIMConversation conversationList 
)
inline

会话分组新增会话

◆ onConversationsDeletedFromGroup()

void onConversationsDeletedFromGroup ( String  groupName,
List< V2TIMConversation conversationList 
)
inline

会话分组删除会话