会话结构 | JuggleIM

ConversationInfo 是 SDK 封装的通用会话对象。ConversationInfo 对象中的 conversation（Conversation 类型）用来唯一标识一个会话。Conversation 包含两个属性：conversationType 标识会话类型，conversationId 标识会话 id。

属性名	类型	说明	版本
conversation	Conversation	会话标识	1.0.0
lastMessage	Message	会话的最后一条消息	1.0.0
unreadCount	int	当前会话的未读数	1.0.0
sortTime	long	会话排序时间（服务端时间）	1.0.0
isTop	boolean	是否置顶	1.0.0
topTime	long	会话置顶时间	1.0.0
mute	boolean	是否免打扰	1.0.0
draft	String	会话草稿	1.0.0
mentionInfo	ConversationMentionInfo	@ 信息	1.0.0
displayName	String	会话名字（按照默认规则显示的会话名字）	1.8.39
alias	String	会话备注名（群会话使用群备注名，单聊会话使用好友备注名）	1.8.39
name	String	会话本名（群会话使用群名称，单聊会话使用用户名称）	1.8.39
portrait	String	会话头像 URL	1.8.39

JConversationInfo 是 SDK 封装的通用会话对象。JConversationInfo 对象中的 conversation （JConversation 类型）用来唯一标识一个会话。JConversation 包含两个属性：conversationType 标识会话类型，conversationId 标识会话 id。

属性名	类型	说明	版本
conversation	JConversation	会话标识	1.0.0
lastMessage	JMessage	会话的最后一条消息	1.0.0
unreadCount	int	当前会话的未读数	1.0.0
sortTime	long long	会话排序时间（服务端时间）	1.0.0
isTop	BOOL	是否置顶	1.0.0
topTime	long long	会话置顶时间	1.0.0
mute	BOOL	是否免打扰	1.0.0
draft	NSString	会话草稿	1.0.0
mentionInfo	JConversationMentionInfo	@ 信息	1.0.0
displayName	NSString	会话名字（按照默认规则显示的会话名字）	1.8.39
alias	NSString	会话备注名（群会话使用群备注名，单聊会话使用好友备注名）	1.8.39
name	NSString	会话本名（群会话使用群名称，单聊会话使用用户名称）	1.8.39
portrait	NSString	会话头像 URL	1.8.39

属性名	类型	说明	版本
conversationId	String	会话 Id，会话类型是 `PRIVATE` 时，会话 Id 是接收方的 userId，会话类型是 `GROUP` 时是群组 Id	1.0.0
conversationType	Number	会话类型	1.0.0
conversationTitle	String	会话名称，修改会话名称请直接修改用户或群组名称	1.0.0
conversationPortrait	String	会话头像，修改会话头像请直接修改用户或群组头像	1.0.0
conversationExts	Object	会话的扩展，修改会话会话扩展请直接修改用户或群组扩展	1.0.0
latestMessage	Message	会话的最后一条消息，详细请查看 Message	1.0.0
draft	String	会话草稿，存储在本地，不会多端同步	1.0.0
isTop	Boolean	会话是否置顶	1.0.0
latestReadIndex	Number	当前会话中已读消息中最大的消息索引	1.0.0
latestUnreadIndex	Number	当前会话中未读消息中最大的消息索引，清理单个会话未读时会用到	1.0.0
undisturbType	Number	免打扰类型，用来显示会话免打扰状态	1.0.0
sortTime	Number	会话排序时间，会话列表默认按 sortTime 倒序排列	1.0.0
unreadCount	Number	当前会话的未读数	1.0.0
unreadTag	Number	会话标记状态	1.0.0
mentions	Object	会话 @ 消息标识，调用清空单个会话未读数后，`mentions` 会被清空	1.7.0
mentions.isMentioned	Boolean	会话中是否有 @ 自己的消息, 为 true 可在 UI 层展示 `有人 @ 我`	1.7.0
mentions.senders	Array	会话中 @ 消息发送人列表，可以用来在会话中展示发送 @ 消息头像名称，数据结构见下方示例	1.7.0
mentions.msgs	Array	会话中 @ 消息列表，数据结构见下方示例	1.7.0
mentions.count	Number	会话中 @ 消息的条数	1.7.0

Metions 数据结构:


{
  conversationId: 'Akd1kdlsf'
  conversationType: 2,
  //...
  mentions: {
    // 是否有 @ 自己
    isMentioned: true,
    senders: [
      { id: "userId01", name: "Xs", portrait: "https://xxx.com/avatar.png", updatedTime: 1726113434045, exts: {} }
    ],
    msgs: [
      { senderId: "userId01", messageId: "nut3lupwjgnlukc9", sentTime: 1728964798161 }
    ],
    count: 2
    },
}

属性名	类型	说明	版本
conversation	Conversation	会话标识	0.0.63
lastMessage	Message	会话的最后一条消息	0.0.63
unreadCount	int	当前会话的未读数	0.0.63
sortTime	int	会话排序时间（服务端时间）	0.0.63
isTop	bool	是否置顶	0.0.63
topTime	int	会话置顶时间	0.0.63
mute	bool	是否免打扰	0.0.63
draft	String	会话草稿	0.0.63
mentionInfo	ConversationMentionInfo	@ 信息	0.0.63
name	String	会话本名（群会话使用群名称，单聊会话使用用户名称）	0.0.72
portrait	String	会话头像 URL	0.0.72
displayName	String	会话名字（按照默认规则显示的会话名字）	0.0.72
alias	String	会话备注名（群会话使用群备注名，单聊会话使用好友备注名）	0.0.72

属性名	类型	说明	版本
conversation	Conversation	会话标识	1.0.0
lastMessage	Message	会话的最后一条消息	1.0.0
unreadCount	number	当前会话的未读数	1.0.0
sortTime	number	会话排序时间（��务端时间）	1.0.0
isTop	boolean	是否置顶	1.0.0
topTime	number	会话置顶时间	1.0.0
isMute	boolean	是否免打扰	1.0.0
draft	string	会话草稿	1.0.0
hasUnread	boolean	是否有未读消息	1.0.0
mentionInfo	ConversationMentionInfo	@ 信息	1.0.0
name	string	会话名称	1.0.0
avatar	string	会话头像	1.0.0
extra	object	会话扩展信息	1.0.0

Conversation 对象属性：

属性名	类型	说明
conversationType	number	会话类型：1-单聊，2-群聊，3-聊天室，4-系统会话
conversationId	string	会话 Id

属性名	类型	说明	版本
conversation	Conversation	会话标识	1.0.0
lastMessage	Message	会话的最后一条消息	1.0.0
unreadCount	number	当前会话的未读数	1.0.0
sortTime	number	会话排序时间（服务端时间）	1.0.0
isTop	boolean	是否置顶	1.0.0
topTime	number	会话置顶时间	1.0.0
mute	boolean	是否免打扰	1.0.0
draft	string	会话草稿	1.0.0
mentionInfo	ConversationMentionInfo	@ 信息	1.0.0