枚举(HarmonyOS IMLib)
本页列出 HarmonyOS IMLib 的 14 个客户端枚举。枚举取值由 IDL 冻结,各端数值 / 字符串一致,只有常量名不同。
契约预留平台
HarmonyOS 当前为契约预留:本页的类、方法签名、枚举与示例全部来自冻结 IDL 与 sdk-bindings.json,SDK 尚未交付;实现后签名不会变化。
枚举列表
| 枚举 | 本平台常量名 | 取值数 | 说明 | 来源 |
|---|---|---|---|---|
| ChatroomEventKind | — | 5 | 聊天室事件类型 | domain.json → enums.ChatroomEventKind |
| ConnectionStatus | ConnectionStatus | 4 | 连接状态 | domain.json → enums.ConnectionStatus |
| ContentType | ContentType | 9 | 消息内容类型 | domain.json → enums.ContentType |
| ConversationType | ConversationType | 5 | 会话类型 | domain.json → enums.ConversationType |
| Direction | — | 2 | 消息方向 | domain.json → enums.Direction |
| ErrorCode | ErrorCode | 43 | 错误码 | errors.json → codes(33 个) |
| EventType | IMClientEvent | 16 | 事件类型 | sdk-imlib.json → capabilityModel.events(全部事件) |
| FriendEventKind | — | 3 | 好友事件类型 | domain.json → enums.FriendEventKind |
| FriendRequestStatus | — | 3 | 好友请求状态 | domain.json → enums.FriendRequestStatus |
| GroupRole | GroupRole | 3 | 群成员角色 | domain.json → enums.GroupRole |
| GroupType | GroupType | 2 | 群组类型 | domain.json → enums.GroupType |
| MentionType | — | 2 | @ 提及类型 | domain.json → enums.MentionType |
| NotificationLevel | NotificationLevel | 3 | 会话提醒级别 | domain.json → enums.NotificationLevel |
| SystemType | — | 8 | 系统通知子类型 | domain.json → enums.SystemType |
使用约定
- 枚举值在 IDL 中是冻结契约:新增取值属于 additive 变更,旧客户端必须能按未知值降级处理。
- 数值型枚举(ConversationType / ConnectionStatus / Direction / NotificationLevel / MentionType)在各端取值相同。
- 字符串型枚举(GroupType / GroupRole / ContentType / SystemType / FriendRequestStatus / ChatroomEventKind / FriendEventKind)在各端取值相同。
- 错误码枚举:ErrorCode(33 个);事件枚举:EventType(16 个)。