Conversation

Conversation

会话对象,用于描述会话具有的属性,如类型、消息未读计数、最新消息等。

Properties:
Name Type Description
conversationID String

会话 ID。会话ID组成方式:

  • C2C${userID}(单聊)
  • GROUP${groupID}(群聊)
  • @TIM#SYSTEM(系统通知会话)
type String

会话类型,具体如下:

类型 含义
TIM.TYPES.CONV_C2C C2C(Client to Client, 端到端)会话
TIM.TYPES.CONV_GROUP GROUP(群组)会话
TIM.TYPES.CONV_SYSTEM SYSTEM(系统)会话。该会话只能接收来自系统的通知消息,不能发送消息。
subType String

群组会话的群组类型,具体如下:

类型 含义
TIM.TYPES.GRP_WORK 好友工作群
TIM.TYPES.GRP_PUBLIC 陌生人社交群
TIM.TYPES.GRP_MEETING 临时会议群
TIM.TYPES.GRP_AVCHATROOM 直播群
unreadCount Number

未读计数。TIM.TYPES.GRP_MEETING / TIM.TYPES.GRP_AVCHATROOM 类型的群组会话不记录未读计数,该字段值为0

lastMessage Object

会话最新的消息

Properties
Name Type Description
lastTime Number

当前会话最新消息的时间戳,单位:秒

lastSequence Number

当前会话的最新消息的 Sequence

fromAccount String

最新消息来源用户的 userID

messageForShow String

最新消息的内容,用于展示。可能值:文本消息内容、"[图片]"、"[语音]"、"[位置]"、"[表情]"、"[文件]"、"[自定义消息]"。
若该字段不满足您的需求,您可以使用 payload 来自定义渲染。

type String

消息类型,具体如下:

类型 含义
TIM.TYPES.MSG_TEXT 文本消息
TIM.TYPES.MSG_IMAGE 图片消息
TIM.TYPES.MSG_SOUND 音频消息(已废弃,请使用 TIM.TYPES.MSG_AUDIO )
TIM.TYPES.MSG_AUDIO 音频消息
TIM.TYPES.MSG_FILE 文件消息
TIM.TYPES.MSG_GRP_TIP 群提示消息
TIM.TYPES.MSG_GRP_SYS_NOTICE 群系统通知消息
payload Object

消息的内容,具体如下:

groupProfile Group

群组会话的群组资料

userProfile Profile

C2C会话的用户资料

groupAtInfoList Array.<GroupAtInfo>

群会话的 at 信息列表,接入侧可根据此信息在会话列表展示【有人@我】【@所有人】等效果。GroupAtInfo - 群 at 信息结构,v2.9.0 起支持。

Type Definitions

GroupAtInfo

Properties:
Name Type Description
groupID String

群 ID

messageSequence Number

带 at 信息的消息的 sequence

atTypeArray Array.<Number>

at 类型数组,群会话 at 枚举值如下:

  • TIM.TYPES.CONV_AT_ME 有人 at 我
  • TIM.TYPES.CONV_AT_ALL at 群里所有人
  • TIM.TYPES.CONV_AT_ALL_AT_ME at 群里所有人并且单独 at 我

群 at 信息结构