SDKsReact Native
会话概览
了解 React Native SDK 中的会话、会话状态和会话分组能力。
在 OpenIM React Native SDK 中，会话表示当前登录账号维护的一条聊天状态。单聊和群聊都会对应一个 ConversationItem，其中包含会话列表展示信息、未读状态、草稿和消息接收设置等内容。
会话记录与聊天目标使用不同的标识：conversationID 标识当前账号的会话记录，单聊目标使用对方的 userID，群聊目标使用 groupID。群组资料、成员和权限仍通过群组相关 API 管理。
会话标识
| 标识 | 用途 |
|---|---|
conversationID | 当前账号的会话记录 ID，用于会话设置、消息历史和未读状态。 |
userID | 单聊中的对方用户 ID。 |
groupID | 群聊对应的群组 ID。 |
sourceID | 按类型查询会话时传入的聊天目标：单聊传 userID，群聊传 groupID。 |
如需根据聊天目标获取 conversationID，可调用生成会话 ID，传入 sourceID 和 sessionType。
会话数据
ConversationItem 同时包含列表展示信息和当前账号的会话设置：
| 分类 | 字段 | 说明 |
|---|---|---|
| 标识和类型 | conversationID、conversationType | 定位会话记录并区分单聊和群聊。 |
| 列表展示 | showName、faceURL、latestMsg、latestMsgSendTime | 展示会话名称、头像和最后一条消息。 |
| 未读和提醒 | unreadCount、groupAtType | 展示未读数和群聊 @ 提醒状态。 |
| 列表组织 | isPinned、isMarked、draftText、remark | 管理置顶、标记、草稿和当前账号的会话备注。 |
| 消息策略 | recvMsgOpt、isPrivateChat、burnDuration、isMsgDestruct、msgDestructTime | 设置消息接收、阅后即焚和服务端消息删除。 |
| 其他状态和扩展 | isNotInGroup、attachedInfo、ex | 表示群组关系状态、SDK 附加信息和业务扩展。 |
按任务查找
| 任务 | 相关页面 |
|---|---|
| 获取一个或多个会话 | 查询指定会话、按 ID 批量获取会话、获取会话列表 |
| 整理会话列表 | 置顶或取消置顶会话、标记或取消标记会话、会话分组概览 |
| 管理草稿、备注和扩展字段 | 设置会话草稿、设置会话备注、设置会话扩展字段 |
| 设置消息接收和保留策略 | 设置会话消息接收方式、开启或关闭阅后即焚、定期删除服务端消息 |
| 处理未读数和群组提醒 | 标记会话已读、获取消息总未读数、重置群聊 @ 状态 |
隐藏、删除和清空
隐藏、删除和清空作用范围不同：
事件监听
会话状态变化会触发事件，具体的事件监听详见：
这个页面有帮助吗？