• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
Android/
会话/
SDK
  • 概述
    • 产品概述
    • 定价
      • 账单概览
      • Chat 包月套餐
      • Chat 增值计费说明
  • 快速开始
    • 集成 SDK
    • 初始化 SDK
    • 登录登出
  • 消息
    • 介绍
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 消息变更
    • 插入消息
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群 @ 消息
    • 群定向消息
    • 消息免打扰
    • 消息扩展
    • 消息回应
    • 消息翻译
    • 消息置顶
  • 会话
    • 介绍
    • 会话列表
    • 获取会话
    • 会话未读数
    • 置顶会话
    • 删除会话
    • 会话草稿
    • 会话标记
    • 会话分组
  • 群组
    • 介绍
    • 管理群组
    • 群资料
    • 管理群成员
    • 群成员资料
    • 自定义属性
    • 群计数器
  • 社群话题
    • 管理社群
    • 权限组
  • 用户
    • 用户资料
    • 用户状态
    • 管理好友
    • 好友分组
    • 黑名单
    • 关注与粉丝
  • 本地搜索
    • 搜索消息
    • 搜索好友
    • 搜索群组
    • 搜索群成员
  • 信令
  • 客户端 API
    • Java
  • 更新日志
  • 控制台指南
    • 新版控制台说明
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
    • 用量统计
    • 实时监控
    • 开发辅助工具
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 场景化实践
    • 实现直播间搭建
    • 实现游戏内聊天
    • AI 聊天机器人
    • 超大娱乐社群
    • 类Discord社群指南
  • 推送服务(Push)
    • 服务概述
    • 开通服务
    • 快速跑通
    • 厂商通道
      • 厂商配置
        • Android
        • iOS
        • Flutter
        • React-Native
      • 快速接入
        • Android
        • iOS
        • Flutter
        • React-Native
    • 数据统计
    • 排查工具
    • 客户端 API
      • Android
      • iOS
      • Flutter
      • React Native
    • 服务端 API
      • 发起全员/标签推送
      • 单发推送
      • 获取应用属性名称
      • 设置应用属性名称
      • 获取用户属性
      • 设置用户属性
      • 删除用户属性
      • 获取用户标签
      • 添加用户标签
      • 删除用户标签
      • 清空用户标签
      • 推送撤回
    • 推送回调
      • 全员/标签/单发回调
      • 其他推送回调
    • 高级功能
      • 自定义角标
      • 自定义铃音
      • 自定义小图标
      • 自定义点击跳转
      • 推送消息分类
    • 更新日志
      • Android
      • iOS
      • Flutter
      • React Native
    • 常见问题
  • 错误码

介绍

会话介绍

用户创建了一个单聊或群聊,当其中有消息的收发时,对应的会话就随之创建。 在 Chat SDK 中,会话管理类为 V2TIMConversationManager(Java) 和 V2TIMManager(Conversation)(iOS & Mac)。您可以使用会话管理类中的 API 实现会话列表展示/更新、会话未读数更新、置顶会话、会话草稿、会话免打扰等功能。

会话类介绍

会话类为 V2TIMConversation (Java / Swift / Objective-C / C++)。V2TIMConversation 定义了以下内容:
属性
含义
说明
type
会话类型
参考 V2TIMConversationType 定义。分为 C2C(单聊)和 Group(群聊)。
conversationID
会话唯一 ID
如果是单聊,组成方式为 c2c_userID;如果是群聊,组成方式为 group_groupID。
userID
对方用户 ID
如果会话类型为单聊,userID 会存储对方的用户 ID,否则为空。
groupID
当前群聊 ID
如果会话类型为群聊,groupID 会存储当前群的群 ID,否则为空。
groupType
当前群聊类型
如果会话类型为群聊,groupType 为当前群类型,否则为空。
showName
会话展示名称
群聊会话名称优先级:群名称 > 群 ID;
单聊会话名称优先级:对方好友备注 > 对方昵称 > 对方的 userID。
faceUrl
会话展示头像
群聊头像:群头像;单聊头像:对方头像。
unreadCount
会话未读消息数
具体使用请参考 会话未读数。直播群(AVChatRoom)不支持未读计数,默认为 0。
recvOpt
消息接收选项
参考 V2TIMReceiveMessageOpt 定义。具体使用请参考 消息免打扰.
lastMessage
会话最后一条消息
具体使用请参考 会话列表.
groupAtInfolist
群会话 @ 信息列表
通常用于展示 “有人@我” 或 “@所有人” 这两种提醒状态。
draftText
草稿信息
设置草稿信息请调用 setConversationDraft 接口,具体实现请参考 会话草稿.
draftTimestamp
草稿编辑时间
草稿设置的时候自动生成。
isPinned
会话是否置顶
具体使用请参考 置顶会话.
orderKey
会话排序字段
具体使用请参考 会话列表.
markList
会话标记列表
具体使用请参考 会话标记。从 6.5 版本开始支持。
customData
会话自定义数据
设置请调用 setConversationCustomData 接口。云端保存,最多支持 256 Bytes。从 6.5 版本开始支持。
conversationGroupList
会话所属分组列表
具体使用请参考 会话分组。从 6.5 版本开始支持。
c2cReadTimestamp
已读消息的时间戳
仅对单聊会话生效。从 7.1 版本开始支持。
groupReadSequence
已读消息的 sequence
仅对群聊会话生效。从 7.1 版本开始支持。

会话存储策略

本地存储的会话列表没有数量上限。云端存储的会话列表最大数量为 100。如果您希望扩展此数量,可以升级专业版、专业版plus、企业版。专业版、专业版plus、企业版用户可以在控制台配置最高数量为 500。
如果一个会话长时间没有信息变更,该会话在云端最多保存 7 天。本地存储的会话和云端存储的会话并不总是一致的,如果用户不主动调用 deleteConversation 接口删除本地的会话,该会话就会一直存在。而云端存储的会话最大只会保存 100 条,且对于长时间没有信息变更的会话,云端最多保存 7 天,所以不同的终端本地显示的会话可能会不一样。


在技术社区提问