Conversation 类(Web IMLib)
类继承图
Object→Conversation
继承关系:Object → Conversation。该数据结构不包含行为方法,字段与 domain.json → schemas.Conversation 一一对应。
类说明
会话聚合视图:未读数、@ 未读、置顶、草稿、提醒级别与最后一条消息;按置顶优先、更新时间倒序排列。
| 项 | 值 |
|---|---|
| 类型 | 数据结构(值对象) |
| 字段数 | 11 |
| IDL 定义 | domain.json → schemas.Conversation |
| 程序包 | @ni-paas/im-web |
| 跨端一致性 | 字段名与取值在 7 个平台绑定中一致;仅语言类型映射不同 |
| 平台状态 | 已交付 |
字段概要
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
conversationType | ConversationType | 是 | 会话类型,见 ConversationType |
targetId | string | 是 | 目标 ID(userId / groupId / chatroomId / system) |
targetName | string | 否 | 会话名称(群名 / 对方昵称) |
unreadCount | uint32 | 是 | 未读消息数 |
mentionedCount | uint32 | 否 | @ 提及未读数 |
lastMessage | Message | 否 | 会话最后一条消息 |
updatedAt | int64 | 是 | 最后更新时间(epoch ms) |
isPinned | bool | 是 | 是否置顶 |
draft | string | 否 | 会话草稿文本 |
notificationLevel | NotificationLevel | 否 | 会话提醒级别,见 NotificationLevel |
groupType | GroupType | 否 | IDL rev21(additive):仅群会话有值——群存在时 "normal"|"super",群已删除或非群会话为 null。用于客户端在会话列表标注超级群,不改变 conversationType(超级群仍是 GROUP=2)。 |
详细字段说明
ConversationType conversationType会话类型,见 ConversationType
string targetId目标 ID(userId / groupId / chatroomId / system)
string targetName会话名称(群名 / 对方昵称)
uint32 unreadCount未读消息数
uint32 mentionedCount@ 提及未读数
Message lastMessage会话最后一条消息
int64 updatedAt最后更新时间(epoch ms)
bool isPinned是否置顶
string draft会话草稿文本
NotificationLevel notificationLevel会话提醒级别,见 NotificationLevel
GroupType groupTypeIDL rev21(additive):仅群会话有值——群存在时 "normal"|"super",群已删除或非群会话为 null。用于客户端在会话列表标注超级群,不改变 conversationType(超级群仍是 GROUP=2)。