V2TIMConversationListener

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

有新的会话（比如收到一个新同事发来的单聊消息、或者被拉入了一个新的群组中），可以根据会话的 orderKey 重新对会话列表做排序

参数

conversationList

会话列表

onConversationChanged()

void onConversationChanged ( List< V2TIMConversation >  conversationList )

inline

某些会话的关键信息发生变化（未读计数发生变化、最后一条消息被更新等等），可以根据会话的 orderKey 重新对会话列表做排序

参数

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 或 V2TIMMessage.V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE_EXCEPT_AT 的会话。

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 或 V2TIMMessage.V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE_EXCEPT_AT 的会话。

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

会话分组删除会话