getConversation

功能介绍

获取会话列表

本地存储的会话列表没有数量上限。

云端存储的会话列表最大数量为 100。如果您希望扩展此数量,可以升级旗舰版。旗舰版用户可以在控制台配置最高数量为 500。

长时间没有信息变更,该会话在云端最多保存 7 天。如需放宽限制,请 联系我们

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

参数详解

参数名称 参数类型 是否必填 平台 描述
conversationID String 全部 会话唯一 ID,如果是 C2C 单聊,组成方式为 c2c_userID,如果是群聊,组成方式为 group_groupID

返回模板

V2TimValueCallback<V2TimConversation>

{
    code : int
    desc : String
    data : {
      conversationID : String
      type : ConversationType
      userID : String
      groupID : String
      showName : String
      faceUrl : String
      groupType : String
      unreadCount : int
      lastMessage;
      draftText : String
      draftTimestamp : int
      isPinned : bool
      recvOpt : int
      groupAtInfoList : List<V2TimGroupAtInfo>
      orderkey : int
    }
}

返回值详解

名称 数值类型 描述
code int 请求结果错误码
desc String 请求结果描述符
data V2TimConversation 此次拉取到的消息信息

代码示例

    //获取指定会话
    V2TimValueCallback<V2TimConversation> getConversationtRes =
        await TencentImSDKPlugin.v2TIMManager
            .getConversationManager()
            .getConversation(conversationID: "");//会话唯一 ID,如果是 C2C 单聊,组成方式为 c2c_userID,如果是群聊,组成方式为 group_groupID
    if (getConversationtRes.code == 0) {
      //拉取成功
       getConversationtRes.data?.conversationID;//会话唯一 ID,如果是单聊,组成方式为 c2c_userID;如果是群聊,组成方式为 group_groupID。
       getConversationtRes.data?.draftText;//草稿信息
       getConversationtRes.data?.draftTimestamp;//草稿编辑时间,草稿设置的时候自动生成。
       getConversationtRes.data?.faceUrl;//会话展示头像,群聊头像:群头像;单聊头像:对方头像。
       getConversationtRes.data?.groupAtInfoList;//群会话 @ 信息列表,通常用于展示 “有人@我” 或 “@所有人” 这两种提醒状态。
       getConversationtRes.data?.groupID;//当前群聊 ID,如果会话类型为群聊,groupID 会存储当前群的群 ID,否则为 null。
       getConversationtRes.data?.groupType;//当前群聊类型,如果会话类型为群聊,groupType 为当前群类型,否则为 null。
       getConversationtRes.data?.isPinned;//会话是否置顶
       getConversationtRes.data?.lastMessage;//会话最后一条消息
       getConversationtRes.data?.orderkey;//会话排序字段
       getConversationtRes.data?.recvOpt;//消息接收选项
       getConversationtRes.data?.showName;//会话展示名称,群聊会话名称优先级:群名称 > 群 ID;单聊会话名称优先级:对方好友备注 > 对方昵称 > 对方的 userID。
       getConversationtRes.data?.type;//会话类型,分为 C2C(单聊)和 Group(群聊)。
       getConversationtRes.data?.unreadCount;//会话未读消息数,直播群(AVChatRoom)不支持未读计数,默认为 0。
       getConversationtRes.data?.userID;//对方用户 ID,如果会话类型为单聊,userID 会存储对方的用户 ID,否则为 null。
    }

results matching ""

    No results matching ""