ConversationType 枚举(Web IMLib)
会话类型枚举:共 5 个取值,定义来自 domain.json → enums.ConversationType。
基本信息
| 项 | 值 |
|---|---|
| 枚举 | ConversationType |
| 取值数 | 5 |
| 本平台常量名 | ConversationType |
| IDL 来源 | domain.json → enums.ConversationType |
| 跨端一致性 | 取值跨端一致;常量名与成员名按平台绑定 |
| 平台状态 | 已交付 |
枚举常量摘要
| 名称 | 值 | 说明 |
|---|---|---|
PRIVATE | 1 | 单聊(1 对 1) |
GROUP | 2 | 群组(普通群;存量超级群以 2 + groupType=super 读取) |
CHATROOM | 3 | 聊天室 |
SYSTEM | 4 | 系统通知会话(固定 targetId=system) |
SUPER_GROUP | 10 | 超级群(rev22 新增;存量 2 + groupType=super 仍可读) |
使用说明
几乎所有会话相关接口的第一个参数;取值同时决定 targetId 的语义(userId / groupId / chatroomId / system)。rev22 起新增 SUPER_GROUP(10):超级群会话用 10 表达,存量超级群仍以 GROUP(2) + groupType=super 读取;两者共用同一群会话键(g:{groupId}),历史、未读、回执等群语义一致。
- 判断超级群时不要只比较
conversationType === 2:应接受10,或2且会话groupType === "super"。 - 发送超级群消息传 10;读取历史传 2 或 10 都指向同一会话(消息自带发送时的类型)。
- 服务端回调载荷没有
channelType字段;机器人/集成回调的channelType中 10 与存量 2+super 都映射ULTRAGROUP。
rev22 兼容(additive)
新增取值不改动 1/2/3/4 的语义;存量 2+super 数据不需要改写。迁移步骤、判断函数与回滚方式见「超级群类型迁移与兼容 FAQ」。
示例
JavaScript
const res = await client.sendTextMessage(
ConversationType.PRIVATE,
'user_001',
{ type: 'text', text: 'Hello, NI PaaS!' },
);