ReadReceipt 类（HarmonyOS IMLib）
契约预留平台
HarmonyOS 当前为契约预留：本页的类、方法签名、枚举与示例全部来自冻结 IDL 与 sdk-bindings.json，SDK 尚未交付；实现后签名不会变化。
类继承图
Object→ReadReceipt
继承关系：Object → ReadReceipt。该数据结构不包含行为方法，字段与 domain.json → schemas.ReadReceipt 一一对应。
类说明
已读回执：会话、读者、已读消息列表、各消息已读人数与会话总人数。
| 项 | 值 |
|---|---|
| 类型 | 数据结构（值对象） |
| 字段数 | 9 |
| IDL 定义 | domain.json → schemas.ReadReceipt |
| 程序包 | @ni-paas-im/harmony |
| 跨端一致性 | 字段名与取值在 7 个平台绑定中一致；仅语言类型映射不同 |
| 平台状态 | 契约预留 |
字段概要
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
conversationType | ConversationType | 是 | 会话类型，见 ConversationType |
targetId | string | 是 | 目标 ID（userId / groupId / chatroomId / system） |
readerId | string | 是 | 已读用户 userId |
messageIds | string[] | 是 | 已读消息 ID 列表 |
readCounts | map<string,uint32> | 否 | 各消息已读人数：messageId → readCount |
totalMembers | uint32 | 否 | 会话总人数（用于计算已读比例） |
timestamp | int64 | 是 | 消息时间（epoch ms） |
readAt | int64 | 否 | 见字段类型定义 |
unreadCounts | map<string,uint32> | 否 | 见字段类型定义 |
详细字段说明
ConversationType conversationType会话类型，见 ConversationType
string targetId目标 ID（userId / groupId / chatroomId / system）
string readerId已读用户 userId
string[] messageIds已读消息 ID 列表
map<string,uint32> readCounts各消息已读人数：messageId → readCount
uint32 totalMembers会话总人数（用于计算已读比例）
int64 timestamp消息时间（epoch ms）
int64 readAt见字段类型定义
map<string,uint32> unreadCounts见字段类型定义
相关链接
- 关联类型：Message、IMClient
- 关联枚举：ConversationType
- 关联方法：—
- 返回索引：类 / 枚举