Conversation 类（HarmonyOS IMLib）
契约预留平台
HarmonyOS 当前为契约预留：本页的类、方法签名、枚举与示例全部来自冻结 IDL 与 sdk-bindings.json，SDK 尚未交付；实现后签名不会变化。
类继承图
Object→Conversation
继承关系：Object → Conversation。该数据结构不包含行为方法，字段与 domain.json → schemas.Conversation 一一对应。
类说明
会话聚合视图：未读数、@ 未读、置顶、草稿、提醒级别与最后一条消息；按置顶优先、更新时间倒序排列。
| 项 | 值 |
|---|---|
| 类型 | 数据结构（值对象） |
| 字段数 | 11 |
| IDL 定义 | domain.json → schemas.Conversation |
| 程序包 | @ni-paas-im/harmony |
| 跨端一致性 | 字段名与取值在 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）。