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

详细描述

会话对象

属性

V2TIMConversationType type
 
NSString * conversationID
 
NSString * userID
 
NSString * groupID
 
NSString * groupType
 
NSString * showName
 
NSString * faceUrl
 
int unreadCount
 
V2TIMReceiveMessageOpt recvOpt
 
V2TIMMessagelastMessage
 
NSArray< V2TIMGroupAtInfo * > * groupAtInfolist
 
NSString * draftText
 
NSDate * draftTimestamp
 
BOOL isPinned
 
NSUInteger orderKey
 
NSArray< NSNumber * > * markList
 
NSData * customData
 
NSArray< NSString * > * conversationGroupList
 
NSUInteger c2cReadTimestamp
 
NSUInteger groupReadSequence
 

属性说明

◆ type

- (V2TIMConversationType) type
readnonatomicassign

会话类型

◆ conversationID

- (NSString*) conversationID
readnonatomicstrong

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

◆ userID

- (NSString*) userID
readnonatomicstrong

如果会话类型为 C2C 单聊,userID 会存储对方的用户ID,否则为 nil

◆ groupID

- (NSString*) groupID
readnonatomicstrong

如果会话类型为群聊,groupID 会存储当前群的群 ID,否则为 nil

◆ groupType

- (NSString*) groupType
readnonatomicstrong

如果会话类型为群聊,groupType 为当前群类型,否则为 nil

◆ showName

- (NSString*) showName
readnonatomicstrong

会话展示名称(群组:群名称 >> 群 ID;C2C:对方好友备注 >> 对方昵称 >> 对方的 userID)

◆ faceUrl

- (NSString*) faceUrl
readnonatomicstrong

会话展示头像(群组:群头像;C2C:对方头像)

◆ unreadCount

- (int) unreadCount
readnonatomicassign

会话未读消息数量,直播群(AVChatRoom)不支持未读计数,默认为 0

◆ recvOpt

- (V2TIMReceiveMessageOpt) recvOpt
readnonatomicassign

消息接收选项(接收 | 接收但不提醒 | 不接收)

◆ lastMessage

- (V2TIMMessage*) lastMessage
readnonatomicstrong

会话最后一条消息

注意
5.5.892 以前版本,请您使用 lastMessage -> timestamp 对会话做排序,timestamp 越大,会话越靠前

◆ groupAtInfolist

- (NSArray<V2TIMGroupAtInfo *>*) groupAtInfolist
readnonatomicstrong

群会话 @ 信息列表,用于展示 “有人@我” 或 “@所有人” 这两种提醒状态

◆ draftText

- (NSString*) draftText
readnonatomicstrong

草稿信息,设置草稿信息请调用 setConversationDraft() 接口

◆ draftTimestamp

- (NSDate*) draftTimestamp
readnonatomicstrong

上次设置草稿时的 UTC 时间戳

◆ isPinned

- (BOOL) isPinned
readnonatomicassign

是否置顶

◆ orderKey

- (NSUInteger) orderKey
readnonatomicassign

排序字段(5.5.892 及以后版本支持)

注意
  • 排序字段 orderKey 是按照会话的激活时间线性递增的一个数字(注意:不是时间戳,因为同一时刻可能会有多个会话被同时激活)
  • 5.5.892 及其以后版本,推荐您使用该字段对所有会话进行排序,orderKey 值越大,代表该会话排序越靠前
  • 当您 “清空会话所有消息” 或者 “逐个删除会话的所有消息” 之后,会话的 lastMessage 变为空,但会话的 orderKey 不会改变;如果想保持会话的排序位置不变,可以使用该字段对所有会话进行排序

◆ markList

- (NSArray<NSNumber *>*) markList
readnonatomicstrong

会话标记列表,取值详见 @V2TIMConversationMarkType(从 6.5 版本开始支持)

◆ customData

- (NSData*) customData
readnonatomicstrong

会话自定义数据(从 6.5 版本开始支持)

◆ conversationGroupList

- (NSArray<NSString *>*) conversationGroupList
readnonatomicstrong

会话所属分组列表(从 6.5 版本开始支持)

◆ c2cReadTimestamp

- (NSUInteger) c2cReadTimestamp
readnonatomicassign

最新已读消息的 UTC 时间戳,仅对单聊会话生效(从 7.1 版本开始支持)

◆ groupReadSequence

- (NSUInteger) groupReadSequence
readnonatomicassign

已读消息的 sequence,仅对群聊会话生效(从 7.1 版本开始支持)