• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
Flutter/
会话/
SDK
  • 安装即时通信 IM SDK
    • 安装
  • 初始化即时通信 IM SDK
    • 初始化
  • 登录和注销
    • 登录和注销
  • 消息
    • 消息概述
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 修改消息
    • 消息插入
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群 @ 消息
    • 定向群消息
    • 通知免打扰
    • 消息扩展
  • 会话
    • 会话概述
    • 会话列表
    • 获取会话
    • 未读会话数
    • 置顶会话
    • 删除会话
    • 会话草稿
    • 会话组
  • 群组
    • 群组概述
    • 群组管理
    • 群资料
    • 群成员管理
    • 群成员资料
    • 自定义群属性
  • 用户
    • 用户资料
    • 好友管理
    • 好友列表
    • 黑名单
  • 离线推送
    • 离线推送
  • 信令
    • 信令管理
  • 局部搜索
    • 查找消息
    • 查找好友
    • 查找群组
    • 查找群成员
  • 接口参考文档
    • 客户接口
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

会话概述

会话介绍

当用户创建了一个单聊或群聊,对应的会话就随之创建。
在腾讯云 IM SDK 中,会话类为 TencentImSDKPlugin.v2TIMManager.getConversationManager()。您可以使用会话管理类中的 API 实现会话列表展示/更新、会话未读数更新、置顶会话、会话草稿、会话免打扰等功能。

会话类介绍

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

会话存储策略

本地存储的会话列表没有数量上限。
云端存储的会话列表最大数量为 100。如果您希望扩展此数量,可以升级旗舰版。旗舰版用户可以在控制台配置最高数量为 500。
云端存储的会话列表最大数量为 100。如果您希望扩展此数量,可以升级旗舰版。旗舰版用户可以在控制台配置最高数量为 500,配置页面如下图所示:



如果一个会话长时间没有信息变更,该会话在云端最多保存 7 天。如需放宽限制,请 联系我们
本地存储的会话和云端存储的会话并不总是一致的,如果用户不主动调用 deleteConversation 接口删除本地的会话,该会话就会一直存在。而云端存储的会话最大只会保存 100 条,且对于长时间没有信息变更的会话,云端最多保存 7 天,所以不同的终端本地显示的会话可能会不一样。