Chat SDK for React Native 5.0.0
    Preparing search index...

    Class ChatConversation

    会话类,用于定义单聊会话、群聊会话和聊天室会话。

    每类会话中包含发送和接收的消息。

    关于会话名称,请根据会话类型获取: 单聊:详见 ChatUserInfoManager.fetchUserInfoById; 群聊:详见 ChatGroupManager.fetchGroupInfoWithoutMembersFromServer; 聊天室:详见 ChatRoomManager.fetchChatRoomInfoFromServer。

    Index
    • Parameters

      Returns ChatConversation

    convId: string

    会话 ID。

    会话类型。

    displayAvatar?: string

    会话的显示头像。

    注意 该字段由原生 SDK 返回。

    displayName?: string

    会话的显示名称。

    注意 该字段由原生 SDK 返回。要在 RN 层根据会话类型获取会话名称, 详见 ChatConversation.name。

    ext?: any

    会话扩展信息。

    isChatThread: boolean

    是否是子区会话:

    • true: 是;
    • false: 否。

    注意

    该参数仅对群聊有效。

    isPinned?: boolean

    会话是否置顶:

    • true:会话置顶。
    • (默认) false:会话不置顶。

    会话标记。

    pinnedTime?: number

    会话置顶 UNIX 时间戳,单位为毫秒,值 0 表示会话未置顶。

    remindType?: ChatPushRemindType

    会话提醒类型

    • 删除会话的所有消息。

      该方法将缓存和数据库的消息全部删除。

      Returns Promise<void>

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 删除本地数据库中的指定消息。

      Parameters

      • msgId: string

        要删除的消息 ID。

      Returns Promise<void>

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 删除消息。

      Parameters

      • params: { endTs: number; startTs: number }

      Returns Promise<void>

      参数组。

      • startTs: 开始的时间戳
      • endTs: 结束的时间戳

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 从服务器获取会话中顶置的消息。

      Returns Promise<ChatMessage[]>

      顶置消息列表。 如果没有获取到消息,则返回空列表。

      异常的描述。 请参阅ChatError。

    • 获取指定会话的最新消息。

      Returns Promise<ChatMessage | undefined>

      消息实例。如果不存在返回 undefined。

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 获取指定会话中最近接收到的消息。

      Returns Promise<ChatMessage | undefined>

      消息实例。如果不存在返回 undefined。

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 获取会话的消息数目。

      Returns Promise<number>

      消息的数目。

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 获取会话的消息数目。

      Parameters

      • start: number
      • end: number

      Returns Promise<number>

      消息数目

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 从本地获取会话中指定 ID 的消息。

      Parameters

      • params: { msgIds: string[] }

      Returns Promise<ChatMessage[]>

      检索到的消息列表。如果没有获取到消息,则返回空列表。

      异常的描述。请参阅 ChatError。

    • 从本地数据库中检索会话中指定数量的消息。

      检索到的消息也会根据其中包含的时间戳放入内存中的会话中。

      注意 如果会话对象不存在,此方法将创建它。

      Parameters

      Returns Promise<ChatMessage[]>

      检索到的消息列表(不包括具有起始时间戳的消息)。 如果没有获取到消息,则返回空列表。

      异常的描述。 请参阅ChatError。

    • 获取指定用户在一定时间段内在会话中发送的消息。

      该方法搜索本地数据库中的消息。

      注意 如果会话对象不存在,此方法将创建它。

      Parameters

      Returns Promise<ChatMessage[]>

      检索到的消息列表(不包括具有起始时间戳的消息)。 如果没有获取到消息,则返回空列表。

      • keywords 查询的关键字。
      • direction 消息搜索方向。请参阅 ChatSearchDirection。
      • (默认)ChatSearchDirection.UP:按照消息中包含的 Unix 时间戳 (ChatOptions.sortMessageByServerTime) 的降序顺序检索消息。
      • ChatSearchDirection.DOWN: 按照消息中包含的 Unix 时间戳 (ChatOptions.sortMessageByServerTime) 的升序检索消息。
      • timestamp 用于查询的消息中的起始 Unix 时间戳。 单位是毫秒。 设置该参数后,SDK按照消息搜索方向,从指定的消息开始检索消息。
      • searchScope 搜索范围,请参阅 ChatMessageSearchScope。
      • count 每次检索的最大消息数。 取值范围为[1,400]。
      • sender 用于检索的用户 ID 或组 ID。
      • senders 用于检索的用户 ID 或组 ID 列表。

      异常的描述。请参阅 ChatError。

    • 从本地数据库中检索会话中某种类型的消息。

      注意 如果会话对象不存在,此方法将创建它。

      Parameters

      • params: {
            count?: number;
            direction?: ChatSearchDirection;
            msgType: ChatMessageType;
            sender?: string;
            senders?: string[];
            timestamp?: number;
        }

      Returns Promise<ChatMessage[]>

      检索到的消息列表(不包括具有起始时间戳的消息)。 如果没有获取到消息,则返回空列表。

      异常的描述。 请参阅ChatError。

    • 检索本地数据库中某个会话在一定时间内发送和接收的消息。

      注意 如果会话对象不存在,此方法将创建它。

      Parameters

      • params: {
            count?: number;
            direction?: ChatSearchDirection;
            endTime: number;
            startTime: number;
        }

      Returns Promise<ChatMessage[]>

      检索到的消息列表(不包括具有开始或结束时间戳的消息)。 如果没有获取到消息,则返回空列表。

      异常的描述。 请参阅ChatError。

    • 从本地获取会话中的置顶消息。

      Returns Promise<ChatMessage[]>

      置顶消息列表。如果没有获取到消息,则返回空列表。

      异常的描述。 请参阅ChatError。

    • 获取会话的未读消息数量。

      Returns Promise<number>

      会话的未读消息数量。

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 获取会话 ID。

      Returns Promise<string | undefined>

      会话 ID。

    • 从会话中删除消息(从本地存储和服务器)。

      Parameters

      • msgIds: string[]

        要从当前会话中删除的消息的 ID。

      Returns Promise<void>

      异常的描述。 请参阅ChatError。

    • 从会话中删除消息(从本地存储和服务器)。

      Parameters

      • timestamp: number

        消息时间戳(以毫秒为单位)。 时间戳小于指定时间戳的消息将被删除。

      Returns Promise<void>

      异常的描述。 请参阅ChatError。

    • 移除本地和服务器的消息。和该聊天会话相关的所有消息都将被删除。会话中的其他人的服务器端消息不受影响。不会删除。

      Parameters

      • params: { timestamp: number }

        参数集合

        • timestamp: 该时间点之前的消息将被删除。

      Returns Promise<void>

      异常的描述。 请参阅ChatError。

    • 搜索本地消息。

      Parameters

      Returns Promise<ChatMessage[]>

      消息列表。 如果没有获取到消息,则返回空列表。

      • 参数集合
      • msgTypes: 消息类型的数组。 详见 ChatMessageType.
      • timestamp: 时间点。
      • count: 搜索的最大消息数。
      • from: 消息的发送者。
      • direction: 搜索方向。 详见 ChatSearchDirection.

      异常的描述。 请参阅ChatError。

    • 设置指定会话的自定义扩展信息。

      Parameters

      • ext: { [key: string]: string | number }

        会话扩展信息。

      Returns Promise<void>

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。

    • 更新本地数据库的指定消息。

      消息更新时,消息 ID 不会修改。

      消息更新后,SDK 会自动更新会话的 latestMessage 等属性。

      Parameters

      Returns Promise<void>

      如果有方法调用的异常会在这里抛出,可以看到具体错误原因。参见 ChatError。