V2TIMManager(Conversation)

构造函数
(void)	- setConversationListener:
(void)	- getConversationList:count:succ:fail:
(void)	- getConversation:succ:fail:
(void)	- getConversationList:succ:fail:
(void)	- deleteConversation:succ:fail:
(void)	- setConversationDraft:draftText:succ:fail:
(void)	- pinConversation:isPinned:succ:fail:
(void)	- getTotalUnreadMessageCount:fail:

成员类型定义说明

V2TIMConversationResultSucc

- (typedef void(^ V2TIMConversationResultSucc) (NSArray< V2TIMConversation * > *list, uint64_t nextSeq, BOOL isFinished))

protected

获取会话列表成功的回调，nextSeq：下一次分页拉取的游标 isFinished：会话列表是否已经拉取完毕

V2TIMConversationSucc

- (typedef void(^ V2TIMConversationSucc) (V2TIMConversation *conv))

protected

获取单个会话成功回调

V2TIMConversationListSucc

- (typedef void(^ V2TIMConversationListSucc) (NSArray< V2TIMConversation * > *list))

protected

搜索会话列表成功回调

V2TIMTotalUnreadMessageCountSucc

- (typedef void(^ V2TIMTotalUnreadMessageCountSucc) (UInt64 totalCount))

protected

获取会话总未读数回调

成员枚举类型说明

V2TIMConversationType

- (enum V2TIMConversationType) :

protected

会话类型

枚举值
V2TIM_C2C	单聊
V2TIM_GROUP	群聊

V2TIMGroupAtType

- (enum V2TIMGroupAtType) :

protected

@ 类型

枚举值
V2TIM_AT_ME	@ 我
V2TIM_AT_ALL	@ 群里所有人
V2TIM_AT_ALL_AT_ME	@ 群里所有人并且单独 @ 我

函数文档

setConversationListener:()

- (void) setConversationListener:

(id< V2TIMConversationListener >)

listener

1.1 设置会话监听器

getConversationList:count:succ:fail:()

- (void) getConversationList:		(uint64_t)	nextSeq
count:		(int)	count
succ:		(V2TIMConversationResultSucc)	succ
fail:		(V2TIMFail)	fail

1.2 获取会话列表

• 一个会话对应一个聊天窗口，比如跟一个好友的 1v1 聊天，或者一个聊天群，都是一个会话。
• 由于历史的会话数量可能很多，所以该接口希望您采用分页查询的方式进行调用，每次分页拉取的个数建议为 100 个。
• 该接口拉取的是本地缓存的会话，如果服务器会话有更新，SDK 内部会自动同步，然后在 V2TIMConversationListener 回调告知客户。
• 如果会话全部拉取完毕，成功回调里面 V2TIMConversationResult 中的 isFinished 获取字段值为 YES。

注意

会话排序规则

• 5.5.892 及以后版本, 该接口获取的会话列表默认已经按照会话 orderKey 做了排序，orderKey 值越大，代表该会话排序越靠前。
• 5.5.892 以前版本，该接口获取的会话列表默认已经按照会话 lastMessage -> timestamp 做了排序，timestamp 越大，会话越靠前。

参数

nextSeq	分页拉取的游标，第一次默认取传 0，后续分页拉传上一次分页拉取成功回调里的 nextSeq
count	分页拉取的个数，一次分页拉取不宜太多，会影响拉取的速度，建议每次拉取 100 个会话

getConversation:succ:fail:()

- (void) getConversation:		(NSString *)	conversationID
succ:		(V2TIMConversationSucc)	succ
fail:		(V2TIMFail)	fail

1.3 获取单个会话

参数

conversationID

会话唯一 ID, C2C 单聊组成方式：[NSString stringWithFormat:"c2c_%",userID]；群聊组成方式为 [NSString stringWithFormat:"group_%",groupID]

getConversationList:succ:fail:()

- (void) getConversationList:		(NSArray< NSString * > *)	conversationIDList
succ:		(V2TIMConversationListSucc)	succ
fail:		(V2TIMFail)	fail

1.4 获取指定会话列表

参数

conversationIDList

会话唯一 ID 列表，C2C 单聊组成方式：[NSString stringWithFormat:"c2c_%",userID]；群聊组成方式为 [NSString stringWithFormat:"group_%",groupID]

deleteConversation:succ:fail:()

- (void) deleteConversation:		(NSString *)	conversationID
succ:		(V2TIMSucc)	succ
fail:		(V2TIMFail)	fail

1.5 删除会话以及该会话中的历史消息

参数

conversationID

会话唯一 ID，C2C 单聊组成方式：[NSString stringWithFormat:"c2c_%",userID]；群聊组成方式为 [NSString stringWithFormat:"group_%",groupID]

注意

请注意:

• 该会话以及会话中的历史消息，会被 SDK 从本地和服务端一同删除掉，并且不可恢复。

setConversationDraft:draftText:succ:fail:()

- (void) setConversationDraft:		(NSString *)	conversationID
draftText:		(NSString *)	draftText
succ:		(V2TIMSucc)	succ
fail:		(V2TIMFail)	fail

1.6 设置会话草稿

参数

conversationID

会话唯一 ID，C2C 单聊组成方式：[NSString stringWithFormat:"c2c_%",userID]；群聊组成方式为 [NSString stringWithFormat:"group_%",groupID]

只在本地保存，不会存储 Server，不能多端同步，程序卸载重装会失效。

pinConversation:isPinned:succ:fail:()

- (void) pinConversation:		(NSString *)	conversationID
isPinned:		(BOOL)	isPinned
succ:		(V2TIMSucc)	succ
fail:		(V2TIMFail)	fail

1.7 设置会话置顶（5.3.425 及以上版本支持）

参数

conversationID	会话唯一 ID，C2C 单聊组成方式：[NSString stringWithFormat:"c2c_%",userID]；群聊组成方式为 [NSString stringWithFormat:"group_%",groupID]
isPinned	是否置顶

getTotalUnreadMessageCount:fail:()

- (void) getTotalUnreadMessageCount:		(V2TIMTotalUnreadMessageCountSucc)	succ
fail:		(V2TIMFail)	fail

1.8 获取所有会话的未读消息总数（5.3.425 及以上版本支持）

注意

• 未读总数会减去设置为免打扰的会话的未读数，即消息接收选项设置为 V2TIMMessage.V2TIM_NOT_RECEIVE_MESSAGE 的会话。