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

构造函数

(void) - setConversationListener:
 
(void) - getConversationList:count:succ:fail:
 
(void) - getConversation:succ:fail:
 
(void) - deleteConversation:succ:fail:
 
(void) - setConversationDraft:draftText:succ:fail:
 

成员类型定义说明

◆ V2TIMConversationResultSucc

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

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

◆ V2TIMConversationSucc

- (typedef void(^ V2TIMConversationSucc) (V2TIMConversation *conv))
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 告知客户。
  • 该接口获取的会话默认已经按照会话 lastMessage -> timestamp 做了排序,timestamp 越大,会话越靠前。
  • 如果会话全部拉取完毕,成功回调里面的 isFinished 字段值为 YES。
  • 最多能拉取到最近的5000个会话。
参数
nextSeq分页拉取游标,第一次默认取传 0,后续分页拉传上一次分页拉取回调里的 nextSeq
count分页拉取的个数,一次分页拉取不宜太多,会影响拉取的速度,建议每次拉取 100 个会话

◆ getConversation:succ:fail:()

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

1.3 获取单个会话

参数
conversationID会话唯一 ID,如果是 C2C 单聊,组成方式为 c2c_userID,如果是群聊,组成方式为 group_groupID

◆ deleteConversation:succ:fail:()

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

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

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

◆ setConversationDraft:draftText:succ:fail:()

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

1.5 设置会话草稿

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