@rongcloud/engine 5.7.2-beem.3 → 5.7.2-beemrtc.1

package/index.d.ts

@@ -1506,2838 +1506,2843 @@ declare enum SentStatus {
     DESTROYED = 60
 }
 
-declare enum StoreKeys {
+/**
+ * @category Interface
+ */
+interface IChatroomEntryListenerData {
     /**
-     * Navi 数据缓存，暂未使用
-     */
-    NAVI = "rc-navi",
+     * 更新的键
+    */
+    key: string;
     /**
-     * 实时日志已上报的时间戳
-     */
-    REALTIME_LOG_TIMESTAMP = "rc-realtime-log-timestamp"
-}
-
-declare enum UltraGroupChannelType {
-    PUBLIC = 0,
-    PRIVATE = 1
-}
-declare enum UltraGroupChannelChangeType {
-    PUBLIC_TO_PRIVATE = 2,
-    PRIVATE_TO_PUBLIC = 3,
-    PUBLIC_TO_PRIVATE_USER_NOT_IN = 6
-}
-/** PB 结构 MsgChange 属性 changeType 对应枚举值 */
-declare enum UltraMsgChangeType {
-    MSG_EXPANSION = 1,
-    MSG_MODIFY = 2,
-    MSG_RECALL = 3,
-    CHANNEL_CHANGE = 4,
-    USER_GROUP_CHANGE = 5
+     * 更新的值
+    */
+    value: string;
+    /**
+     * 更新的时间
+    */
+    timestamp: number;
+    /**
+     * 更新的聊天室 ID
+    */
+    chatroomId: string;
+    /**
+     * 更新类型
+    */
+    type: ChatroomEntryType;
 }
-/** PB 结构 MsgChange 属性 subChangeType 对应枚举值 */
-declare enum UltraMsgSubChangeType {
-    CHANNEL_DELETE = 1,
-    PUBLIC_TO_PRIVATE = 2,
-    PRIVATE_TO_PUBLIC = 3,
-    PRIVATE_CHANNEL_USER_JOIN_PUBLIC = 4,
-    CHANNEL_USER_KICKED = 5,
-    PUBLIC_TO_PRIVATE_USER_NOT_IN = 6
+/**
+ * @category Interface
+ */
+interface IChatroomRejoinedFailed {
+    /**
+     * 自动重新加入的聊天室 ID
+    */
+    chatroomId: string;
+    /**
+     * 自动重新加入失败的 code
+    */
+    errorCode: number;
 }
-declare enum UserGroupChangeType {
-    REMOVE_USER_GROUP = 1,
-    JOIN_USER_GROUP = 2,
-    EXIT_USER_GROUP = 3,
-    CHANNEL_BIND_USER_GROUP = 4,
-    CHANNEL_UNBIND_USER_GROUP = 5
+/**
+ * @category Interface
+ */
+interface IChatroomRejoinedSuccessed {
+    /**
+     * 自动重新加入的聊天室 ID
+    */
+    chatroomId: string;
+    /**
+     * 自动重新加入的聊天室拉取消息的数量
+    */
+    count: number;
 }
-
 /**
- * 音视频模式
+ * @category Interface
  */
-declare enum RTCMode {
+interface IChatroomUserChangeInfo {
+    users: {
+        [userId: string]: ChatroomUserChangeType;
+    };
+    chatroomId: string;
+}
+declare type IChatroomRejoinedInfo = IChatroomRejoinedFailed | IChatroomRejoinedSuccessed;
+/**
+ * 聊天室信息
+ * @category Interface
+*/
+interface IChatroomListenerData {
     /**
-     * 普通音视频模式
+     * SDK 内部重连聊天室信息
+    */
+    rejoinedRoom?: IChatroomRejoinedInfo;
+    /**
+     * 监听到的聊天室 KV 更新
+    */
+    updatedEntries?: IChatroomEntryListenerData[];
+    /**
+     * 登录退出的用户通知
      */
-    RTC = 0,
+    userChange?: IChatroomUserChangeInfo;
     /**
-     * 直播模式
+     * 聊天室销毁
      */
-    LIVE = 2,
+    chatroomDestroyed?: string;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomEntry {
     /**
-     *sip呼叫
+     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    SIP = 4,
+    key: string;
     /**
-     * 呼叫模式.包括单呼和群呼
+     * 属性对应的值, 最大长度 4096 字符
      */
-    CALL = 5,
+    value: string;
     /**
-     * 会议
+     * 设置成功后是否发送通知消息
      */
-    MEETING = 6,
+    isSendNotification?: boolean;
     /**
-     * 跨应用多人房间
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    CROSS_MUTI = 7,
+    notificationExtra?: string;
     /**
-     * 跨应用直播
+     * 用户退出聊天室时是否清除此属性
      */
-    CROSS_LIVE = 8
+    isAutoDelete?: boolean;
 }
 /**
- * 直播类型
+ * @category Interface
  */
-declare enum LiveType {
+interface IChatroomUser {
     /**
-     * 音视频直播
+     * 用户 id
      */
-    AUDIO_AND_VIDEO = 0,
+    id: string;
     /**
-     * 音频直播
+     * 加入聊天室的时间
      */
-    AUDIO = 1
+    time: number;
 }
-declare enum LiveRole {
+/**
+ * @category Interface
+ */
+interface IChatroomInfo {
     /**
-     * 主播身份
+     * 成员列表
+     * @todo 需确认数组元素的数据结构
      */
-    ANCHOR = 1,
+    userInfos: IChatroomUser[];
     /**
-     * 观众身份
+     * 房间内总人数
      */
-    AUDIENCE = 2
-}
-/**
- * CallLib 流程消息
- */
-declare const CallLibMsgType: {
-    'RC:VCAccept': string;
-    'RC:VCRinging': string;
-    'RC:VCSummary': string;
-    'RC:VCHangup': string;
-    'RC:VCInvite': string;
-    'RC:VCModifyMedia': string;
-    'RC:VCModifyMem': string;
-};
-declare enum RTCApiType {
-    ROOM = 1,
-    PERSON = 2
-}
-declare enum RTCIdentityChangeType {
-    AnchorToViewer = 1,
-    ViewerToAnchor = 2
+    userCount: number;
 }
 /**
- * RTC 房间加入类型
+ * @category Interface
  */
-declare enum RTCJoinType {
+interface IRemoveChatroomEntry {
     /**
-     * 踢前一个设备
+     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    KICK = 0,
+    key: string;
     /**
-     * 当前加入拒绝
+     * 删除成功后是否发送通知消息
      */
-    REFUSE = 1,
+    isSendNotification?: boolean;
     /**
-     * 两个设备共存
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    COEXIST = 2
+    notificationExtra?: string;
 }
-
 /**
  * @category Interface
  */
-interface IGooglePushConfig {
+interface IRemoveChatroomEntries {
     /**
-     * 分组ID
+     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    collapseKey?: string;
+    entries: {
+        key: string;
+    }[];
     /**
-     *
+     * 删除成功后是否发送通知消息
      */
-    imageUrl?: string;
     /**
-     *优先级
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    priority?: 'high' | 'normal';
+    notificationExtra?: string;
 }
 /**
  * @category Interface
  */
-interface IiOSPushConfig {
+interface IChatroomEntries {
     /**
-     * iOS 用于通知分组的 id
+     * entries ,要设置的属性列表
+     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * value 属性对应的值, 最大长度 4096 字符
      */
-    threadId?: string;
+    entries: {
+        key: string;
+        value: string;
+    }[];
     /**
-     * iOS 用于通知覆盖的 id
+     * 设置成功后是否发送通知消息
      */
-    apnsCollapseId?: string;
     /**
-     * iOS 分类，如果不设置后台默认取消息类型字符串，如RC:TxtMsg
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    category?: string;
+    notificationExtra?: string;
     /**
-     * 和 category 对应
+     * 用户退出聊天室时是否清除此属性
      */
-    richMediaUri?: string;
+    isAutoDelete?: boolean;
+    /**
+     * 是否强制覆盖
+     */
+    isForce?: boolean;
 }
+
 /**
  * @category Interface
  */
-interface IAndroidPushConfig {
+interface IAsyncRes<T = void> {
     /**
-     * Android 的通知 id
+     * Promise 执行结果
      */
-    notificationId?: string;
+    code: ErrorCode;
     /**
-     * 小米的 channelId
+     * 结果数据
      */
-    channelIdMi?: string;
-    /**
-     * 小米 Large icon 链接
-     * Large icon 可以出现在大图版和多字版消息中，显示在右边。
-     * 国内版仅 MIUI12 以上版本支持，以下版本均不支持；国际版支持。
-     * 图片要求：大小 120 * 120px，格式为 png 或者 jpg 格式。
-     */
-    miLargeIconUrl?: string;
-    /**
-     * 华为的 channelId
-     */
-    channelIdHW?: string;
-    /**
-     * 华为推送消息分类
-     * 更多信息请参考华为消息分类标准文档: https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835
-     * 5.7.3 版本开始支持
-    */
-    categoryHW?: string;
-    /**
-     * 华为推送消息级别
-     * LOW: 表示消息为资讯营销
-     * NORMAL: 消息为服务与通讯
-     */
-    importanceHW?: 'NORMAL' | 'LOW';
-    /**
-     * 华为通知类型的推送所使用的通知图片 url
-    */
-    imageUrlHW?: string;
-    /**
-     * OPPO 的 channelId
-     */
-    channelIdOPPO?: string;
+    data?: T;
     /**
-     * vivo 的类型
+     * 错误消息
      */
-    typeVivo?: string;
-    /**
-    * google FCM 的推送配置
-    */
-    googleConfig?: IGooglePushConfig;
+    msg?: string;
 }
 /**
- * 推送配置
- * @category Interface
+ * 异步任务结果定义
+ * @description
+ * 通过 `Promise.resolve` 来处理预期内的异常，进而通过 Uncatch Promise Error 暴露预期外的异常
  */
-interface IPushConfig {
-    /**
-     * 推送标题
-     * 如果没有设置，会使用下面的默认标题显示规则
-     * 默认标题显示规则：
-     * 内置消息：单聊通知标题显示为发送者名称，群聊通知标题显示为群名称。
-     * 自定义消息：默认不显示标题。
-     */
-    pushTitle: string;
-    /**
-     * 推送内容
-     * 优先使用 IPushConfig.pushContent, 如果没有，则使用发送消息的 pushContent 参数
-     */
-    pushContent: string;
-    /**
-     * 远程推送附加信息
-     * 优先使用 IPushConfig.pushData, 如果没有，则使用发送消息的 pushContent 参数
-     */
-    pushData: string;
-    /**
-     * iOSConfig
-     */
-    iOSConfig?: IiOSPushConfig;
-    /**
-     * androidConfig
-     */
-    androidConfig?: IAndroidPushConfig;
+declare type IPromiseResult<T = void> = Promise<IAsyncRes<T>>;
+interface IConnectResult {
     /**
-     * 是否显示推送标题. 仅针对 iOS 平台有效
+     * 连接错误码
      */
-    disablePushTitle: boolean;
+    code: ErrorCode;
     /**
-     * 是否强制推送
+     * 导航获取成功后即可有相应的值，在导航数据获取完成之前该值为 undefined
      */
-    forceShowDetailContent: boolean;
-    /**
-     * 推送模板id
-    */
-    templateId: string;
+    userId?: string;
 }
 
-/**
- * 已读回执数据结构
- * @category Interface
- */
-interface IMessageReader {
-    readTime: number;
-    userId: string;
+declare enum UltraGroupChannelType {
+    PUBLIC = 0,
+    PRIVATE = 1
 }
-/**
- * @category Interface
- */
-interface IMessageReaderResponse {
-    totalMemberCount: number;
-    list: IMessageReader[];
+declare enum UltraGroupChannelChangeType {
+    PUBLIC_TO_PRIVATE = 2,
+    PRIVATE_TO_PUBLIC = 3,
+    PUBLIC_TO_PRIVATE_USER_NOT_IN = 6
 }
-interface ILocalReadReceiptInfo {
-    hasRespond?: boolean;
-    readerInfo?: {
-        [userId: string]: number;
-    };
-    readCount?: number;
-    totalCount?: number;
+/** PB 结构 MsgChange 属性 changeType 对应枚举值 */
+declare enum UltraMsgChangeType {
+    MSG_EXPANSION = 1,
+    MSG_MODIFY = 2,
+    MSG_RECALL = 3,
+    CHANNEL_CHANGE = 4,
+    USER_GROUP_CHANGE = 5
 }
-/**
- * @category Interface
- */
-interface IReadReceiptInfo {
-    /**
-     * 是否已经发送已读回执
-     */
-    hasRespond?: boolean;
-    /**
-     * 已阅读用户列表（不准确）
-     */
-    readerList?: IMessageReader[];
-    /**
-     * 阅读人数（不准确）
-     */
-    readCount?: number;
+/** PB 结构 MsgChange 属性 subChangeType 对应枚举值 */
+declare enum UltraMsgSubChangeType {
+    CHANNEL_DELETE = 1,
+    PUBLIC_TO_PRIVATE = 2,
+    PRIVATE_TO_PUBLIC = 3,
+    PRIVATE_CHANNEL_USER_JOIN_PUBLIC = 4,
+    CHANNEL_USER_KICKED = 5,
+    PUBLIC_TO_PRIVATE_USER_NOT_IN = 6
+}
+declare enum UserGroupChangeType {
+    REMOVE_USER_GROUP = 1,
+    JOIN_USER_GROUP = 2,
+    EXIT_USER_GROUP = 3,
+    CHANNEL_BIND_USER_GROUP = 4,
+    CHANNEL_UNBIND_USER_GROUP = 5
+}
+
+interface IMentionInfo {
+    type: MentionedType;
     /**
-     * 群组总人数（不准确）
+     * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
      */
-    totalCount?: number;
+    userIdList: string[];
 }
 /**
- * 从服务端接收到的消息数据
+ * 从服务器拉取到的会话数据结构
  * @category Interface
  */
-interface IReceivedMessage {
+interface IReceivedConversation {
     /**
      * 会话的业务标识
     */
     channelId?: string;
     /**
      * 会话类型
-     * * 1: 单聊
-     * * 3: 群聊
-     * * 4: 聊天室
-     * * 5: 客服会话
-     * * 6: 系统消息
-     * * 7: 默认关注的公众号
-     * * 8: 手动关注的公众号
-     * * 9: RTCLib 房间
      */
     conversationType: ConversationType;
     /**
-     * 会话 targetId
+     * 会话 Id
+     * @description
+     * 1. 当 `conversationType` 为 `ConversationType.GROUP` 时，该值为群组 Id
+     * 1. 当 `conversationType` 为 `ConversationType.PRIVATE` 时，该值为对方用户 Id
      */
     targetId: string;
     /**
-     * 消息发送者的用户 Id
-     */
-    senderUserId: string;
-    /**
-     * 消息内容
-     */
-    content: any;
-    /**
-     * 消息结构名称，即消息类型
-     * @example RC:TxtMsg
-     */
-    messageType: string;
-    /**
-     * 服务端存储的消息 Id
-     */
-    messageUId: string;
-    /**
-     * 消息方向是发出 or 收取
+     * 当前会话的未读消息数
      */
-    messageDirection: MessageDirection;
+    unreadMessageCount: number;
     /**
-     * 是否为离线消息
+     * 会话中的最后一条消息
      */
-    isOffLineMessage: boolean;
+    latestMessage: IReceivedMessage | null;
     /**
-     * 消息在服务器端的发送时间
+     * 是否包含 @ 自己的消息，此数据仅在 `conversationType` 为 `ConversationType.GROUP` 时有效
      */
-    sentTime: number;
+    hasMentioned?: boolean;
     /**
-     * 消息接收时间，该时间通过消息的 `sentTime` 值在本地进行计算得出，不推荐使用
-     * @description 当 isOffLineMessage 为 true 时，该值无效
+     * 消息中的 @ 数据，仅在 `conversationType` 为 `ConversationType.GROUP` 时有效
      */
-    receivedTime: number;
+    mentionedInfo?: IMentionInfo | null;
     /**
-     * 是否存储
-     * @default true
+     * 会话免打扰状态
+     * @description
+     * 1. 已开启免打扰
+     * 2. 未开启免打扰
      */
-    isPersited: boolean;
+    notificationStatus: NotificationStatus;
+    notificationLevel?: NotificationLevel;
     /**
-     * 是否计数
-     * @default true
+     * 会话是否已置顶
      */
-    isCounted: boolean;
+    isTop: boolean;
     /**
-     * 是否为 @ 消息
+     * 会话中消息的最后未读时间
      */
-    isMentioned: boolean;
+    lastUnreadTime: number;
     /**
-     * 消息是否静默
-     * @description 静默消息不会发送 Push 信息和本地通知提醒
+     * 搜索到的会话数量
      */
-    disableNotification: boolean;
+    matchCount?: number;
     /**
-     * 是否是状态消息
+     * 会话项变更时间戳
      */
-    isStatusMessage: boolean;
-    /**
-     * 是否支持消息扩展存储
-    */
-    canIncludeExpansion: boolean;
+    versionTime?: number;
+    unreadMentionedCount?: number;
+}
+/**
+ * @category Interface
+ */
+interface IReceivedConversationByTag extends IReceivedConversation {
+    isTopInTag: boolean;
+}
+interface IUltraGroupConversation extends IReceivedConversation {
+    channelType?: UltraGroupChannelType;
     /**
-     * 消息携带的扩展存储
+     * 第一条未读消息
     */
-    expansion: {
-        [key: string]: any;
-    } | null;
-    /**
-     * 消息接收状态
-    */
-    receivedStatus: number;
-    /**
-     * 消息本地 ID, web 端由 lib 内生成， PC 端由协议栈数据库生成自增ID
-    */
-    messageId?: number;
+    firstUnreadMessage?: IUltraUnreadMsg | null;
+}
+/**
+ * 设置会话状态 参数 信息
+*/
+interface ISetConversationStatusOptions {
+    conversationType: ConversationType;
+    targetId: string;
+    isTop?: boolean;
+    notificationStatus?: number;
+    notificationLevel?: number;
+    channelId?: string;
+}
+interface IUpdatedConversation {
+    updatedItems: {
+        [key: string]: {
+            time: number;
+            val: any;
+        };
+    };
+    conversationType: number;
+    targetId: string;
+    latestMessage?: IReceivedMessage;
+    unreadMessageCount?: number;
+    hasMentioned?: boolean;
+    mentionedInfo?: {
+        /**
+         * `@ 类型，其中 1 为 @ 所有人，2 为 @ 部分人`
+         */
+        type: 1 | 2;
+        /**
+         * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
+         */
+        userIdList: string[];
+    };
+    lastUnreadTime?: number;
+    notificationStatus?: number;
+    notificationLevel?: number;
+    isTop?: boolean;
     /**
-     * 消息发送状态， web 端由 lib 内根据消息状态设置值为 发送中、已发送和发送失败 ，PC 端由协议栈自动维护或用户自己设置
+     * 会话标识
     */
-    sentStatus?: SentStatus;
-    /**
-     * 已读回执信息(导航配置grpRRVer=1时群组类型消息内存在, 其他情况为undefined)
-     */
-    readReceiptInfo?: IReadReceiptInfo;
-    /**
-     * 推送扩展
-     */
-    pushConfig?: IPushConfig;
-    /**
-     * 超级群专有字段，是否断档，服务端收到大量消息可能会断档，所以消息存在此标志位，断档需要客户手动拉取历史消息
-     */
-    isInterrupt?: boolean;
-    /**
-     * 拉取历史消息时表示该消息是否修改过（仅超级群有效）
-     */
-    isModifyMessage?: boolean;
+    channelId?: string;
+    tags?: IUpdatedConversation[];
+    versionTime?: number;
     /**
-     * 拉取历史消息时表示该消息是否为超级群频道类型（仅超级群有效）
+     * @ 消息未读数
      */
-    channelType?: UltraGroupChannelType;
-    /**
-    * 扩展内容
-    */
-    extraContent?: string;
+    unreadMentionedCount?: number;
 }
 /**
  * @category Interface
  */
-interface IUserProfile {
-    /**
-      * 用户 ID
-      */
-    id?: string;
-    /**
-     * 用户名
-     */
-    name?: string;
-    /**
-     * 用户头像地址
-     * @deprecated
-     */
-    portraitUri?: string;
-    /**
-     * user info 中附加信息
-     */
-    extra?: string;
-    /**
-     * 用户头像地址（向移动端兼容）
-     */
-    portrait?: string;
+interface IBaseConversationInfo {
+    conversationType: ConversationType;
+    targetId: string;
+    channelId: string;
 }
-interface IOperateInfo {
+/**
+ * @category Interface
+ */
+interface IConversationState extends IBaseConversationInfo {
+    unreadCount: number;
+    unreadMentionedCount: number;
+}
+/**
+ * 指定超级群会话传参
+ * @category Interface
+ */
+interface IUltraGroupOption {
     targetId: string;
     channelId?: string;
+}
+/**
+ * @category Interface
+ */
+interface IGetUltraGroupListOption {
+    targetId?: string;
+    channelType?: UltraGroupChannelType;
+}
+/**
+ * 超级群频道变更通知内容
+ */
+interface IUltraChannelChangeInfo {
+    targetId: string;
+    channelId: string;
+    channelType: UltraGroupChannelType;
+    changeType: UltraGroupChannelChangeType;
+}
+/**
+ * 超级群私有频道用户被踢出白名单通知内容
+ */
+interface IUltraChannelUserKickedInfo {
+    targetId: string;
+    channelId: string;
+    channelType: UltraGroupChannelType;
     userId: string;
-    operationType: OperateStatus;
-    operationTime?: number;
 }
-interface IOperateSummary {
+/**
+ * 超级群频道被删除通知内容
+ */
+interface IUltraChannelDeleteInfo {
+    targetId: string;
+    channelId: string;
+    channelType: UltraGroupChannelType;
+    deleteTime: number;
+}
+/**
+ * 获取超级群获取指定会话未读 @ 消息列表
+*/
+interface IUltraUnreadConversation {
     targetId: string;
     channelId?: string;
-    count: number;
-    operationType: OperateStatus;
 }
-interface IOperateStatusNotify {
-    conversationType: ConversationType;
-    hasInfo: boolean;
-    hasSummary: boolean;
-    info: IOperateInfo[];
-    summary: IOperateSummary[];
+
+/**
+ * 拓展方法定义，便于 electron-solution 实现时保持接口类型推导可用
+ */
+interface IExtraMethod {
+    getConversationsByPage(conversationTypes: ConversationType[], sentTime: number, count: number, channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
+    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, sentTime: number, count: number, objectNames: string[], desc: 0 | 1, tag: string): Promise<IAsyncRes<{
+        list: IReceivedMessage[];
+        hasMore: boolean;
+    }>>;
+    updateMessageReceiptStatus(conersationType: ConversationType, targetId: string, timestamp: number, channelId?: string): Promise<IAsyncRes<boolean>>;
 }
-interface IRecallMsgOptions {
-    /**
-     * 会话组织机构标识
-     * 默认值未 空字符串
-    */
-    channelId: string;
-    /**
-     * 发送消息携带的用户信息
-    */
-    user?: IUserProfile;
-    /**
-     * Push 信息
-    */
-    pushContent?: string;
-    /**
-     * 原消息体
-    */
-    oriContent?: any;
-    /**
-     * 是否发送静默消息
-     * @description
-     * 当值为 `true` 时，服务器将不会发送 Push 信息，移动端也不会弹出本地通知提醒
-    */
-    disableNotification?: boolean;
+
+/**
+ * 连接协议
+ * 截止 5.7.4 版本，暂不支持 rpp 和 quic
+ * v2 版本文档： https://a5bq662kv5.feishu.cn/wiki/wikcnfo3lEo2CPbonDxuXFvU0Kb#K7nbeN
+ */
+declare enum EConnectProtocol {
+    RMTP = 1,
+    TLS = 2,
+    RPP = 3,
+    QUIC = 4,
+    WS = 5,
+    WSS = 6
+}
+interface INaviRequestOption {
+    appkey: string;
+    uri: string;
+    token: string;
+    platform: string;
+    isTcp?: boolean;
+}
+interface ICmpData {
+    addr: string;
+    protocol: EConnectProtocol;
+    weight: number;
+}
+/**
+ * 导航信息数据结构
+ */
+interface INaviInfo {
     /**
-     * 移动端推送配置
-    */
-    pushConfig?: IPushConfig;
+     * Navi 数据请求响应码，200 为成功请求
+     */
+    code: number;
     /**
-       * 其他拓展信息
-       */
-    extra?: string;
+     * 获取 Navi 数据失败时的提示信息
+     */
+    errorMessage?: string;
     /**
-     * 是否删除原始消息(在移动端会使用到)，为 true 时移动端会不显示小灰条提示
+     * 获取 Navi 数据失败时的请求 url 信息
      */
-    isDelete?: boolean;
-}
-interface IRecallMsgContent {
-    conversationType: number;
-    targetId: string;
-    sentTime: number;
-    messageUId: string;
+    url?: string;
     /**
-     * 会话组织机构标识
-     * 默认值未 空字符串
-    */
-    channelId: string;
+     * 请求导航数据时使用的协议：http / https
+     * @description 该字段为 SDK 内增加的字段，导航接口数据中不存在
+     */
+    protocol: 'http' | 'https';
     /**
-       * 其他拓展信息
-       */
-    extra?: string;
+     * 获取导航时使用的 userId，小程序不走导航，故拿不到 userId
+     */
+    userId?: string;
     /**
-     * 发送消息携带的用户信息
-    */
-    user?: IUserProfile;
+     * CMP 服务 Websocket 连接地址，包含域名与端口，不含 ws 或 wss 协议头
+     * @example a.domain.com:443
+     * @note 在 V2 版本废弃
+     */
+    server: string;
     /**
-     * 是否删除原始消息(在移动端会使用到)，为 true 时移动端会不显示小灰条提示
+     * 备用 CMP 服务地址，包含域名与端口，不含 ws 或 wss 协议头，多个备用地址以 ',' 分割
+     * @example a.domain.com:443,b.domain.com:443
+     * @note 在 V2 版本废弃
      */
-    isDelete?: boolean;
-}
-/**
- * 发送消息时的可选项信息
- */
-interface ISendMsgOptions {
+    backupServer?: string;
     /**
-     * 消息类型，即消息结构的 ObjectName
+     * 备用 CMP 服务地址，POST 请求 TCP 连接返回的是 bs 字段，非 backupServer 字段
+     * @note 在 V2 版本废弃
      */
-    messageType: string;
+    bs?: string;
     /**
-     * 消息内容
+     * RTC 服务配置，其值可能为 null、无效字符串、有效 JSON 字符串
+     * 1. 公有云未开通音视频时，值为 null
+     * 2. 私有云无配置时为 `{ "strategy": 0 }`
      */
-    content: {
-        /**
-         * 消息内容 key-value，最终会进行 JSON 序列化后发送
-         */
-        [key: string]: any;
-        /**
-         * 消息可携带的用户数据
-         */
-        user?: IUserProfile;
-        /**
-         * 其他拓展信息
-         */
-        extra?: string;
-    };
+    voipCallInfo: string | null;
     /**
-     * 是否存储
-     * @description 只在发送未注册过的自定义消息时有效，否则使用注册时的配置
+     * 聊天室 kv 存储开关
+     * @todo 需确认详细有效值
+     * @description 公有云独有配置
      */
-    isPersited?: boolean;
+    kvStorage: number;
     /**
-     * 是否计数
-     * @description 只在发送未注册过的自定义消息时有效，否则使用注册时的配置
+     * HttpDNS 功能开关，在 web 端无效
+     * @description 公有云独有配置
      */
-    isCounted?: boolean;
+    openHttpDNS: boolean;
     /**
-     * 是否是状态消息，一般为无需注册的自定义消息
+     * 历史消息云存储功能开关
      * @description
-     * 1. 状态消息只有 pub，没有 ack 应答
-     * 2. 状态消息默认不存储，不计数，`isPersited` 与 `isCounted` 配置将失效
+     * 1. 公有云通过 `developer.rongcloud.cn` 管理后台 `单群聊消息云端存储` 功能开关进行配置
+     * 2. 私有云默认为 `true`
      */
-    isStatusMessage?: boolean;
+    historyMsg: boolean;
     /**
-     * 是否发送静默消息
+     * 聊天室历史消息开关
      * @description
-     * 当值为 `true` 时，服务器将不会发送 Push 信息，移动端也不会弹出本地通知提醒
+     * 1. 私有云对聊天室功能支持有限，默认为 `false`
+     * 2. TODO: 公有云配置待确认
      */
-    disableNotification?: boolean;
+    chatroomMsg: boolean;
     /**
-     * Push 信息
+     * 文件服务器地址
+     * @description
+     * 1. 公有云下，该地址为七牛云服务器地址
+     * 2. 私有云下，该地址为私有云自研文件服务器地址
+     * @note 在 V2 版本废弃
      */
-    pushContent?: string;
+    uploadServer: string;
     /**
-     * Push 通知携带的附加信息
+     * 实时位置共享配置，web 端无需处理
      */
-    pushData?: string;
+    location: null | string;
     /**
-     * 是否为 @ 消息，只当 conversationType 值为 `ConversationType.GROUP` 时有效
+     * 实时日志上传开关
+     * @todo 需确认有效值及作用
      */
-    isMentioned?: boolean;
+    monitor: number;
     /**
-     * `@` 消息类型
-     * @description `1: @ 所有人 2: @ 指定用户`
+     * 是否允许加入多聊天室开关
      */
-    mentionedType?: 1 | 2;
+    joinMChrm: boolean;
     /**
-     * 被 @ 的用户 Id 列表，当 `mentionedType` 值为 `1` 时，该值可为空
+     * 是否开启公众号功能：`0` 为未开启，`1` 为已开启
      */
-    mentionedUserIdList?: string[];
+    openMp: 0 | 1;
     /**
-     * 用于发送群定向消息，只当 conversationType 值为 `ConversationType.GROUP` 时有效
+     * 是否开启用户级配置，若开启，需连接成功后立即拉取实时配置，0 | 1
+     * @description
+     * 配置来源:
+     * 1. 导航
+     * 2. 服务端实时下发
+     * 已有配置字段:
+     * 1. Lan. 推送使用的语言设置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 2. ShPushSwit. 推送是否显示详情设置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 3. MobPushSwit: Web/PC 在线，移动端不在线是否发送推送开关，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 4. OffMsgDur: 离线消息保存天数，设置天数不可大于App级对应配置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 5. VoipInfo: 音视频相关配置，用户端不可自定义修改. 由服务端决定，与导航下发格式一致
+     * @todo 需确认公有云与私有云区别
      */
-    directionalUserIdList?: string[];
+    openUS: 0 | 1;
     /**
-     * 当对方为 iOS 设备且未在线时，其将收到 Voip Push. 此配置对 Android 无影响
+     * 超级群功能开关,1表示开
      */
-    isVoipPush?: boolean;
+    ugMsg?: 0 | 1;
     /**
-     * 消息是否支持拓展内容
+     * 群离线消息最大下发条数，`0` 为关闭
+     * @description 公有云独有配合
      */
-    canIncludeExpansion?: boolean;
+    grpMsgLimit: number;
     /**
-     * 消息拓展内容数据
+     * 消息加密开关，0 为关闭
+     * @todo
+     * 1. 确定其控制的功能
+     * 2. 确定 web 相关性
+     * @note 在 V2 版本废弃
      */
-    expansion?: {
-        [key: string]: string;
-    };
+    isFormatted: number;
     /**
-     * 黑/白名单
-     * @todo 功能未知，需确认
+     * GIF 动图大小限制，默认 2048 KB
      */
-    isFilerWhiteBlacklist?: boolean;
-    /**
-     * 移动端推送配置
-    */
-    pushConfig?: IPushConfig;
-    /**
-     * 会话业务标识
-     * @description
-     * 20 个字符长度限制
-    */
-    channelId?: string;
+    gifSize: number;
     /**
-     * 客户端的消息标识
-     * 重发消息时用到，重发消息的消息 ID
+     * 上传小视频时长限制，单位：秒
+     * @description 公有云字段，即私有云配置中的 `uploadVideoTimeLimit`
      */
-    messageId?: number;
+    videoTimes?: number;
     /**
-     * 超级群专有字段，是否断档，若断档需要客户判断是否拉取
+     * 上传小视频时长限制，单位：秒
+     * @description 私有云字段，即公有云配置中的 `videoTimes`
      */
-    isInterrupt?: boolean;
+    uploadVideoTimeLimit?: number;
     /**
-    * 标识该消息是否为重发消息，仅 electron 中有效。
-    */
-    isResend?: boolean;
-}
-interface IInsertMsgOptions {
-    senderUserId: string;
-    messageType: string;
-    content: any;
-    messageDirection: number;
-    readStatus?: number;
-    sentStatus?: number;
-    sentTime?: number;
-    searchContent?: string;
-    isUnread?: boolean;
-    messageUId?: string;
-    disableNotification?: boolean;
-    canIncludeExpansion?: boolean;
-    expansionMsg?: string;
-    channelId: string;
-}
-interface IInsertMessage {
-    conversationType: number;
-    targetId: string;
-    channelId: string;
-    messageDirection: number;
-    messageType: string;
-    content: any;
-    messageUId: string;
-    senderUserId: string;
-    sentStatus?: number;
-    sentTime?: number;
-    disableNotification?: boolean;
-    canIncludeExpansion?: boolean;
-    expansion?: {
-        [key: string]: any;
-    } | null;
-    receivedStatus?: number;
+     * 实时日志上传开关：`0` 为关闭，`1` 为开启
+     */
+    logSwitch: number;
     /**
-     * 插入消息是否计入未读数: true 计数 false 不计数, 默认不计数
+     * 实时日志上传策略，值为 JSON 字符串
+     * @example `'{
+     * "url": "logcollection.ronghub.com", // 上传地址
+     * "level": 1,                         // 日志等级
+     * "itv": 6,                           // 上传频率，即时间间隔，单位 s
+     * "times": 5                          // 重试次数？
+     * }'`
      */
-    isUnread?: boolean;
+    logPolicy: string;
     /**
-     * 消息搜索关键字
+     * 百度 BOS 存储服务地址
+     * @description 公有云独有配置
+     * @example `gz.bcebos.com`
+     * @deprecated 已废弃
      */
-    searchContent?: string;
+    bosAddr?: string;
     /**
-     * 来源
+     * 阿里上传配置，字符串数组，数组顺序代表 七牛、百度、阿里云 上传权重
+     * @example
+     * ```
+     * `[{"qiniu":"upload.qiniup.com","p":"1"},
+     *  {"baidu":"gz.bcebos.com","p":"2"},
+     *  {"aliyun":"oss-cn-beijing.aliyuncs.com","p":"3"}]`
+     * ```
      */
-    source?: string;
-    isMentioned?: boolean;
-}
-interface ISendExMsgOptions {
-    channelId: string;
-    conversationType: ConversationType;
-    targetId: string;
+    ossConfig?: string;
     /**
-     * 消息 ID
-    */
-    messageUId: string;
+     * 私有云专有属性，可用来判断当前环境是公有云还是私有云，私有云环境下该值为 `1`
+     */
+    type?: number;
     /**
-     * 原始消息是否支持扩展的字段
-    */
-    canIncludeExpansion: boolean;
+     * @deprecated 已废弃
+     */
+    compDays: number;
     /**
-     * 删除的 keys
-    */
-    keys?: string[];
+     * @deprecated 已废弃
+     */
+    msgAck: unknown;
     /**
-     * 扩展对象
-    */
-    expansion?: {
-        [key: string]: string;
-    };
+     * @deprecated 已废弃
+     */
+    activeServer: string;
     /**
-     * 是否删除所有扩展
-    */
-    removeAll?: boolean;
+     * @deprecated 已废弃
+     */
+    qnAddr: string;
     /**
-     * 原始消息的扩展
-    */
-    originExpansion?: {
-        [key: string]: string;
-    } | null;
-}
-interface IUltraExMsgOptions {
-    canIncludeExpansion: boolean;
-    channelId: string;
-    conversationType: ConversationType;
-    targetId: string;
-    messageUId: string;
-    sendTime: number;
+     * @deprecated 已废弃
+     */
+    extkitSwitch: number;
     /**
-     * 删除的 keys
-    */
-    keys?: string[];
+     * @deprecated 已废弃
+     */
+    alone: boolean;
     /**
-      * 扩展对象
-    */
-    expansion?: {
-        [key: string]: string;
-    };
+     * @deprecated 已废弃
+     */
+    voipServer: string;
     /**
-      * 是否删除所有扩展
-    */
-    removeAll?: boolean;
-}
-interface IUltraModifyMsgOptions {
-    canIncludeExpansion?: boolean;
-    channelId: string;
-    conversationType: ConversationType;
-    targetId: string;
-    messageUId: string;
-    sendTime: number;
+     * 离线日志上报地址
+     * @deprecated 已废弃
+     */
+    offlinelogserver: string;
     /**
-     * 消息内容
+     * 在线日志上报地址
+     * @deprecated 已废弃
      */
-    content: {
-        /**
-         * 消息内容 key-value，最终会进行 JSON 序列化后发送
-         */
-        [key: string]: any;
-        /**
-         * 消息可携带的用户数据
-         */
-        user?: IUserProfile;
-        /**
-         * 其他拓展信息
-         */
-        extra?: string;
-    };
-}
-interface IUltraMsgQueryInfo {
-    sendTime: number;
-    messageUId: string;
-    channelId?: string;
-}
-interface IUltraMsgQueryOptions {
-    conversationType: ConversationType;
-    targetId: string;
-    messages: IUltraMsgQueryInfo[];
-}
-/**
- * 被拦截的消息信息
- * @category Interface
- */
-interface IBlockedMessageInfo {
-    blockedMessageUId: string;
-    conversationType: number;
-    targetId: string;
-    channelId: string;
-    blockType: MessageBlockType;
-    extra: any;
-    sourceType?: MessageBlockSourceType;
-    sourceContent?: {
-        [key: string]: any;
-    };
-}
-/**
- * 超级群获取指定会话未读 @ 消息列表参数
-*/
-interface IUltraGroupUnreadMentionedOption {
+    onlinelogserver?: string;
     /**
-     * 会话 ID
-    */
-    targetId: string;
+     * 链路加密字段，内容为 JSON 字符串，仅限 C++ 可用
+     * @note 在 V2 版本废弃
+     */
+    crypto?: string;
     /**
-     * 频道 ID
-    */
-    channelId?: string;
+     * 群组回执开关, 1: 打开，0(或者没有): 关闭
+     */
+    grpRRVer?: number;
     /**
-     * 消息的时间戳，首次获取传 0， 后续查询传未读 @ 列表中的消息时间戳
-    */
-    sentTime: number;
+     * 防黑产开关, 1: 打开，0：关闭
+     */
+    openAnti?: number;
     /**
-     * 数据个数，最大50
-    */
-    count: number;
-}
-/**
- * 超级群获取指定会话 @ 未读消息列表结果
-*/
-interface IUltraUnreadMsg {
+     * 鉴权认证
+     */
+    jwt?: string;
     /**
-     * 消息 ID
-    */
-    messageUId?: string;
+     * 数据中心
+     */
+    dc?: string;
     /**
-     * 消息时间戳
-    */
-    sentTime: number;
+     * 是否开启 tls
+     */
+    openTLS?: number;
     /**
-     * @ 类型： 1 所有人；2: 部分人
-    */
-    mentionedType?: number;
-}
-
-interface IMentionInfo {
-    type: MentionedType;
+     * V2 版本中新增字段
+     * 服务地址列表
+     */
+    serverAddr?: ICmpData[];
     /**
-     * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
+     * V2 版本中新增字段
+     * 新版本控制tag
      */
-    userIdList: string[];
+    excludeLogTag?: string;
 }
+
+declare type INaviCache = {
+    token: string;
+    naviInfo: INaviInfo;
+    timestamp: number;
+};
 /**
- * 从服务器拉取到的会话数据结构
- * @category Interface
+ * 导航数据管理类，负责管理导航有效期、导航请求、导航缓存
  */
-interface IReceivedConversation {
+declare abstract class BasicNavi {
+    protected readonly appkey: string;
+    protected readonly logger: BasicLogger;
     /**
-     * 会话的业务标识
-    */
-    channelId?: string;
+     * 业务层的自定义导航配置
+     */
+    protected readonly navigators: string[];
+    constructor(appkey: string, logger: BasicLogger, 
     /**
-     * 会话类型
+     * 业务层的自定义导航配置
      */
-    conversationType: ConversationType;
+    navigators: string[]);
     /**
-     * 会话 Id
-     * @description
-     * 1. 当 `conversationType` 为 `ConversationType.GROUP` 时，该值为群组 Id
-     * 1. 当 `conversationType` 为 `ConversationType.PRIVATE` 时，该值为对方用户 Id
+     * 当前进行中的导航请求
      */
-    targetId: string;
+    private crtRequest;
     /**
-     * 当前会话的未读消息数
+     * 请求导航数据
+     * @param token
+     * @param ignoreCache 是否忽略缓存，强制从服务器重新拉取。
+     * @param ignoreExpire 是否忽略有效期检查。理论上只需要在建立连接时需要检测 navi 有效期，其他场景无需检测
+     * @param traceId 事务日志跟踪 ID
      */
-    unreadMessageCount: number;
+    request(token: string, ignoreCache: boolean, ignoreExpire: boolean, traceId: string): IPromiseResult<INaviInfo>;
+    private sendRequest;
     /**
-     * 会话中的最后一条消息
+     * 从指定服务列表中顺序尝试获取导航
+     * @param uris 导航服务列表
+     * @param token
+     * @param traceId
      */
-    latestMessage: IReceivedMessage | null;
+    private requestHandler;
     /**
-     * 是否包含 @ 自己的消息，此数据仅在 `conversationType` 为 `ConversationType.GROUP` 时有效
+     * 向目标导航服务发送请求
+     * @param uri 导航服务地址
+     * @param appkey
+     * @param token
+     * @param version
+     * @param timeout 请求超时时间
+     * @param traceId
      */
-    hasMentioned?: boolean;
+    protected abstract httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
     /**
-     * 消息中的 @ 数据，仅在 `conversationType` 为 `ConversationType.GROUP` 时有效
+     * 向目标导航服务发送请求
+     * @param uri 导航服务地址
+     * @param appkey
+     * @param token
+     * @param version
+     * @param timeout 请求超时时间
+     * @param traceId
      */
-    mentionedInfo?: IMentionInfo | null;
+    protected abstract httpRequestV2(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
+    /**
+     * 转换 Navi 接口 HTTP 请求状态码为 ErrorCode 定义
+     * @param code
+     */
+    protected transHttpCode(code: number): ErrorCode;
     /**
-     * 会话免打扰状态
-     * @description
-     * 1. 已开启免打扰
-     * 2. 未开启免打扰
+     * 设置缓存
+     * @param formatedToken
+     * @param naviInfo
+     * @description 设置缓存的同时会检测缓存中的既有数据，适当清理，避免无效数据长时间占用存储空间
      */
-    notificationStatus: NotificationStatus;
-    notificationLevel?: NotificationLevel;
+    protected abstract setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
     /**
-     * 会话是否已置顶
+     * 获取缓存数据
+     * @param formatedToken
      */
-    isTop: boolean;
+    protected abstract getNaviCache(formatedToken: string): INaviCache | null;
     /**
-     * 会话中消息的最后未读时间
+     * 获取缓存的导航信息
+     * @param token
      */
-    lastUnreadTime: number;
+    getNaviInfoFromCache(token: string): INaviInfo | null;
     /**
-     * 搜索到的会话数量
+     * RTC 配置变更，更新 navi 缓存
+     * @param token
+     * @param voipCallInfo
      */
-    matchCount?: number;
+    updateVoipCallInfo(token: string, voipCallInfo: string): void;
+    protected getNaviV2RequestOption(option: INaviRequestOption): IRequest;
     /**
-     * 会话项变更时间戳
+     * 是否使用 v2 版本导航
+     * 仅私有云 rcx 使用 v1 版本
      */
-    versionTime?: number;
-    unreadMentionedCount?: number;
+    useV2Navi(): boolean;
 }
+
 /**
- * @category Interface
+ * Websocket 导航工具类
  */
-interface IReceivedConversationByTag extends IReceivedConversation {
-    isTopInTag: boolean;
-}
-interface IUltraGroupConversation extends IReceivedConversation {
-    channelType?: UltraGroupChannelType;
-    /**
-     * 第一条未读消息
-    */
-    firstUnreadMessage?: IUltraUnreadMsg | null;
-}
-/**
- * 设置会话状态 参数 信息
-*/
-interface ISetConversationStatusOptions {
-    conversationType: ConversationType;
-    targetId: string;
-    isTop?: boolean;
-    notificationStatus?: number;
-    notificationLevel?: number;
-    channelId?: string;
-}
-interface IUpdatedConversation {
-    updatedItems: {
-        [key: string]: {
-            time: number;
-            val: any;
-        };
-    };
-    conversationType: number;
-    targetId: string;
-    latestMessage?: IReceivedMessage;
-    unreadMessageCount?: number;
-    hasMentioned?: boolean;
-    mentionedInfo?: {
-        /**
-         * `@ 类型，其中 1 为 @ 所有人，2 为 @ 部分人`
-         */
-        type: 1 | 2;
-        /**
-         * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
-         */
-        userIdList: string[];
-    };
-    lastUnreadTime?: number;
-    notificationStatus?: number;
-    notificationLevel?: number;
-    isTop?: boolean;
+declare class WebSocketNavi extends BasicNavi {
+    private runtime;
     /**
-     * 会话标识
-    */
-    channelId?: string;
-    tags?: IUpdatedConversation[];
-    versionTime?: number;
+     * 小程序平台服务地址，多个地址以 ',' 分割
+     */
+    private readonly miniCmpUris;
+    constructor(appkey: string, logger: BasicLogger, runtime: IRuntime, 
     /**
-     * @ 消息未读数
+     * 小程序平台服务地址，多个地址以 ',' 分割
      */
-    unreadMentionedCount?: number;
-}
-/**
- * @category Interface
- */
-interface IBaseConversationInfo {
-    conversationType: ConversationType;
-    targetId: string;
-    channelId: string;
-}
-/**
- * @category Interface
- */
-interface IConversationState extends IBaseConversationInfo {
-    unreadCount: number;
-    unreadMentionedCount: number;
-}
-/**
- * 指定超级群会话传参
- * @category Interface
- */
-interface IUltraGroupOption {
-    targetId: string;
-    channelId?: string;
-}
-/**
- * @category Interface
- */
-interface IGetUltraGroupListOption {
-    targetId?: string;
-    channelType?: UltraGroupChannelType;
-}
-/**
- * 超级群频道变更通知内容
- */
-interface IUltraChannelChangeInfo {
-    targetId: string;
-    channelId: string;
-    channelType: UltraGroupChannelType;
-    changeType: UltraGroupChannelChangeType;
-}
-/**
- * 超级群私有频道用户被踢出白名单通知内容
- */
-interface IUltraChannelUserKickedInfo {
-    targetId: string;
-    channelId: string;
-    channelType: UltraGroupChannelType;
-    userId: string;
-}
-/**
- * 超级群频道被删除通知内容
- */
-interface IUltraChannelDeleteInfo {
-    targetId: string;
-    channelId: string;
-    channelType: UltraGroupChannelType;
-    deleteTime: number;
-}
-/**
- * 获取超级群获取指定会话未读 @ 消息列表
-*/
-interface IUltraUnreadConversation {
-    targetId: string;
-    channelId?: string;
+    miniCmpUris: string[], navigators?: string[]);
+    protected httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
+    protected httpRequestV2(uri: string, appkey: string, token: string, traceId: string): IPromiseResult<INaviInfo>;
+    protected getNaviCache(formatedToken: string): INaviCache | null;
+    protected setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
 }
 
 /**
  * @category Interface
  */
-interface IChatroomEntryListenerData {
+interface IUploadAuth {
     /**
-     * 更新的键
+     * 七牛 token 有效期
     */
-    key: string;
+    deadline: number;
     /**
-     * 更新的值
+     * 七牛上传 token
     */
-    value: string;
+    token: string;
     /**
-     * 更新的时间
+     * 百度上传 token
     */
-    timestamp: number;
+    bosToken: string;
     /**
-     * 更新的聊天室 ID
+     * 百度上传 header Date
     */
-    chatroomId: string;
+    bosDate: string;
     /**
-     * 更新类型
+     * 百度上传路径
     */
-    type: ChatroomEntryType;
-}
-/**
- * @category Interface
- */
-interface IChatroomRejoinedFailed {
+    path: string;
     /**
-     * 自动重新加入的聊天室 ID
-    */
-    chatroomId: string;
+     * 上传文件名，阿里上传获取下载地址时，必须使用上传文件名，所以需抛出到业务端
+     */
+    fileName: string;
     /**
-     * 自动重新加入失败的 code
-    */
-    errorCode: number;
-}
-/**
- * @category Interface
- */
-interface IChatroomRejoinedSuccessed {
+     * 阿里云 oss 的 AccessKeyId
+     */
+    osskeyId: string;
     /**
-     * 自动重新加入的聊天室 ID
-    */
-    chatroomId: string;
+     * 阿里云 oss post 请求表单域中的字段 policy
+     */
+    ossPolicy: string;
     /**
-     * 自动重新加入的聊天室拉取消息的数量
-    */
-    count: number;
-}
-/**
- * @category Interface
- */
-interface IChatroomUserChangeInfo {
-    users: {
-        [userId: string]: ChatroomUserChangeType;
-    };
-    chatroomId: string;
-}
-declare type IChatroomRejoinedInfo = IChatroomRejoinedFailed | IChatroomRejoinedSuccessed;
-/**
- * 聊天室信息
- * @category Interface
-*/
-interface IChatroomListenerData {
+     * 阿里云 oss 根据 policy 计算的签名信息
+     */
+    ossSign: string;
+    /**
+     * 阿里云 oss 存储空间名称
+     */
+    ossBucketName: string;
+    /**
+     * s3 认证凭证，对应 post上传 x-amz-credential 字段
+     */
+    s3Credential: string;
+    /**
+     * 加密算法，对应 post上传 x-amz-algorithm 字段
+     */
+    s3Algorithm: string;
+    /**
+     * s3 日期，对应 post上传 x-amz-date 字段
+     */
+    s3Date: string;
     /**
-     * SDK 内部重连聊天室信息
-    */
-    rejoinedRoom?: IChatroomRejoinedInfo;
+     * s3 policy，对应 post上传 policy 字段
+     */
+    s3Policy: string;
     /**
-     * 监听到的聊天室 KV 更新
-    */
-    updatedEntries?: IChatroomEntryListenerData[];
+     * s3 签名信息，对应 post上传 x-amz-signature 字段
+     */
+    s3Signature: string;
     /**
-     * 登录退出的用户通知
+     * s3 存储空间名称
      */
-    userChange?: IChatroomUserChangeInfo;
+    s3BucketName: string;
     /**
-     * 聊天室销毁
+     * stc  Authorization 头
      */
-    chatroomDestroyed?: string;
+    stcAuthorization: string;
+    /**
+     * stc  xAmzContentSha256
+     */
+    stcContentSha256: string;
+    /**
+     * stc date
+     */
+    stcDate: string;
+    /**
+     * stc 存储空间名称
+     */
+    stcBucketName: string;
 }
+
 /**
- * @category Interface
+ * 当前运行时设备信息
  */
-interface IChatroomEntry {
+interface IOSInfo {
+    /** 软件运行时的 CPU 架构信息 */
+    arch: string;
+    /** 平台标识 */
+    platform: string;
+    /** 操作系统名称 */
+    type: string;
+    /** 操作系统 release 标识 */
+    release: string;
+    /** 操作系统版本信息 */
+    version: string;
+    /** 内存余量 */
+    freemem: number;
+    /** 系统内存总量 */
+    totalmem: number;
+    /** 本次操作系统运行时长 */
+    uptime: number;
+    cpus: {
+        /** CPU 型号标识 */
+        model: string;
+        /** 主频 MHz */
+        speed: number;
+        times: {
+            user: number;
+            nice: number;
+            sys: number;
+            idle: number;
+            irq: number;
+        };
+    }[];
+    networkInterfaces: {
+        /** 网卡接口标识 */
+        [link: string]: {
+            /** IP */
+            address: string;
+            /** 子网掩码 */
+            netmask: string;
+            /** IP 协议版本 */
+            family: string;
+            /** Mac Address */
+            mac: string;
+            /** 是否回环地址 */
+            internal: boolean;
+            /** CIDR */
+            cidr: string | null;
+        }[] | undefined;
+    };
+}
+
+interface IProcessInfo {
+    title: string;
+    platform: string;
+    arch: string;
+    pid: number;
+    ppid: number;
+    uptime: number;
+    cpuUsage: {
+        user: number;
+        system: number;
+    };
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+        arrayBuffers: number;
+    };
+    resourceUsage: {
+        userCPUTime: number;
+        systemCPUTime: number;
+        maxRSS: number;
+        sharedMemorySize: number;
+        unsharedDataSize: number;
+        unsharedStackSize: number;
+        minorPageFault: number;
+        majorPageFault: number;
+        swappedOut: number;
+        fsRead: number;
+        fsWrite: number;
+        ipcSent: number;
+        ipcReceived: number;
+        signalsCount: number;
+        voluntaryContextSwitches: number;
+        involuntaryContextSwitches: number;
+    };
+}
+
+/**
+ * 代理信息
+ */
+interface IProxy {
+    socksHost: string;
+    socksPort: number;
+    socksUsername?: string;
+    socksPassword?: string;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST"
+}
+interface IRequest {
+    url: string;
     /**
-     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * @default `HttpMethod.GET`
      */
-    key: string;
+    method?: HttpMethod | 'GET' | 'POST';
     /**
-     * 属性对应的值, 最大长度 4096 字符
+     * 查询数据
      */
-    value: string;
+    query?: {
+        [key: string]: string | number | null;
+    };
     /**
-     * 设置成功后是否发送通知消息
+     * Request Header 信息
      */
-    isSendNotification?: boolean;
+    headers?: {
+        [key: string]: string;
+    };
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * Request Body 数据
      */
-    notificationExtra?: string;
+    body?: Object | string;
     /**
-     * 用户退出聊天室时是否清除此属性
+     * 超时设置，默认 `60s`
      */
-    isAutoDelete?: boolean;
-}
-/**
- * @category Interface
- */
-interface IChatroomUser {
+    timeout?: number;
     /**
-     * 用户 id
+     * 【Alipay-Only】
+     * 期望返回的数据格式，如果为 json 则返回后会对返回的数据进行一次 JSON.parse
      */
-    id: string;
+    dataType?: 'json' | 'text' | 'base64' | 'arraybuffer';
     /**
-     * 加入聊天室的时间
+     * socks5 代理参数，仅 Electron 平台有效，web 平台默认为 null
      */
-    time: number;
+    proxy?: IProxy | null;
+}
+interface IStorage {
+    setItem(key: string, value: string): void;
+    getItem(key: string): string | null;
+    removeItem(key: string): void;
+    clear(): void;
+}
+interface IResponse {
+    status: number;
+    data?: string;
 }
 /**
- * @category Interface
+ * 网络状态枚举
  */
-interface IChatroomInfo {
+declare enum NetworkType {
+    WIFI = "wifi",
+    FOUR_G = "4g",
+    THREE_G = "3g",
+    TWO_G = "2g",
+    FIVE_G = "2g",
+    THREE_GENT = "3gnet",
+    UNKONWN = "unknown"
+}
+interface IWebSocket {
+    id: number;
     /**
-     * 成员列表
-     * @todo 需确认数组元素的数据结构
+     * 监听连接建立事件，此时 WebSocket 实例已准备好收发数据
+     * @param callback
      */
-    userInfos: IChatroomUser[];
+    onOpen(callback: () => void): void;
     /**
-     * 房间内总人数
+     * 监听连接关闭事件
+     * @param callback
      */
-    userCount: number;
-}
-/**
- * @category Interface
- */
-interface IRemoveChatroomEntry {
+    onClose(callback: (code?: number, reason?: string) => void): void;
     /**
-     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * 监听接收服务器消息事件
+     * @param callback
      */
-    key: string;
+    onMessage(callback: (data: string | ArrayBuffer) => void): void;
     /**
-     * 删除成功后是否发送通知消息
+     * 监听链接错误事件
+     * @param callback
      */
-    isSendNotification?: boolean;
+    onError(callback: (error: unknown) => void): void;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * 向服务器发送数据
+     * @param data
      */
-    notificationExtra?: string;
+    send(data: ArrayBuffer | string): void;
+    /**
+     * 关闭连接
+     * @param code
+     * @param reason
+     */
+    close(code?: number, reason?: string): void;
 }
 /**
- * @category Interface
+ * 平台运行时抽象
  */
-interface IRemoveChatroomEntries {
+interface IRuntime {
     /**
-     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * 平台标识
      */
-    entries: {
-        key: string;
-    }[];
+    tag: string;
     /**
-     * 删除成功后是否发送通知消息
+     * 发送 http 请求
+     * @param options
+     */
+    httpReq(options: IRequest): Promise<IResponse>;
+    /**
+     * 是否使用导航
      */
+    useNavi: boolean;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * websocket 地址上附加的平台字段
      */
-    notificationExtra?: string;
-}
-/**
- * @category Interface
- */
-interface IChatroomEntries {
+    connectPlatform: string;
     /**
-     * entries ,要设置的属性列表
-     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
-     * value 属性对应的值, 最大长度 4096 字符
+     * websocket 地址上 apiVer 字段，代表代码是否来源于 uniapp
      */
-    entries: {
-        key: string;
-        value: string;
-    }[];
+    isFromUniapp: boolean;
     /**
-     * 设置成功后是否发送通知消息
+     * 创建长连接实例
      */
+    createWebSocket(url: string, protocols?: string[]): IWebSocket;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * 存储模块
      */
-    notificationExtra?: string;
+    localStorage: IStorage;
     /**
-     * 用户退出聊天室时是否清除此属性
+     * 在某些非浏览器平台，其等同于 localStorage
      */
-    isAutoDelete?: boolean;
+    sessionStorage: IStorage;
     /**
-     * 是否强制覆盖
+     * 获取网络状态
+     * 2g 3g 4g wifi unkown
      */
-    isForce?: boolean;
+    getNetworkType(): Promise<NetworkType>;
 }
 
 /**
- * @category Interface
+ * 连接状态定义枚举值
  */
-interface IUploadAuth {
-    /**
-     * 七牛 token 有效期
-    */
-    deadline: number;
-    /**
-     * 七牛上传 token
-    */
-    token: string;
-    /**
-     * 百度上传 token
-    */
-    bosToken: string;
-    /**
-     * 百度上传 header Date
-    */
-    bosDate: string;
-    /**
-     * 百度上传路径
-    */
-    path: string;
+declare enum RCConnectionStatus {
     /**
-     * 上传文件名，阿里上传获取下载地址时，必须使用上传文件名，所以需抛出到业务端
+     * 已连接
      */
-    fileName: string;
+    CONNECTED = 0,
     /**
-     * 阿里云 oss 的 AccessKeyId
+     * 连接中
      */
-    osskeyId: string;
+    CONNECTING = 1,
     /**
-     * 阿里云 oss post 请求表单域中的字段 policy
+     * 无连接，或已断开
      */
-    ossPolicy: string;
+    DISCONNECTED = 2,
     /**
-     * 阿里云 oss 根据 policy 计算的签名信息
+     * 连接暂停状态，SDK 内部 5s 后会自动尝试重连
      */
-    ossSign: string;
+    SUSPENDED = 3
+}
+interface IConnectionListener {
     /**
-     * 阿里云 oss 存储空间名称
+     * 连接成功
      */
-    ossBucketName: string;
+    onConnected(): void;
     /**
-     * s3 认证凭证，对应 post上传 x-amz-credential 字段
+     * 连接中止，SDK 内部会进行重连
+     * @param code 中止原因
      */
-    s3Credential: string;
+    onSuspend(code: ErrorCode): void;
     /**
-     * 加密算法，对应 post上传 x-amz-algorithm 字段
+     * 连接中
      */
-    s3Algorithm: string;
+    onConnecting(): void;
     /**
-     * s3 日期，对应 post上传 x-amz-date 字段
+     * 连接已终止
+     * @param code 连接终止原因
      */
-    s3Date: string;
+    onDisconnected(code: ErrorCode): void;
+}
+/**
+ * 抽象连接管理器类，负责 engine 层的连接状态维持，和对外的连接状态通知
+ */
+declare abstract class AConnectionMgr {
+    protected readonly appkey: string;
+    private navi;
+    protected logger: BasicLogger;
+    private listener;
+    constructor(appkey: string, navi: BasicNavi, logger: BasicLogger, listener: IConnectionListener);
     /**
-     * s3 policy，对应 post上传 policy 字段
+     * 当前连接所用 token
      */
-    s3Policy: string;
+    private token;
     /**
-     * s3 签名信息，对应 post上传 x-amz-signature 字段
+     * 获取当前连接中使用的 token
+     * @returns
      */
-    s3Signature: string;
+    getToken(): string;
+    private reconnectKick;
     /**
-     * s3 存储空间名称
+     * 当前连接状态
      */
-    s3BucketName: string;
+    private _crtConnectionStatus;
     /**
-     * stc  Authorization 头
+     * 当前用户 ID
      */
-    stcAuthorization: string;
+    protected _crtUserId: string;
     /**
-     * stc  xAmzContentSha256
+     * 获取当前用户 ID
+     * @returns
      */
-    stcContentSha256: string;
+    getCurrentUserId(): string;
     /**
-     * stc date
+     * 缓存的 cmp 权重
+     * disconnect 时重置
      */
-    stcDate: string;
+    private cmpWeightCache?;
     /**
-     * stc 存储空间名称
+     * 修改连接状态
+     * @param status
+     * @param code
      */
-    stcBucketName: string;
-}
-
-interface IRTCRoomInfo {
-    roomId: string;
-    roomData: unknown[];
-    userCount: number;
-    list: unknown[];
-}
-interface IRtcTokenData {
-    rtcToken: string;
-}
-interface IRTCUsers {
-    users: {
-        [userId: string]: {
-            /**
-             * 发布的资源数据，是一个 JSON 字符串，解析后为发布的资源列表
-             */
-            uris?: string;
-            /**
-             * 加房间的身份标识，保存主房间 roomId
-             */
-            extra?: string;
-        };
-    };
-}
-interface IJoinRTCRoomData extends IRTCUsers {
-    token: string;
-    sessionId: string;
-    roomInfo: {
-        key: string;
-        value: string;
-    }[];
-    kvEntries: IServerRTCRoomEntry[];
-    offlineKickTime: number;
-}
-interface KVString {
-    [key: string]: string;
-}
-/**
- * 设置 RTC 人员 inner、outer 数据
- */
-interface IRTCUserData {
-    [key: string]: string;
-}
-
-/**
- * @category Interface
- */
-interface IAsyncRes<T = void> {
+    private setConnectionStatus;
     /**
-     * Promise 执行结果
+     * 获取当前连接状态
+     * @returns
      */
-    code: ErrorCode;
+    getConnectionStatus(): RCConnectionStatus;
     /**
-     * 结果数据
+     * 建立连接
+     * @param token
+     * @param reconnectKickEnable 设置断线重连时是否踢出当前正在重连的设备 (仅 Electron 环境有效)
+     *  同一个账号在一台新设备上登录的时候，会把这个账号在之前登录的设备上踢出。
+     *  由于 SDK 有断线重连功能，存在下面情况。
+     *  用户在 A 设备登录，A 设备网络不稳定，没有连接成功，SDK 启动重连机制。
+     *  用户此时又在 B 设备登录，B 设备连接成功。
+     *  A 设备网络稳定之后，用户在 A 设备连接成功，B 设备被踢出。
+     *  这个字段就是为这种情况加的。
+     *  设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
      */
-    data?: T;
+    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
     /**
-     * 错误消息
+     * 执行中的连接事务
      */
-    msg?: string;
-}
-/**
- * 异步任务结果定义
- * @description
- * 通过 `Promise.resolve` 来处理预期内的异常，进而通过 Uncatch Promise Error 暴露预期外的异常
- */
-declare type IPromiseResult<T = void> = Promise<IAsyncRes<T>>;
-interface IConnectResult {
+    private _crtConnectionTask;
     /**
-     * 连接错误码
+     * 尝试建立连接
+     * @param token
+     * @param reconnectKickEnable
+     * @param ignoreNaviCache
+     * @param traceId
+     * @description 函数会检测当前是否有进行中的连接任务，若存在，则直接返回当前连接任务
      */
-    code: ErrorCode;
+    private try2Connect;
     /**
-     * 导航获取成功后即可有相应的值，在导航数据获取完成之前该值为 undefined
+     * 创建连接任务
+     * @param token
+     * @param reconnectKickEnable
+     * @param ignoreNaviCache
+     * @param traceId
+     * @returns
      */
-    userId?: string;
-}
-
-/**
- * 代理信息
- */
-interface IProxy {
-    socksHost: string;
-    socksPort: number;
-    socksUsername?: string;
-    socksPassword?: string;
-}
-
-declare enum HttpMethod {
-    GET = "GET",
-    POST = "POST"
-}
-interface IRequest {
-    url: string;
+    private createConnectionTask;
+    private reconnectTimer;
     /**
-     * @default `HttpMethod.GET`
+     * 尝试重连
+     * @param ignoreNaviCache 是否忽略 navi 缓存以重新请求 navi
      */
-    method?: HttpMethod | 'GET' | 'POST';
+    private try2Reconnect;
     /**
-     * 查询数据
+     * 服务器主动断开时由子类调用，函数将根据 reason 确定是否尝试重连
+     * @param reason
      */
-    query?: {
-        [key: string]: string | number | null;
-    };
+    protected onDisconnectByServer(code: ErrorCode): void;
     /**
-     * Request Header 信息
+     * Socket 异常中断时由子类调用，SDK 尝试恢复重连
      */
-    headers?: {
-        [key: string]: string;
-    };
+    protected onDisconenctUnusual(code: ErrorCode): void;
     /**
-     * Request Body 数据
+     * 建立 Socket 连接，由子类集成实现
+     * @param token
+     * @param naviInfo
+     * @param reconnectKickEnable
+     * @param traceId
      */
-    body?: Object | string;
+    protected abstract connectWithToken(token: string, naviInfo: INaviInfo, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
     /**
-     * 超时设置，默认 `60s`
+     * 当前累计心跳超时次数
      */
-    timeout?: number;
+    private _failedCount;
     /**
-     * 【Alipay-Only】
-     * 期望返回的数据格式，如果为 json 则返回后会对返回的数据进行一次 JSON.parse
+     * 允许连续 PING 超时次数，超出指定次数后会主动关闭 socket 并重新连接
      */
-    dataType?: 'json' | 'text' | 'base64' | 'arraybuffer';
+    private readonly ALLOW_FAILED_TIMES;
     /**
-     * socks5 代理参数，仅 Electron 平台有效，web 平台默认为 null
+     * 启动心跳计时器
      */
-    proxy?: IProxy | null;
-}
-interface IStorage {
-    setItem(key: string, value: string): void;
-    getItem(key: string): string | null;
-    removeItem(key: string): void;
-    clear(): void;
-}
-interface IResponse {
-    status: number;
-    data?: string;
-}
-/**
- * 网络状态枚举
- */
-declare enum NetworkType {
-    WIFI = "wifi",
-    FOUR_G = "4g",
-    THREE_G = "3g",
-    TWO_G = "2g",
-    FIVE_G = "2g",
-    THREE_GENT = "3gnet",
-    UNKONWN = "unknown"
-}
-interface IWebSocket {
-    id: number;
+    private checkAlive;
     /**
-     * 监听连接建立事件，此时 WebSocket 实例已准备好收发数据
-     * @param callback
+     * 关闭连接
+     * @param inReconnect
      */
-    onOpen(callback: () => void): void;
+    protected abstract close(inReconnect: boolean, closeDB?: boolean): void;
     /**
-     * 监听连接关闭事件
-     * @param callback
+     * 完成一次 ping 过程，并返回响应状态码
+     * @param timeout 超时时间
      */
-    onClose(callback: (code?: number, reason?: string) => void): void;
+    protected abstract sendPing(timeout: number): Promise<ErrorCode>;
     /**
-     * 监听接收服务器消息事件
-     * @param callback
+     * 业务层主动断开连接时调用
      */
-    onMessage(callback: (data: string | ArrayBuffer) => void): void;
+    disconnect(closeDB?: boolean): Promise<void>;
     /**
-     * 监听链接错误事件
-     * @param callback
+     * 清理重连计时器
      */
-    onError(callback: (error: unknown) => void): void;
+    private stopReconnectTimer;
     /**
-     * 向服务器发送数据
-     * @param data
+     * 获取 CMP 列表
      */
-    send(data: ArrayBuffer | string): void;
+    protected getCmpList(navi: INaviInfo, isTcp?: boolean): ICmpData[];
     /**
-     * 关闭连接
-     * @param code
-     * @param reason
+     * 修改 CMP 权重
      */
-    close(code?: number, reason?: string): void;
+    protected updateCmpWeight(cmpUrl: string, isRise?: boolean): void;
+    private clearCmpWeightCache;
 }
+
 /**
- * 平台运行时抽象
+ * 查询错误码是否为服务下发的 disconnect 通知 status 所转换
+ * @param code
+ * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
  */
-interface IRuntime {
+declare const isDisconnectCode: (code: ErrorCode) => boolean;
+/**
+ * 查询错误码是否为服务下发的 connAck status 所转换
+ * @param code
+ * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
+ */
+declare const isConnnectAckCode: (code: ErrorCode) => boolean;
+
+/**
+ * 进程内缓存数据
+ */
+interface IProcessCache {
+    crtUserId: string;
+    connectedTime: number;
+    naviInfo: INaviInfo | null;
+    connectionStatus: RCConnectionStatus;
+    deviceId: string;
+}
+/**
+ * meeting 信令
+ */
+declare enum MeetingEventType {
+    meetingData = 1,
+    meetingState = 2,
+    meetingUserState = 3,
+    meetingResourceState = 4,
+    rtcNackSeqId = 5
+}
+/**
+ * 约束主进程 CppEngine 与 CppService 间的方法定义，以便于代码检查
+ */
+interface IEngine {
     /**
-     * 平台标识
+     * 注册本渲染进程至主进程，以接收主进程的消息通知，同时同步主进程的当前缓存数据
      */
-    tag: string;
+    getMainProcessCache(): IProcessCache;
     /**
-     * 发送 http 请求
-     * @param options
+     * 建立连接
+     * @param token
+     * @param reconnectKickEnable
      */
-    httpReq(options: IRequest): Promise<IResponse>;
+    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
+    getNaviInfoFromCache(): INaviInfo | null;
     /**
-     * 是否使用导航
+     * 上报版本信息
+     * @param version
      */
-    useNavi: boolean;
+    reportSDKInfo(version: {
+        [name: string]: string;
+    }): void;
     /**
-     * websocket 地址上附加的平台字段
+     * 连接时间
      */
-    connectPlatform: string;
+    getConnectedTime(): number;
     /**
-     * websocket 地址上 apiVer 字段，代表代码是否来源于 uniapp
+     * 调用非标准方法。所谓非标准方法，是为某些特定需求或产品添加，暂未作为标准接口添加至 API 层。
+     * 对于未实现的方法，接口响应 Unsupport 错误码
+     * @param method
+     * @param args
      */
-    isFromUniapp: boolean;
+    callExtra(method: string | keyof IExtraMethod, ...args: any[]): Promise<IAsyncRes<unknown>>;
     /**
-     * 创建长连接实例
+     * 获取历史消息
+     * @param conversationType
+     * @param targetId
+     * @param timestamp
+     * @param count
+     * @param order
      */
-    createWebSocket(url: string, protocols?: string[]): IWebSocket;
+    getHistoryMessage(conversationType: ConversationType, targetId: string, 
     /**
-     * 存储模块
+     * 拉取时间戳，值为 `0` 表示从当前时间拉取
      */
-    localStorage: IStorage;
+    timestamp: number, 
     /**
-     * 在某些非浏览器平台，其等同于 localStorage
+     * 获取条数, 有效值 `1` - `20`
      */
-    sessionStorage: IStorage;
+    count: number, 
     /**
-     * 获取网络状态
-     * 2g 3g 4g wifi unkown
+     * @description
+     * 1. `0` 表示升序，获取消息发送时间比传入 `sentTime` 小 的消息
+     * 2. `1` 表示降序，获取消息发送时间比传入 `sentTime` 大 的消息
      */
-    getNetworkType(): Promise<NetworkType>;
-}
-
-/**
- * 拓展方法定义，便于 electron-solution 实现时保持接口类型推导可用
- */
-interface IExtraMethod {
-    getConversationsByPage(conversationTypes: ConversationType[], sentTime: number, count: number, channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
-    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, sentTime: number, count: number, objectNames: string[], desc: 0 | 1, tag: string): Promise<IAsyncRes<{
+    order: 0 | 1, 
+    /**
+     * 会话的业务标识
+     */
+    channelId: string, 
+    /**
+     * 消息类型
+     */
+    objectName: string): IPromiseResult<{
+        list: IReceivedMessage[];
+        hasMore: boolean;
+    }>;
+    /**
+     * 获取指定消息类型的历史消息
+     */
+    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, timestamp: number, count: number, messageTypes: string[], order: number, channelId: string): Promise<IAsyncRes<{
         list: IReceivedMessage[];
         hasMore: boolean;
     }>>;
-    updateMessageReceiptStatus(conersationType: ConversationType, targetId: string, timestamp: number, channelId?: string): Promise<IAsyncRes<boolean>>;
-}
-
-/**
- * 连接协议
- * 截止 5.7.4 版本，暂不支持 rpp 和 quic
- * v2 版本文档： https://a5bq662kv5.feishu.cn/wiki/wikcnfo3lEo2CPbonDxuXFvU0Kb#K7nbeN
- */
-declare enum EConnectProtocol {
-    RMTP = 1,
-    TLS = 2,
-    RPP = 3,
-    QUIC = 4,
-    WS = 5,
-    WSS = 6
-}
-interface INaviRequestOption {
-    appkey: string;
-    uri: string;
-    token: string;
-    platform: string;
-    isTcp?: boolean;
-}
-interface ICmpData {
-    addr: string;
-    protocol: EConnectProtocol;
-    weight: number;
-}
-/**
- * 导航信息数据结构
- */
-interface INaviInfo {
     /**
-     * Navi 数据请求响应码，200 为成功请求
+     * 删除历史消息 通过 messageUId
      */
-    code: number;
+    deleteRemoteMessage(conversationType: ConversationType, targetId: string, 
     /**
-     * 获取 Navi 数据失败时的提示信息
+     * @description
+     * message 中 messageUId、setTime、messageDirection 为必须参数
+     */
+    messages: {
+        messageUId: string;
+        sentTime: number;
+        messageDirection: MessageDirection;
+    }[], 
+    /**
+     * 会话的业务标识
+     */
+    channelId: string): Promise<ErrorCode>;
+    recallMsg(conversationType: ConversationType, targetId: string, messageUId: string, sentTime: number, recallMsgOptions: IRecallMsgOptions): IPromiseResult<IReceivedMessage>;
+    /**
+     * 删除历史消息 通过 时间戳
+     * @param timestamp 小于等于传入时间戳的消息均删除
      */
-    errorMessage?: string;
+    deleteRemoteMessageByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, 
     /**
-     * 获取 Navi 数据失败时的请求 url 信息
+     * 会话的业务标识
      */
-    url?: string;
+    channelId: string): Promise<ErrorCode>;
     /**
-     * 请求导航数据时使用的协议：http / https
-     * @description 该字段为 SDK 内增加的字段，导航接口数据中不存在
+     * 获取会话列表
+     * @param count 指定获取数量, 不传则获取全部会话列表，默认 `300`
      */
-    protocol: 'http' | 'https';
+    getConversationList(
     /**
-     * 获取导航时使用的 userId，小程序不走导航，故拿不到 userId
+     * 拉取数量, 有效值 0 - 1000, 默认 300
      */
-    userId?: string;
+    count: number, 
     /**
-     * CMP 服务 Websocket 连接地址，包含域名与端口，不含 ws 或 wss 协议头
-     * @example a.domain.com:443
-     * @note 在 V2 版本废弃
+     * 会话类型
+     * @todo 待确认是否生效
      */
-    server: string;
+    conversationType?: ConversationType, 
     /**
-     * 备用 CMP 服务地址，包含域名与端口，不含 ws 或 wss 协议头，多个备用地址以 ',' 分割
-     * @example a.domain.com:443,b.domain.com:443
-     * @note 在 V2 版本废弃
+     * 起始时间
      */
-    backupServer?: string;
+    startTime?: number, 
     /**
-     * 备用 CMP 服务地址，POST 请求 TCP 连接返回的是 bs 字段，非 backupServer 字段
-     * @note 在 V2 版本废弃
+     * 获取顺序
      */
-    bs?: string;
+    order?: 0 | 1, 
     /**
-     * RTC 服务配置，其值可能为 null、无效字符串、有效 JSON 字符串
-     * 1. 公有云未开通音视频时，值为 null
-     * 2. 私有云无配置时为 `{ "strategy": 0 }`
+     * 会话的业务标识
      */
-    voipCallInfo: string | null;
+    channelId?: string): IPromiseResult<IReceivedConversation[]>;
     /**
-     * 聊天室 kv 存储开关
-     * @todo 需确认详细有效值
-     * @description 公有云独有配置
+     * 分页获取会话列表，仅 electron中使用
      */
-    kvStorage: number;
+    getConversationsByPage(conversationTypes: ConversationType[], startTime: number, count: number, channelId: string): IPromiseResult<IReceivedConversation[]>;
     /**
-     * HttpDNS 功能开关，在 web 端无效
-     * @description 公有云独有配置
+     * 获取指定会话
      */
-    openHttpDNS: boolean;
+    getConversation(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedConversation | null>;
     /**
-     * 历史消息云存储功能开关
-     * @description
-     * 1. 公有云通过 `developer.rongcloud.cn` 管理后台 `单群聊消息云端存储` 功能开关进行配置
-     * 2. 私有云默认为 `true`
+     * 获取未读会话列表
      */
-    historyMsg: boolean;
+    getUnreadConversationList(conversationTypes: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
     /**
-     * 聊天室历史消息开关
-     * @description
-     * 1. 私有云对聊天室功能支持有限，默认为 `false`
-     * 2. TODO: 公有云配置待确认
+     * 删除会话
+     * @description 该删除操作会删除服务器端存储的会话数据
+     * @param conversationType
+     * @param targetId
      */
-    chatroomMsg: boolean;
+    removeConversation(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
     /**
-     * 文件服务器地址
-     * @description
-     * 1. 公有云下，该地址为七牛云服务器地址
-     * 2. 私有云下，该地址为私有云自研文件服务器地址
-     * @note 在 V2 版本废弃
+     * 获取所有会话未读数
+     * @param channelId 多组织 Id
+     * @param conversationTypes
+     * @param includeMuted 包含已设置免打扰的会话
      */
-    uploadServer: string;
+    getAllConversationUnreadCount(channelId: string, conversationTypes: ConversationType[], includeMuted: boolean): IPromiseResult<number>;
     /**
-     * 实时位置共享配置，web 端无需处理
+     * 获取指定会话未读数
      */
-    location: null | string;
+    getConversationUnreadCount(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<number>;
     /**
-     * 实时日志上传开关
-     * @todo 需确认有效值及作用
+     * 清除指定会话未读数
      */
-    monitor: number;
+    clearConversationUnreadCount(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
     /**
-     * 是否允许加入多聊天室开关
+     * 获取第一个未读消息
      */
-    joinMChrm: boolean;
+    getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
     /**
-     * 是否开启公众号功能：`0` 为未开启，`1` 为已开启
+     * 按msgUids打量获取消息
      */
-    openMp: 0 | 1;
+    getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
     /**
-     * 是否开启用户级配置，若开启，需连接成功后立即拉取实时配置，0 | 1
-     * @description
-     * 配置来源:
-     * 1. 导航
-     * 2. 服务端实时下发
-     * 已有配置字段:
-     * 1. Lan. 推送使用的语言设置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 2. ShPushSwit. 推送是否显示详情设置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 3. MobPushSwit: Web/PC 在线，移动端不在线是否发送推送开关，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 4. OffMsgDur: 离线消息保存天数，设置天数不可大于App级对应配置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 5. VoipInfo: 音视频相关配置，用户端不可自定义修改. 由服务端决定，与导航下发格式一致
-     * @todo 需确认公有云与私有云区别
+     * 设置/保存指定会话消息草稿
+     * @draft 草稿内容
      */
-    openUS: 0 | 1;
+    saveConversationMessageDraft(conversationType: ConversationType, targetId: string, draft: string, channelId: string): Promise<ErrorCode>;
     /**
-     * 超级群功能开关,1表示开
+     * 获取指定会话消息草稿
      */
-    ugMsg?: 0 | 1;
+    getConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<string>;
     /**
-     * 群离线消息最大下发条数，`0` 为关闭
-     * @description 公有云独有配合
+     * 清除指定会话消息草稿
      */
-    grpMsgLimit: number;
+    clearConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
     /**
-     * 消息加密开关，0 为关闭
-     * @todo
-     * 1. 确定其控制的功能
-     * 2. 确定 web 相关性
-     * @note 在 V2 版本废弃
+     * 从服务端拉取会话状态
      */
-    isFormatted: number;
+    pullConversationStatus(timestamp: number): Promise<IAsyncRes<IServerConversationStatus[]>>;
     /**
-     * GIF 动图大小限制，默认 2048 KB
+     * 批量设置会话 置顶、免打扰
      */
-    gifSize: number;
+    batchSetConversationStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, onBefore?: (messageId: number) => void, traceId?: string): IPromiseResult<IReceivedMessage>;
     /**
-     * 上传小视频时长限制，单位：秒
-     * @description 公有云字段，即私有云配置中的 `uploadVideoTimeLimit`
+     * 断开连接
      */
-    videoTimes?: number;
+    disconnect(closeDB?: boolean): void;
     /**
-     * 上传小视频时长限制，单位：秒
-     * @description 私有云字段，即公有云配置中的 `videoTimes`
+     * 拉取用户级配置数据
      */
-    uploadVideoTimeLimit?: number;
+    pullUserSettings(version: number): IPromiseResult<IServerUserSetting>;
     /**
-     * 实时日志上传开关：`0` 为关闭，`1` 为开启
+     * 消息注册
+     * @description
+     * 消息注册需在应用初始化完成前进行，否则在搭配 C++ 协议栈使用时，
+     * 本端发出的消息将不默认作为未知消息处理，不存储、不计数
+     * @param objectName 消息类型，如：RC:TxtMsg
+     * @param isPersited 是否存储
+     * @param isCounted 是否技术
+     * @param searchProps 搜索字段，只在搭配协议栈使用时有效
+     * @param isStatusMessage 是否是状态消息
      */
-    logSwitch: number;
+    registerMessageType(objectName: string, isPersited: boolean, isCounted: boolean, searchProps: string[], isStatusMessage: boolean): void;
     /**
-     * 实时日志上传策略，值为 JSON 字符串
-     * @example `'{
-     * "url": "logcollection.ronghub.com", // 上传地址
-     * "level": 1,                         // 日志等级
-     * "itv": 6,                           // 上传频率，即时间间隔，单位 s
-     * "times": 5                          // 重试次数？
-     * }'`
+     * 加入聊天室
+     * @param count 拉取消息数量
      */
-    logPolicy: string;
+    joinChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
     /**
-     * 百度 BOS 存储服务地址
-     * @description 公有云独有配置
-     * @example `gz.bcebos.com`
-     * @deprecated 已废弃
+     * 加入已存在的聊天室
+     * @param count 拉取消息数量
      */
-    bosAddr?: string;
+    joinExistChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
     /**
-     * 阿里上传配置，字符串数组，数组顺序代表 七牛、百度、阿里云 上传权重
-     * @example
-     * ```
-     * `[{"qiniu":"upload.qiniup.com","p":"1"},
-     *  {"baidu":"gz.bcebos.com","p":"2"},
-     *  {"aliyun":"oss-cn-beijing.aliyuncs.com","p":"3"}]`
-     * ```
+     * 退出聊天室
      */
-    ossConfig?: string;
+    quitChatroom(chatroomId: string): Promise<ErrorCode>;
     /**
-     * 私有云专有属性，可用来判断当前环境是公有云还是私有云，私有云环境下该值为 `1`
+     * 获取聊天室信息
+     * @param count 获取人数, 范围 0 - 20
+     * @param order 排序方式, 1 正序, 2 倒序
      */
-    type?: number;
+    getChatroomInfo(chatroomId: string, count: number, order: number): IPromiseResult<IChatroomInfo>;
     /**
-     * @deprecated 已废弃
+     * 获取聊天室历史消息
      */
-    compDays: number;
+    getChatroomHistoryMessages(chatroomId: string, timestamp: number, count: number, order: number): IPromiseResult<{
+        list: IReceivedMessage[];
+        hasMore: boolean;
+    }>;
     /**
-     * @deprecated 已废弃
+     * 设置聊天室属性
      */
-    msgAck: unknown;
+    setChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
     /**
-     * @deprecated 已废弃
+     * 批量设置聊天室属性
      */
-    activeServer: string;
+    setChatroomEntries(chatroomId: string, entry: IChrmKVEntries): Promise<{
+        code: ErrorCode;
+        data?: any;
+    }>;
     /**
-     * @deprecated 已废弃
+     * 强制设置聊天室属性
      */
-    qnAddr: string;
+    forceSetChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
     /**
-     * @deprecated 已废弃
+     * 删除聊天室属性
      */
-    extkitSwitch: number;
+    removeChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
     /**
-     * @deprecated 已废弃
+     * 批量删除聊天室属性
      */
-    alone: boolean;
+    removeChatroomEntries(chatroomId: string, entries: IChrmKVEntries): Promise<{
+        code: ErrorCode;
+        data?: any;
+    }>;
     /**
-     * @deprecated 已废弃
+     * 强制删除聊天室属性
      */
-    voipServer: string;
+    forceRemoveChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
     /**
-     * 离线日志上报地址
-     * @deprecated 已废弃
+     * 获取聊天室 key 对应 value
      */
-    offlinelogserver: string;
+    getChatroomEntry(chatroomId: string, key: string): IPromiseResult<string | null>;
     /**
-     * 在线日志上报地址
-     * @deprecated 已废弃
+     * 获取聊天室所有 key value
      */
-    onlinelogserver?: string;
+    getAllChatroomEntry(chatroomId: string): IPromiseResult<{
+        [key: string]: string;
+    }>;
     /**
-     * 链路加密字段，内容为 JSON 字符串，仅限 C++ 可用
-     * @note 在 V2 版本废弃
+     * 获取上传认证信息
+     * @description
+     * 若不传 fileName 百度上传认证字段（bosToken、bosDate、path）均返回 null
      */
-    crypto?: string;
+    getFileToken(fileType: FileType, fileName?: string, httpMethod?: string, queryUriString?: string): Promise<IAsyncRes<IUploadAuth>>;
     /**
-     * 群组回执开关, 1: 打开，0(或者没有): 关闭
+     * 获取文件上传后下载地址
      */
-    grpRRVer?: number;
+    getFileUrl(fileType: FileType, uploadMethod: UploadMethod, fileName?: string, originName?: string): IPromiseResult<{
+        downloadUrl: string;
+    }>;
     /**
-     * 防黑产开关, 1: 打开，0：关闭
+     * 创建标签
+     * @param tag 标签
      */
-    openAnti?: number;
+    createTag(tag: ITagParam): IPromiseResult;
     /**
-     * 鉴权认证
+     * 删除标签
+     * @param tagId 标签id
      */
-    jwt?: string;
+    removeTag(tagId: string): IPromiseResult;
     /**
-     * 数据中心
+     * 编辑标签
+     * @param tag 标签
      */
-    dc?: string;
+    updateTag(tag: ITagParam): IPromiseResult;
     /**
-     * 是否开启 tls
+     * 获取标签列表
      */
-    openTLS?: number;
+    getTagList(): IPromiseResult<Array<ITagInfo>>;
     /**
-     * V2 版本中新增字段
-     * 服务地址列表
+     * 添加会话到标签（给多个会话增加标签）
+     * @param tagId 标签id
+     * @param conversations 要添加的会话列表
      */
-    serverAddr?: ICmpData[];
+    addTagForConversations(tagId: string, conversations: IConversationOption[]): IPromiseResult;
     /**
-     * V2 版本中新增字段
-     * 新版本控制tag
+     * 删除标签中的会话(从多个会话中批量删除指定标签)
+     * @param tagId 标签id
+     * @param conversations 要删除的会话列表
      */
-    excludeLogTag?: string;
-}
-
-declare type INaviCache = {
-    token: string;
-    naviInfo: INaviInfo;
-    timestamp: number;
-};
-/**
- * 导航数据管理类，负责管理导航有效期、导航请求、导航缓存
- */
-declare abstract class BasicNavi {
-    protected readonly appkey: string;
-    protected readonly logger: BasicLogger;
+    removeTagForConversations(tagId: string, conversations: IConversationOption[]): IPromiseResult;
     /**
-     * 业务层的自定义导航配置
+     * 删除会话中的标签(从单一会话中批量删除标签)
+     * @param conversationType 会话类型
+     * @param targetId 会话id
+     * @param tagIds 要删除的标签列表
      */
-    protected readonly navigators: string[];
-    constructor(appkey: string, logger: BasicLogger, 
+    removeTagsForConversation(conversation: IConversationOption, tagIds: string[]): IPromiseResult;
     /**
-     * 业务层的自定义导航配置
+     * 获取标签下的会话列表
+     * @param tagId 标签id
      */
-    navigators: string[]);
+    getConversationListByTag(tagId: string, startTime: number, count?: number, channelId?: string): IPromiseResult<IReceivedConversationByTag[]>;
     /**
-     * 当前进行中的导航请求
+     * 获取标签下的未读消息数
+     * @param tagId 标签id
+     * @param containMuted 是否包含免打扰会话
      */
-    private crtRequest;
+    getUnreadCountByTag(tagId: string, containMuted: boolean): IPromiseResult<number>;
     /**
-     * 请求导航数据
-     * @param token
-     * @param ignoreCache 是否忽略缓存，强制从服务器重新拉取。
-     * @param ignoreExpire 是否忽略有效期检查。理论上只需要在建立连接时需要检测 navi 有效期，其他场景无需检测
-     * @param traceId 事务日志跟踪 ID
+     * 设置标签中会话置顶
+     * @param conversation 会话
      */
-    request(token: string, ignoreCache: boolean, ignoreExpire: boolean, traceId: string): IPromiseResult<INaviInfo>;
-    private sendRequest;
+    setConversationStatusInTag(tagId: string, conversation: IConversationOption, status: ITagStatus): IPromiseResult;
     /**
-     * 从指定服务列表中顺序尝试获取导航
-     * @param uris 导航服务列表
-     * @param token
-     * @param traceId
+     * 获取会话里的标签
+     * @param config
      */
-    private requestHandler;
+    getTagsForConversation(conversation: IConversationOption): IPromiseResult<IConversationTag[]>;
     /**
-     * 向目标导航服务发送请求
-     * @param uri 导航服务地址
-     * @param appkey
-     * @param token
-     * @param version
-     * @param timeout 请求超时时间
-     * @param traceId
+     * 发送群组消息已读回执
+     * 导航下发已读回执开关为 true 时调用
      */
-    protected abstract httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
+    sendReadReceiptMessage(targetId: string, messageUIds: string[], channelId?: string): Promise<IAsyncRes>;
     /**
-     * 向目标导航服务发送请求
-     * @param uri 导航服务地址
-     * @param appkey
-     * @param token
-     * @param version
-     * @param timeout 请求超时时间
-     * @param traceId
+     * 获取群组消息已读列表
      */
-    protected abstract httpRequestV2(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
+    getMessageReader(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
     /**
-     * 转换 Navi 接口 HTTP 请求状态码为 ErrorCode 定义
-     * @param code
+     * 设置群组消息已读
      */
-    protected transHttpCode(code: number): ErrorCode;
+    setReadMessages(targetId: string, channelId: string, beginMessageUId: string, endMessageUId: string): Promise<IAsyncRes>;
     /**
-     * 设置缓存
-     * @param formatedToken
-     * @param naviInfo
-     * @description 设置缓存的同时会检测缓存中的既有数据，适当清理，避免无效数据长时间占用存储空间
+     * 获取群组消息已读回执信息
      */
-    protected abstract setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
+    getMessageReceiptInfo(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
     /**
-     * 获取缓存数据
-     * @param formatedToken
+     * 获取服务器时间
      */
-    protected abstract getNaviCache(formatedToken: string): INaviCache | null;
+    getServerTime(): number;
     /**
-     * 获取缓存的导航信息
-     * @param token
+     * 获取设备ID
      */
-    getNaviInfoFromCache(token: string): INaviInfo | null;
+    getDeviceId(): string;
     /**
-     * RTC 配置变更，更新 navi 缓存
-     * @param token
-     * @param voipCallInfo
+     * 获取当前 userId
      */
-    updateVoipCallInfo(token: string, voipCallInfo: string): void;
-    protected getNaviV2RequestOption(option: INaviRequestOption): IRequest;
+    getCurrentUserId(): string;
+    getConversationListWithAllChannel(): IPromiseResult<IReceivedConversation[]>;
+    getConversationListWithAllChannelByPage(index: number, limit: number): IPromiseResult<IReceivedConversation[]>;
     /**
-     * 是否使用 v2 版本导航
-     * 仅私有云 rcx 使用 v1 版本
+     * 设置用户在线状态监听器
      */
-    useV2Navi(): boolean;
-}
-
-/**
- * Websocket 导航工具类
- */
-declare class WebSocketNavi extends BasicNavi {
-    private runtime;
+    setUserStatusListener(config: {
+        userIds: string[];
+    }, listener: Function): void;
     /**
-     * 小程序平台服务地址，多个地址以 ',' 分割
+     * 设置当前用户在线状态
      */
-    private readonly miniCmpUris;
-    constructor(appkey: string, logger: BasicLogger, runtime: IRuntime, 
+    setUserStatus(status: number): Promise<ErrorCode>;
     /**
-     * 小程序平台服务地址，多个地址以 ',' 分割
+     * 订阅用户在线状态
      */
-    miniCmpUris: string[], navigators?: string[]);
-    protected httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
-    protected httpRequestV2(uri: string, appkey: string, token: string, traceId: string): IPromiseResult<INaviInfo>;
-    protected getNaviCache(formatedToken: string): INaviCache | null;
-    protected setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
-}
-
-/**
- * 当前运行时设备信息
- */
-interface IOSInfo {
-    /** 软件运行时的 CPU 架构信息 */
-    arch: string;
-    /** 平台标识 */
-    platform: string;
-    /** 操作系统名称 */
-    type: string;
-    /** 操作系统 release 标识 */
-    release: string;
-    /** 操作系统版本信息 */
-    version: string;
-    /** 内存余量 */
-    freemem: number;
-    /** 系统内存总量 */
-    totalmem: number;
-    /** 本次操作系统运行时长 */
-    uptime: number;
-    cpus: {
-        /** CPU 型号标识 */
-        model: string;
-        /** 主频 MHz */
-        speed: number;
-        times: {
-            user: number;
-            nice: number;
-            sys: number;
-            idle: number;
-            irq: number;
-        };
-    }[];
-    networkInterfaces: {
-        /** 网卡接口标识 */
-        [link: string]: {
-            /** IP */
-            address: string;
-            /** 子网掩码 */
-            netmask: string;
-            /** IP 协议版本 */
-            family: string;
-            /** Mac Address */
-            mac: string;
-            /** 是否回环地址 */
-            internal: boolean;
-            /** CIDR */
-            cidr: string | null;
-        }[] | undefined;
-    };
-}
-
-interface IProcessInfo {
-    title: string;
-    platform: string;
-    arch: string;
-    pid: number;
-    ppid: number;
-    uptime: number;
-    cpuUsage: {
-        user: number;
-        system: number;
-    };
-    memoryUsage: {
-        rss: number;
-        heapTotal: number;
-        heapUsed: number;
-        external: number;
-        arrayBuffers: number;
-    };
-    resourceUsage: {
-        userCPUTime: number;
-        systemCPUTime: number;
-        maxRSS: number;
-        sharedMemorySize: number;
-        unsharedDataSize: number;
-        unsharedStackSize: number;
-        minorPageFault: number;
-        majorPageFault: number;
-        swappedOut: number;
-        fsRead: number;
-        fsWrite: number;
-        ipcSent: number;
-        ipcReceived: number;
-        signalsCount: number;
-        voluntaryContextSwitches: number;
-        involuntaryContextSwitches: number;
-    };
-}
-
-/**
- * 连接状态定义枚举值
- */
-declare enum RCConnectionStatus {
+    subscribeUserStatus(userIds: string[]): Promise<ErrorCode>;
     /**
-     * 已连接
+     * 获取用户状态
      */
-    CONNECTED = 0,
+    getUserStatus(userId: string): IPromiseResult<{
+        status: string;
+    }>;
     /**
-     * 连接中
+     * 清空所有会话
      */
-    CONNECTING = 1,
+    clearConversations(conversationTypes?: ConversationType[], channelId?: string): Promise<ErrorCode>;
     /**
-     * 无连接，或已断开
+     * 加入黑名单
      */
-    DISCONNECTED = 2,
+    addToBlacklist(userId: string): Promise<ErrorCode>;
     /**
-     * 连接暂停状态，SDK 内部 5s 后会自动尝试重连
+     * 将指定用户移除黑名单
      */
-    SUSPENDED = 3
-}
-interface IConnectionListener {
+    removeFromBlacklist(userId: string): Promise<ErrorCode>;
     /**
-     * 连接成功
+     * 获取黑名单列表
      */
-    onConnected(): void;
+    getBlacklist(): IPromiseResult<string[]>;
     /**
-     * 连接中止，SDK 内部会进行重连
-     * @param code 中止原因
+     * 获取指定人员在黑名单中的状态
      */
-    onSuspend(code: ErrorCode): void;
+    getBlacklistStatus(userId: string): IPromiseResult<number>;
     /**
-     * 连接中
+     * 向本地插入一条消息，不发送到服务器
      */
-    onConnecting(): void;
+    insertMessage(conversationType: ConversationType, targetId: string, insertOptions: IInsertMsgOptions): IPromiseResult<IReceivedMessage>;
     /**
-     * 连接已终止
-     * @param code 连接终止原因
+     * 删除本地消息
      */
-    onDisconnected(code: ErrorCode): void;
-}
-/**
- * 抽象连接管理器类，负责 engine 层的连接状态维持，和对外的连接状态通知
- */
-declare abstract class AConnectionMgr {
-    protected readonly appkey: string;
-    private navi;
-    protected logger: BasicLogger;
-    private listener;
-    constructor(appkey: string, navi: BasicNavi, logger: BasicLogger, listener: IConnectionListener);
+    deleteMessages(messageIds: number[]): Promise<ErrorCode>;
     /**
-     * 当前连接所用 token
+     * 通过时间戳删除本地消息
      */
-    private token;
+    deleteMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, channelId: string): Promise<ErrorCode>;
     /**
-     * 获取当前连接中使用的 token
-     * @returns
+     * 清空会话下历史消息
      */
-    getToken(): string;
-    private reconnectKick;
+    clearMessages(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
     /**
-     * 当前连接状态
+     * 获取消息
      */
-    private _crtConnectionStatus;
+    getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
     /**
-     * 当前用户 ID
+     * 设置消息附加信息
      */
-    protected _crtUserId: string;
+    setTextMessageExtra(messageId: number, content: any): Promise<ErrorCode>;
     /**
-     * 获取当前用户 ID
-     * @returns
+     * 设置消息内容
      */
-    getCurrentUserId(): string;
+    setMessageContent(messageId: number, content: any, messageType: string): Promise<ErrorCode>;
     /**
-     * 缓存的 cmp 权重
-     * disconnect 时重置
+     * 设置消息搜索字段
      */
-    private cmpWeightCache?;
+    setMessageSearchField(messageId: number, content: any, searchFiles: string): Promise<ErrorCode>;
     /**
-     * 修改连接状态
-     * @param status
-     * @param code
+      * 通过关键字与 channelId 搜索所有会话
      */
-    private setConnectionStatus;
+    searchConversationByContent(keyword: string, customMessageTypes: string[], channelId: string, conversationTypes?: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
+    searchConversationByContentWithAllChannel(keyword: string, customMessageTypes: string[], conversationTypes?: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
     /**
-     * 获取当前连接状态
-     * @returns
+     * 按内容搜索会话内的消息
      */
-    getConnectionStatus(): RCConnectionStatus;
+    searchMessageByContent(conversationType: ConversationType, targetId: string, keyword: string, timestamp: number, count: number, total: number, channelId: string): IPromiseResult<{
+        messages: IReceivedMessage[];
+        count: number;
+    }>;
     /**
-     * 建立连接
-     * @param token
-     * @param reconnectKickEnable 设置断线重连时是否踢出当前正在重连的设备 (仅 Electron 环境有效)
-     *  同一个账号在一台新设备上登录的时候，会把这个账号在之前登录的设备上踢出。
-     *  由于 SDK 有断线重连功能，存在下面情况。
-     *  用户在 A 设备登录，A 设备网络不稳定，没有连接成功，SDK 启动重连机制。
-     *  用户此时又在 B 设备登录，B 设备连接成功。
-     *  A 设备网络稳定之后，用户在 A 设备连接成功，B 设备被踢出。
-     *  这个字段就是为这种情况加的。
-     *  设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
+     * 按内容搜索指定会话（不区分 channelId）的消息
      */
-    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
+    searchMessageByContentWithAllChannel(conversationType: ConversationType, targetId: string, keyword: string, timestamp: number, count: number): IPromiseResult<{
+        messages: IReceivedMessage[];
+        count: number;
+    }>;
     /**
-     * 执行中的连接事务
+    * 按内容搜索时间范围内指定会话（不区分 channelId）的消息
+    */
+    searchMessageByContentInTimeRangeWithAllChannel(conversationType: ConversationType, targetId: string, keyword: string, startTime: number, endTime: number, offset: number, limit: number): IPromiseResult<{
+        messages: IReceivedMessage[];
+    }>;
+    /**
+     * 获取会话下所有未读的 @ 消息
      */
-    private _crtConnectionTask;
+    getUnreadMentionedMessages(conversationType: ConversationType, targetId: string, channelId: string): IReceivedMessage[];
     /**
-     * 尝试建立连接
-     * @param token
-     * @param reconnectKickEnable
-     * @param ignoreNaviCache
-     * @param traceId
-     * @description 函数会检测当前是否有进行中的连接任务，若存在，则直接返回当前连接任务
+     * 设置消息发送状态
      */
-    private try2Connect;
+    setMessageSentStatus(messageId: number, sentStatus: number): Promise<ErrorCode>;
     /**
-     * 创建连接任务
-     * @param token
-     * @param reconnectKickEnable
-     * @param ignoreNaviCache
-     * @param traceId
-     * @returns
+     * 设置消息接收状态
      */
-    private createConnectionTask;
-    private reconnectTimer;
+    setMessageReceivedStatus(messageId: number, receivedStatus: number): Promise<ErrorCode>;
     /**
-     * 尝试重连
-     * @param ignoreNaviCache 是否忽略 navi 缓存以重新请求 navi
+     * 将自己发送的指定时间之前的消息标记对方已读，状态值为 SentStatus.READ
      */
-    private try2Reconnect;
+    updateMessageReceiptStatus(conversationType: ConversationType, targetId: string, timestamp: number, channelId?: string): IPromiseResult<boolean>;
     /**
-     * 服务器主动断开时由子类调用，函数将根据 reason 确定是否尝试重连
-     * @param reason
+     * 删除时间戳前的未读数
      */
-    protected onDisconnectByServer(code: ErrorCode): void;
+    clearUnreadCountByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, channelId: string): Promise<ErrorCode>;
     /**
-     * Socket 异常中断时由子类调用，SDK 尝试恢复重连
+     * 获取会话免打扰状态
      */
-    protected onDisconenctUnusual(code: ErrorCode): void;
+    getConversationNotificationStatus(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<NotificationStatus>;
     /**
-     * 建立 Socket 连接，由子类集成实现
-     * @param token
-     * @param naviInfo
-     * @param reconnectKickEnable
-     * @param traceId
+     * 协议栈获取远端历史消息
      */
-    protected abstract connectWithToken(token: string, naviInfo: INaviInfo, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
+    getRemoteHistoryMessages(conversationType: ConversationType, targetId: string, timestamp: number, count: number, order: 0 | 1, channelId: string): IPromiseResult<{
+        list: IReceivedMessage[];
+        hasMore: boolean;
+    }>;
     /**
-     * 当前累计心跳超时次数
+     * 无差别获取本地免打扰列表
      */
-    private _failedCount;
+    getBlockConversationList(): Promise<IAsyncRes<IBaseConversationInfo[]>>;
     /**
-     * 允许连续 PING 超时次数，超出指定次数后会主动关闭 socket 并重新连接
+     * 无差别获取本地置顶列表
      */
-    private readonly ALLOW_FAILED_TIMES;
+    getTopConversationList(conversationTypes?: ConversationType[], channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
     /**
-     * 启动心跳计时器
+     * 获取单个群聊会话 @ 消息未读数
      */
-    private checkAlive;
+    getUnreadMentionedCount(conversation: IConversationOption): Promise<IAsyncRes<number>>;
     /**
-     * 关闭连接
-     * @param inReconnect
+     * 获取所有群聊会话 @ 消息未读数
      */
-    protected abstract close(inReconnect: boolean, closeDB?: boolean): void;
+    getAllUnreadMentionedCount(): Promise<IAsyncRes<number>>;
+    clearData(): Promise<IAsyncRes<boolean>>;
     /**
-     * 完成一次 ping 过程，并返回响应状态码
-     * @param timeout 超时时间
+     * 获取运行时的系统信息，仅限 Electron 平台可用
      */
-    protected abstract sendPing(timeout: number): Promise<ErrorCode>;
+    getOSInfo(): IPromiseResult<IOSInfo>;
     /**
-     * 业务层主动断开连接时调用
+     * 获取应用主进程信息，仅限 Electron 平台可用
+     */
+    getMainProcessInfo(): IPromiseResult<IProcessInfo>;
+    /**
+     * 设置代理
+     */
+    setProxy(proxy: IProxy | null): IPromiseResult<IProxy>;
+    /**
+     * 获取代理
+     */
+    getProxy(): IPromiseResult<IProxy>;
+    /**
+     * 测试代理
+     */
+    testProxy(proxy: IProxy, testHost: string): Promise<IResponse>;
+    rtcPing(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<any>>;
+    rtcSignaling(roomId: string, method: string, isQuery: boolean, sourceData: any): Promise<{
+        code: ErrorCode;
+        buffer?: any;
+    }>;
+}
+
+declare enum StoreKeys {
+    /**
+     * Navi 数据缓存，暂未使用
+     */
+    NAVI = "rc-navi",
+    /**
+     * 实时日志已上报的时间戳
+     */
+    REALTIME_LOG_TIMESTAMP = "rc-realtime-log-timestamp"
+}
+
+/**
+ * 音视频模式
+ */
+declare enum RTCMode {
+    /**
+     * 普通音视频模式
+     */
+    RTC = 0,
+    /**
+     * 直播模式
+     */
+    LIVE = 2,
+    /**
+     *sip呼叫
+     */
+    SIP = 4,
+    /**
+     * 呼叫模式.包括单呼和群呼
+     */
+    CALL = 5,
+    /**
+     * 会议
+     */
+    MEETING = 6,
+    /**
+     * 跨应用多人房间
+     */
+    CROSS_MUTI = 7,
+    /**
+     * 跨应用直播
+     */
+    CROSS_LIVE = 8
+}
+/**
+ * 直播类型
+ */
+declare enum LiveType {
+    /**
+     * 音视频直播
      */
-    disconnect(closeDB?: boolean): Promise<void>;
+    AUDIO_AND_VIDEO = 0,
     /**
-     * 清理重连计时器
+     * 音频直播
      */
-    private stopReconnectTimer;
+    AUDIO = 1
+}
+declare enum LiveRole {
     /**
-     * 获取 CMP 列表
+     * 主播身份
      */
-    protected getCmpList(navi: INaviInfo, isTcp?: boolean): ICmpData[];
+    ANCHOR = 1,
     /**
-     * 修改 CMP 权重
+     * 观众身份
      */
-    protected updateCmpWeight(cmpUrl: string, isRise?: boolean): void;
-    private clearCmpWeightCache;
+    AUDIENCE = 2
 }
-
-/**
- * 查询错误码是否为服务下发的 disconnect 通知 status 所转换
- * @param code
- * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
- */
-declare const isDisconnectCode: (code: ErrorCode) => boolean;
-/**
- * 查询错误码是否为服务下发的 connAck status 所转换
- * @param code
- * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
- */
-declare const isConnnectAckCode: (code: ErrorCode) => boolean;
-
 /**
- * 进程内缓存数据
+ * CallLib 流程消息
  */
-interface IProcessCache {
-    crtUserId: string;
-    connectedTime: number;
-    naviInfo: INaviInfo | null;
-    connectionStatus: RCConnectionStatus;
-    deviceId: string;
+declare const CallLibMsgType: {
+    'RC:VCAccept': string;
+    'RC:VCRinging': string;
+    'RC:VCSummary': string;
+    'RC:VCHangup': string;
+    'RC:VCInvite': string;
+    'RC:VCModifyMedia': string;
+    'RC:VCModifyMem': string;
+};
+declare enum RTCApiType {
+    ROOM = 1,
+    PERSON = 2
+}
+declare enum RTCIdentityChangeType {
+    AnchorToViewer = 1,
+    ViewerToAnchor = 2
 }
 /**
- * 约束主进程 CppEngine 与 CppService 间的方法定义，以便于代码检查
+ * RTC 房间加入类型
  */
-interface IEngine {
+declare enum RTCJoinType {
     /**
-     * 注册本渲染进程至主进程，以接收主进程的消息通知，同时同步主进程的当前缓存数据
+     * 踢前一个设备
      */
-    getMainProcessCache(): IProcessCache;
+    KICK = 0,
     /**
-     * 建立连接
-     * @param token
-     * @param reconnectKickEnable
+     * 当前加入拒绝
      */
-    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
-    getNaviInfoFromCache(): INaviInfo | null;
+    REFUSE = 1,
     /**
-     * 上报版本信息
-     * @param version
+     * 两个设备共存
      */
-    reportSDKInfo(version: {
-        [name: string]: string;
-    }): void;
+    COEXIST = 2
+}
+
+/**
+ * @category Interface
+ */
+interface IGooglePushConfig {
     /**
-     * 连接时间
+     * 分组ID
      */
-    getConnectedTime(): number;
+    collapseKey?: string;
     /**
-     * 调用非标准方法。所谓非标准方法，是为某些特定需求或产品添加，暂未作为标准接口添加至 API 层。
-     * 对于未实现的方法，接口响应 Unsupport 错误码
-     * @param method
-     * @param args
+     *
      */
-    callExtra(method: string | keyof IExtraMethod, ...args: any[]): Promise<IAsyncRes<unknown>>;
+    imageUrl?: string;
     /**
-     * 获取历史消息
-     * @param conversationType
-     * @param targetId
-     * @param timestamp
-     * @param count
-     * @param order
+     *优先级
      */
-    getHistoryMessage(conversationType: ConversationType, targetId: string, 
+    priority?: 'high' | 'normal';
+}
+/**
+ * @category Interface
+ */
+interface IiOSPushConfig {
     /**
-     * 拉取时间戳，值为 `0` 表示从当前时间拉取
+     * iOS 用于通知分组的 id
      */
-    timestamp: number, 
+    threadId?: string;
     /**
-     * 获取条数, 有效值 `1` - `20`
+     * iOS 用于通知覆盖的 id
      */
-    count: number, 
+    apnsCollapseId?: string;
     /**
-     * @description
-     * 1. `0` 表示升序，获取消息发送时间比传入 `sentTime` 小 的消息
-     * 2. `1` 表示降序，获取消息发送时间比传入 `sentTime` 大 的消息
+     * iOS 分类，如果不设置后台默认取消息类型字符串，如RC:TxtMsg
      */
-    order: 0 | 1, 
+    category?: string;
     /**
-     * 会话的业务标识
+     * 和 category 对应
      */
-    channelId: string, 
+    richMediaUri?: string;
+}
+/**
+ * @category Interface
+ */
+interface IAndroidPushConfig {
     /**
-     * 消息类型
+     * Android 的通知 id
      */
-    objectName: string): IPromiseResult<{
-        list: IReceivedMessage[];
-        hasMore: boolean;
-    }>;
+    notificationId?: string;
     /**
-     * 获取指定消息类型的历史消息
+     * 小米的 channelId
      */
-    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, timestamp: number, count: number, messageTypes: string[], order: number, channelId: string): Promise<IAsyncRes<{
-        list: IReceivedMessage[];
-        hasMore: boolean;
-    }>>;
+    channelIdMi?: string;
     /**
-     * 删除历史消息 通过 messageUId
+     * 小米 Large icon 链接
+     * Large icon 可以出现在大图版和多字版消息中，显示在右边。
+     * 国内版仅 MIUI12 以上版本支持，以下版本均不支持；国际版支持。
+     * 图片要求：大小 120 * 120px，格式为 png 或者 jpg 格式。
      */
-    deleteRemoteMessage(conversationType: ConversationType, targetId: string, 
+    miLargeIconUrl?: string;
     /**
-     * @description
-     * message 中 messageUId、setTime、messageDirection 为必须参数
+     * 华为的 channelId
      */
-    messages: {
-        messageUId: string;
-        sentTime: number;
-        messageDirection: MessageDirection;
-    }[], 
+    channelIdHW?: string;
     /**
-     * 会话的业务标识
+     * 华为推送消息分类
+     * 更多信息请参考华为消息分类标准文档: https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835
+     * 5.7.3 版本开始支持
+    */
+    categoryHW?: string;
+    /**
+     * 华为推送消息级别
+     * LOW: 表示消息为资讯营销
+     * NORMAL: 消息为服务与通讯
      */
-    channelId: string): Promise<ErrorCode>;
-    recallMsg(conversationType: ConversationType, targetId: string, messageUId: string, sentTime: number, recallMsgOptions: IRecallMsgOptions): IPromiseResult<IReceivedMessage>;
+    importanceHW?: 'NORMAL' | 'LOW';
     /**
-     * 删除历史消息 通过 时间戳
-     * @param timestamp 小于等于传入时间戳的消息均删除
+     * 华为通知类型的推送所使用的通知图片 url
+    */
+    imageUrlHW?: string;
+    /**
+     * OPPO 的 channelId
      */
-    deleteRemoteMessageByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, 
+    channelIdOPPO?: string;
     /**
-     * 会话的业务标识
+     * vivo 的类型
      */
-    channelId: string): Promise<ErrorCode>;
+    typeVivo?: string;
     /**
-     * 获取会话列表
-     * @param count 指定获取数量, 不传则获取全部会话列表，默认 `300`
+    * google FCM 的推送配置
+    */
+    googleConfig?: IGooglePushConfig;
+}
+/**
+ * 推送配置
+ * @category Interface
+ */
+interface IPushConfig {
+    /**
+     * 推送标题
+     * 如果没有设置，会使用下面的默认标题显示规则
+     * 默认标题显示规则：
+     * 内置消息：单聊通知标题显示为发送者名称，群聊通知标题显示为群名称。
+     * 自定义消息：默认不显示标题。
      */
-    getConversationList(
+    pushTitle: string;
     /**
-     * 拉取数量, 有效值 0 - 1000, 默认 300
+     * 推送内容
+     * 优先使用 IPushConfig.pushContent, 如果没有，则使用发送消息的 pushContent 参数
      */
-    count: number, 
+    pushContent: string;
     /**
-     * 会话类型
-     * @todo 待确认是否生效
+     * 远程推送附加信息
+     * 优先使用 IPushConfig.pushData, 如果没有，则使用发送消息的 pushContent 参数
      */
-    conversationType?: ConversationType, 
+    pushData: string;
     /**
-     * 起始时间
+     * iOSConfig
      */
-    startTime?: number, 
+    iOSConfig?: IiOSPushConfig;
     /**
-     * 获取顺序
+     * androidConfig
      */
-    order?: 0 | 1, 
+    androidConfig?: IAndroidPushConfig;
     /**
-     * 会话的业务标识
+     * 是否显示推送标题. 仅针对 iOS 平台有效
      */
-    channelId?: string): IPromiseResult<IReceivedConversation[]>;
+    disablePushTitle: boolean;
+    /**
+     * 是否强制推送
+     */
+    forceShowDetailContent: boolean;
+    /**
+     * 推送模板id
+    */
+    templateId: string;
+}
+
+/**
+ * 已读回执数据结构
+ * @category Interface
+ */
+interface IMessageReader {
+    readTime: number;
+    userId: string;
+}
+/**
+ * @category Interface
+ */
+interface IMessageReaderResponse {
+    totalMemberCount: number;
+    list: IMessageReader[];
+}
+interface ILocalReadReceiptInfo {
+    hasRespond?: boolean;
+    readerInfo?: {
+        [userId: string]: number;
+    };
+    readCount?: number;
+    totalCount?: number;
+}
+/**
+ * @category Interface
+ */
+interface IReadReceiptInfo {
     /**
-     * 分页获取会话列表，仅 electron中使用
+     * 是否已经发送已读回执
      */
-    getConversationsByPage(conversationTypes: ConversationType[], startTime: number, count: number, channelId: string): IPromiseResult<IReceivedConversation[]>;
+    hasRespond?: boolean;
     /**
-     * 获取指定会话
+     * 已阅读用户列表（不准确）
      */
-    getConversation(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedConversation | null>;
+    readerList?: IMessageReader[];
     /**
-     * 获取未读会话列表
+     * 阅读人数（不准确）
      */
-    getUnreadConversationList(conversationTypes: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
+    readCount?: number;
     /**
-     * 删除会话
-     * @description 该删除操作会删除服务器端存储的会话数据
-     * @param conversationType
-     * @param targetId
+     * 群组总人数（不准确）
      */
-    removeConversation(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    totalCount?: number;
+}
+/**
+ * 从服务端接收到的消息数据
+ * @category Interface
+ */
+interface IReceivedMessage {
     /**
-     * 获取所有会话未读数
-     * @param channelId 多组织 Id
-     * @param conversationTypes
-     * @param includeMuted 包含已设置免打扰的会话
-     */
-    getAllConversationUnreadCount(channelId: string, conversationTypes: ConversationType[], includeMuted: boolean): IPromiseResult<number>;
+     * 会话的业务标识
+    */
+    channelId?: string;
     /**
-     * 获取指定会话未读数
+     * 会话类型
+     * * 1: 单聊
+     * * 3: 群聊
+     * * 4: 聊天室
+     * * 5: 客服会话
+     * * 6: 系统消息
+     * * 7: 默认关注的公众号
+     * * 8: 手动关注的公众号
+     * * 9: RTCLib 房间
      */
-    getConversationUnreadCount(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<number>;
+    conversationType: ConversationType;
     /**
-     * 清除指定会话未读数
+     * 会话 targetId
      */
-    clearConversationUnreadCount(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    targetId: string;
     /**
-     * 获取第一个未读消息
+     * 消息发送者的用户 Id
      */
-    getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
+    senderUserId: string;
     /**
-     * 按UId批量取消息
-     * @param msgUids
+     * 消息内容
      */
-    getMessageByUids(msgUids: string[]): IReceivedMessage[];
+    content: any;
     /**
-     * 按msgUids打量获取消息
+     * 消息结构名称，即消息类型
+     * @example RC:TxtMsg
      */
-    getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
+    messageType: string;
     /**
-     * 设置/保存指定会话消息草稿
-     * @draft 草稿内容
+     * 服务端存储的消息 Id
      */
-    saveConversationMessageDraft(conversationType: ConversationType, targetId: string, draft: string, channelId: string): Promise<ErrorCode>;
+    messageUId: string;
     /**
-     * 获取指定会话消息草稿
+     * 消息方向是发出 or 收取
      */
-    getConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<string>;
+    messageDirection: MessageDirection;
     /**
-     * 清除指定会话消息草稿
+     * 是否为离线消息
      */
-    clearConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    isOffLineMessage: boolean;
     /**
-     * 从服务端拉取会话状态
+     * 消息在服务器端的发送时间
      */
-    pullConversationStatus(timestamp: number): Promise<IAsyncRes<IServerConversationStatus[]>>;
+    sentTime: number;
     /**
-     * 批量设置会话 置顶、免打扰
+     * 消息接收时间，该时间通过消息的 `sentTime` 值在本地进行计算得出，不推荐使用
+     * @description 当 isOffLineMessage 为 true 时，该值无效
      */
-    batchSetConversationStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
-    sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, onBefore?: (messageId: number) => void, traceId?: string): IPromiseResult<IReceivedMessage>;
+    receivedTime: number;
     /**
-     * 断开连接
+     * 是否存储
+     * @default true
      */
-    disconnect(closeDB?: boolean): void;
+    isPersited: boolean;
     /**
-     * 拉取用户级配置数据
+     * 是否计数
+     * @default true
      */
-    pullUserSettings(version: number): IPromiseResult<IServerUserSetting>;
+    isCounted: boolean;
     /**
-     * 消息注册
-     * @description
-     * 消息注册需在应用初始化完成前进行，否则在搭配 C++ 协议栈使用时，
-     * 本端发出的消息将不默认作为未知消息处理，不存储、不计数
-     * @param objectName 消息类型，如：RC:TxtMsg
-     * @param isPersited 是否存储
-     * @param isCounted 是否技术
-     * @param searchProps 搜索字段，只在搭配协议栈使用时有效
-     * @param isStatusMessage 是否是状态消息
+     * 是否为 @ 消息
      */
-    registerMessageType(objectName: string, isPersited: boolean, isCounted: boolean, searchProps: string[], isStatusMessage: boolean): void;
+    isMentioned: boolean;
     /**
-     * 加入聊天室
-     * @param count 拉取消息数量
+     * 消息是否静默
+     * @description 静默消息不会发送 Push 信息和本地通知提醒
      */
-    joinChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
+    disableNotification: boolean;
     /**
-     * 加入已存在的聊天室
-     * @param count 拉取消息数量
+     * 是否是状态消息
      */
-    joinExistChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
+    isStatusMessage: boolean;
     /**
-     * 退出聊天室
-     */
-    quitChatroom(chatroomId: string): Promise<ErrorCode>;
+     * 是否支持消息扩展存储
+    */
+    canIncludeExpansion: boolean;
     /**
-     * 获取聊天室信息
-     * @param count 获取人数, 范围 0 - 20
-     * @param order 排序方式, 1 正序, 2 倒序
-     */
-    getChatroomInfo(chatroomId: string, count: number, order: number): IPromiseResult<IChatroomInfo>;
+     * 消息携带的扩展存储
+    */
+    expansion: {
+        [key: string]: any;
+    } | null;
     /**
-     * 获取聊天室历史消息
-     */
-    getChatroomHistoryMessages(chatroomId: string, timestamp: number, count: number, order: number): IPromiseResult<{
-        list: IReceivedMessage[];
-        hasMore: boolean;
-    }>;
+     * 消息接收状态
+    */
+    receivedStatus: number;
     /**
-     * 设置聊天室属性
-     */
-    setChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
+     * 消息本地 ID, web 端由 lib 内生成， PC 端由协议栈数据库生成自增ID
+    */
+    messageId?: number;
     /**
-     * 批量设置聊天室属性
-     */
-    setChatroomEntries(chatroomId: string, entry: IChrmKVEntries): Promise<{
-        code: ErrorCode;
-        data?: any;
-    }>;
+     * 消息发送状态， web 端由 lib 内根据消息状态设置值为 发送中、已发送和发送失败 ，PC 端由协议栈自动维护或用户自己设置
+    */
+    sentStatus?: SentStatus;
     /**
-     * 强制设置聊天室属性
+     * 已读回执信息(导航配置grpRRVer=1时群组类型消息内存在, 其他情况为undefined)
      */
-    forceSetChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
+    readReceiptInfo?: IReadReceiptInfo;
     /**
-     * 删除聊天室属性
+     * 推送扩展
      */
-    removeChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
+    pushConfig?: IPushConfig;
     /**
-     * 批量删除聊天室属性
+     * 超级群专有字段，是否断档，服务端收到大量消息可能会断档，所以消息存在此标志位，断档需要客户手动拉取历史消息
      */
-    removeChatroomEntries(chatroomId: string, entries: IChrmKVEntries): Promise<{
-        code: ErrorCode;
-        data?: any;
-    }>;
+    isInterrupt?: boolean;
     /**
-     * 强制删除聊天室属性
+     * 拉取历史消息时表示该消息是否修改过（仅超级群有效）
      */
-    forceRemoveChatroomEntry(chatroomId: string, entry: IChrmKVEntry): Promise<ErrorCode>;
+    isModifyMessage?: boolean;
     /**
-     * 获取聊天室 key 对应 value
+     * 拉取历史消息时表示该消息是否为超级群频道类型（仅超级群有效）
      */
-    getChatroomEntry(chatroomId: string, key: string): IPromiseResult<string | null>;
+    channelType?: UltraGroupChannelType;
     /**
-     * 获取聊天室所有 key value
-     */
-    getAllChatroomEntry(chatroomId: string): IPromiseResult<{
-        [key: string]: string;
-    }>;
+    * 扩展内容
+    */
+    extraContent?: string;
+}
+/**
+ * @category Interface
+ */
+interface IUserProfile {
     /**
-     * 获取上传认证信息
-     * @description
-     * 若不传 fileName 百度上传认证字段（bosToken、bosDate、path）均返回 null
-     */
-    getFileToken(fileType: FileType, fileName?: string, httpMethod?: string, queryUriString?: string): Promise<IAsyncRes<IUploadAuth>>;
+      * 用户 ID
+      */
+    id?: string;
     /**
-     * 获取文件上传后下载地址
+     * 用户名
      */
-    getFileUrl(fileType: FileType, uploadMethod: UploadMethod, fileName?: string, originName?: string): IPromiseResult<{
-        downloadUrl: string;
-    }>;
+    name?: string;
     /**
-     * 创建标签
-     * @param tag 标签
+     * 用户头像地址
+     * @deprecated
      */
-    createTag(tag: ITagParam): IPromiseResult;
+    portraitUri?: string;
     /**
-     * 删除标签
-     * @param tagId 标签id
+     * user info 中附加信息
      */
-    removeTag(tagId: string): IPromiseResult;
+    extra?: string;
     /**
-     * 编辑标签
-     * @param tag 标签
+     * 用户头像地址（向移动端兼容）
      */
-    updateTag(tag: ITagParam): IPromiseResult;
+    portrait?: string;
+}
+interface IOperateInfo {
+    targetId: string;
+    channelId?: string;
+    userId: string;
+    operationType: OperateStatus;
+    operationTime?: number;
+}
+interface IOperateSummary {
+    targetId: string;
+    channelId?: string;
+    count: number;
+    operationType: OperateStatus;
+}
+interface IOperateStatusNotify {
+    conversationType: ConversationType;
+    hasInfo: boolean;
+    hasSummary: boolean;
+    info: IOperateInfo[];
+    summary: IOperateSummary[];
+}
+interface IRecallMsgOptions {
     /**
-     * 获取标签列表
-     */
-    getTagList(): IPromiseResult<Array<ITagInfo>>;
+     * 会话组织机构标识
+     * 默认值未 空字符串
+    */
+    channelId: string;
     /**
-     * 添加会话到标签（给多个会话增加标签）
-     * @param tagId 标签id
-     * @param conversations 要添加的会话列表
-     */
-    addTagForConversations(tagId: string, conversations: IConversationOption[]): IPromiseResult;
+     * 发送消息携带的用户信息
+    */
+    user?: IUserProfile;
     /**
-     * 删除标签中的会话(从多个会话中批量删除指定标签)
-     * @param tagId 标签id
-     * @param conversations 要删除的会话列表
-     */
-    removeTagForConversations(tagId: string, conversations: IConversationOption[]): IPromiseResult;
+     * Push 信息
+    */
+    pushContent?: string;
     /**
-     * 删除会话中的标签(从单一会话中批量删除标签)
-     * @param conversationType 会话类型
-     * @param targetId 会话id
-     * @param tagIds 要删除的标签列表
-     */
-    removeTagsForConversation(conversation: IConversationOption, tagIds: string[]): IPromiseResult;
+     * 原消息体
+    */
+    oriContent?: any;
     /**
-     * 获取标签下的会话列表
-     * @param tagId 标签id
-     */
-    getConversationListByTag(tagId: string, startTime: number, count?: number, channelId?: string): IPromiseResult<IReceivedConversationByTag[]>;
+     * 是否发送静默消息
+     * @description
+     * 当值为 `true` 时，服务器将不会发送 Push 信息，移动端也不会弹出本地通知提醒
+    */
+    disableNotification?: boolean;
     /**
-     * 获取标签下的未读消息数
-     * @param tagId 标签id
-     * @param containMuted 是否包含免打扰会话
-     */
-    getUnreadCountByTag(tagId: string, containMuted: boolean): IPromiseResult<number>;
+     * 移动端推送配置
+    */
+    pushConfig?: IPushConfig;
     /**
-     * 设置标签中会话置顶
-     * @param conversation 会话
-     */
-    setConversationStatusInTag(tagId: string, conversation: IConversationOption, status: ITagStatus): IPromiseResult;
+       * 其他拓展信息
+       */
+    extra?: string;
     /**
-     * 获取会话里的标签
-     * @param config
+     * 是否删除原始消息(在移动端会使用到)，为 true 时移动端会不显示小灰条提示
      */
-    getTagsForConversation(conversation: IConversationOption): IPromiseResult<IConversationTag[]>;
+    isDelete?: boolean;
+}
+interface IRecallMsgContent {
+    conversationType: number;
+    targetId: string;
+    sentTime: number;
+    messageUId: string;
     /**
-     * 发送群组消息已读回执
-     * 导航下发已读回执开关为 true 时调用
-     */
-    sendReadReceiptMessage(targetId: string, messageUIds: string[], channelId?: string): Promise<IAsyncRes>;
+     * 会话组织机构标识
+     * 默认值未 空字符串
+    */
+    channelId: string;
     /**
-     * 获取群组消息已读列表
-     */
-    getMessageReader(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
+       * 其他拓展信息
+       */
+    extra?: string;
     /**
-     * 设置群组消息已读
-     */
-    setReadMessages(targetId: string, channelId: string, beginMessageUId: string, endMessageUId: string): Promise<IAsyncRes>;
+     * 发送消息携带的用户信息
+    */
+    user?: IUserProfile;
     /**
-     * 获取群组消息已读回执信息
+     * 是否删除原始消息(在移动端会使用到)，为 true 时移动端会不显示小灰条提示
      */
-    getMessageReceiptInfo(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
+    isDelete?: boolean;
+}
+/**
+ * 发送消息时的可选项信息
+ */
+interface ISendMsgOptions {
     /**
-     * 获取服务器时间
+     * 消息类型，即消息结构的 ObjectName
      */
-    getServerTime(): number;
+    messageType: string;
     /**
-     * 获取设备ID
+     * 消息内容
      */
-    getDeviceId(): string;
+    content: {
+        /**
+         * 消息内容 key-value，最终会进行 JSON 序列化后发送
+         */
+        [key: string]: any;
+        /**
+         * 消息可携带的用户数据
+         */
+        user?: IUserProfile;
+        /**
+         * 其他拓展信息
+         */
+        extra?: string;
+    };
     /**
-     * 获取当前 userId
+     * 是否存储
+     * @description 只在发送未注册过的自定义消息时有效，否则使用注册时的配置
      */
-    getCurrentUserId(): string;
-    getConversationListWithAllChannel(): IPromiseResult<IReceivedConversation[]>;
-    getConversationListWithAllChannelByPage(index: number, limit: number): IPromiseResult<IReceivedConversation[]>;
+    isPersited?: boolean;
     /**
-     * 设置用户在线状态监听器
+     * 是否计数
+     * @description 只在发送未注册过的自定义消息时有效，否则使用注册时的配置
      */
-    setUserStatusListener(config: {
-        userIds: string[];
-    }, listener: Function): void;
+    isCounted?: boolean;
     /**
-     * 设置当前用户在线状态
+     * 是否是状态消息，一般为无需注册的自定义消息
+     * @description
+     * 1. 状态消息只有 pub，没有 ack 应答
+     * 2. 状态消息默认不存储，不计数，`isPersited` 与 `isCounted` 配置将失效
      */
-    setUserStatus(status: number): Promise<ErrorCode>;
+    isStatusMessage?: boolean;
     /**
-     * 订阅用户在线状态
+     * 是否发送静默消息
+     * @description
+     * 当值为 `true` 时，服务器将不会发送 Push 信息，移动端也不会弹出本地通知提醒
      */
-    subscribeUserStatus(userIds: string[]): Promise<ErrorCode>;
+    disableNotification?: boolean;
     /**
-     * 获取用户状态
+     * Push 信息
      */
-    getUserStatus(userId: string): IPromiseResult<{
-        status: string;
-    }>;
+    pushContent?: string;
     /**
-     * 清空所有会话
+     * Push 通知携带的附加信息
      */
-    clearConversations(conversationTypes?: ConversationType[], channelId?: string): Promise<ErrorCode>;
+    pushData?: string;
     /**
-     * 加入黑名单
+     * 是否为 @ 消息，只当 conversationType 值为 `ConversationType.GROUP` 时有效
      */
-    addToBlacklist(userId: string): Promise<ErrorCode>;
+    isMentioned?: boolean;
     /**
-     * 将指定用户移除黑名单
+     * `@` 消息类型
+     * @description `1: @ 所有人 2: @ 指定用户`
      */
-    removeFromBlacklist(userId: string): Promise<ErrorCode>;
+    mentionedType?: 1 | 2;
     /**
-     * 获取黑名单列表
+     * 被 @ 的用户 Id 列表，当 `mentionedType` 值为 `1` 时，该值可为空
      */
-    getBlacklist(): IPromiseResult<string[]>;
+    mentionedUserIdList?: string[];
     /**
-     * 获取指定人员在黑名单中的状态
+     * 用于发送群定向消息，只当 conversationType 值为 `ConversationType.GROUP` 时有效
      */
-    getBlacklistStatus(userId: string): IPromiseResult<number>;
+    directionalUserIdList?: string[];
     /**
-     * 向本地插入一条消息，不发送到服务器
+     * 当对方为 iOS 设备且未在线时，其将收到 Voip Push. 此配置对 Android 无影响
      */
-    insertMessage(conversationType: ConversationType, targetId: string, insertOptions: IInsertMsgOptions): IPromiseResult<IReceivedMessage>;
+    isVoipPush?: boolean;
     /**
-     * 删除本地消息
+     * 消息是否支持拓展内容
      */
-    deleteMessages(messageIds: number[]): Promise<ErrorCode>;
+    canIncludeExpansion?: boolean;
     /**
-     * 通过时间戳删除本地消息
+     * 消息拓展内容数据
      */
-    deleteMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, channelId: string): Promise<ErrorCode>;
+    expansion?: {
+        [key: string]: string;
+    };
     /**
-     * 清空会话下历史消息
+     * 黑/白名单
+     * @todo 功能未知，需确认
      */
-    clearMessages(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    isFilerWhiteBlacklist?: boolean;
     /**
-     * 获取消息
-     */
-    getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
+     * 移动端推送配置
+    */
+    pushConfig?: IPushConfig;
     /**
-     * 设置消息附加信息
-     */
-    setTextMessageExtra(messageId: number, content: any): Promise<ErrorCode>;
+     * 会话业务标识
+     * @description
+     * 20 个字符长度限制
+    */
+    channelId?: string;
     /**
-     * 设置消息内容
+     * 客户端的消息标识
+     * 重发消息时用到，重发消息的消息 ID
      */
-    setMessageContent(messageId: number, content: any, messageType: string): Promise<ErrorCode>;
+    messageId?: number;
     /**
-     * 设置消息搜索字段
+     * 超级群专有字段，是否断档，若断档需要客户判断是否拉取
      */
-    setMessageSearchField(messageId: number, content: any, searchFiles: string): Promise<ErrorCode>;
+    isInterrupt?: boolean;
     /**
-      * 通过关键字与 channelId 搜索所有会话
+    * 标识该消息是否为重发消息，仅 electron 中有效。
+    */
+    isResend?: boolean;
+}
+interface IInsertMsgOptions {
+    senderUserId: string;
+    messageType: string;
+    content: any;
+    messageDirection: number;
+    readStatus?: number;
+    sentStatus?: number;
+    sentTime?: number;
+    searchContent?: string;
+    isUnread?: boolean;
+    messageUId?: string;
+    disableNotification?: boolean;
+    canIncludeExpansion?: boolean;
+    expansionMsg?: string;
+    channelId: string;
+}
+interface IInsertMessage {
+    conversationType: number;
+    targetId: string;
+    channelId: string;
+    messageDirection: number;
+    messageType: string;
+    content: any;
+    messageUId: string;
+    senderUserId: string;
+    sentStatus?: number;
+    sentTime?: number;
+    disableNotification?: boolean;
+    canIncludeExpansion?: boolean;
+    expansion?: {
+        [key: string]: any;
+    } | null;
+    receivedStatus?: number;
+    /**
+     * 插入消息是否计入未读数: true 计数 false 不计数, 默认不计数
      */
-    searchConversationByContent(keyword: string, customMessageTypes: string[], channelId: string, conversationTypes?: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
-    searchConversationByContentWithAllChannel(keyword: string, customMessageTypes: string[], conversationTypes?: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
+    isUnread?: boolean;
     /**
-     * 按内容搜索会话内的消息
+     * 消息搜索关键字
      */
-    searchMessageByContent(conversationType: ConversationType, targetId: string, keyword: string, timestamp: number, count: number, total: number, channelId: string): IPromiseResult<{
-        messages: IReceivedMessage[];
-        count: number;
-    }>;
+    searchContent?: string;
     /**
-     * 按内容搜索指定会话（不区分 channelId）的消息
+     * 来源
      */
-    searchMessageByContentWithAllChannel(conversationType: ConversationType, targetId: string, keyword: string, timestamp: number, count: number): IPromiseResult<{
-        messages: IReceivedMessage[];
-        count: number;
-    }>;
+    source?: string;
+    isMentioned?: boolean;
+}
+interface ISendExMsgOptions {
+    channelId: string;
+    conversationType: ConversationType;
+    targetId: string;
     /**
-    * 按内容搜索时间范围内指定会话（不区分 channelId）的消息
+     * 消息 ID
     */
-    searchMessageByContentInTimeRangeWithAllChannel(conversationType: ConversationType, targetId: string, keyword: string, startTime: number, endTime: number, offset: number, limit: number): IPromiseResult<{
-        messages: IReceivedMessage[];
-    }>;
+    messageUId: string;
     /**
-     * 获取会话下所有未读的 @ 消息
-     */
-    getUnreadMentionedMessages(conversationType: ConversationType, targetId: string, channelId: string): IReceivedMessage[];
+     * 原始消息是否支持扩展的字段
+    */
+    canIncludeExpansion: boolean;
     /**
-     * 设置消息发送状态
-     */
-    setMessageSentStatus(messageId: number, sentStatus: number): Promise<ErrorCode>;
+     * 删除的 keys
+    */
+    keys?: string[];
     /**
-     * 设置消息接收状态
-     */
-    setMessageReceivedStatus(messageId: number, receivedStatus: number): Promise<ErrorCode>;
+     * 扩展对象
+    */
+    expansion?: {
+        [key: string]: string;
+    };
     /**
-     * 将自己发送的指定时间之前的消息标记对方已读，状态值为 SentStatus.READ
-     */
-    updateMessageReceiptStatus(conversationType: ConversationType, targetId: string, timestamp: number, channelId?: string): IPromiseResult<boolean>;
+     * 是否删除所有扩展
+    */
+    removeAll?: boolean;
     /**
-     * 删除时间戳前的未读数
-     */
-    clearUnreadCountByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, channelId: string): Promise<ErrorCode>;
+     * 原始消息的扩展
+    */
+    originExpansion?: {
+        [key: string]: string;
+    } | null;
+}
+interface IUltraExMsgOptions {
+    canIncludeExpansion: boolean;
+    channelId: string;
+    conversationType: ConversationType;
+    targetId: string;
+    messageUId: string;
+    sendTime: number;
     /**
-     * 获取会话免打扰状态
-     */
-    getConversationNotificationStatus(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<NotificationStatus>;
+     * 删除的 keys
+    */
+    keys?: string[];
     /**
-     * 协议栈获取远端历史消息
-     */
-    getRemoteHistoryMessages(conversationType: ConversationType, targetId: string, timestamp: number, count: number, order: 0 | 1, channelId: string): IPromiseResult<{
-        list: IReceivedMessage[];
-        hasMore: boolean;
-    }>;
+      * 扩展对象
+    */
+    expansion?: {
+        [key: string]: string;
+    };
     /**
-     * 无差别获取本地免打扰列表
-     */
-    getBlockConversationList(): Promise<IAsyncRes<IBaseConversationInfo[]>>;
+      * 是否删除所有扩展
+    */
+    removeAll?: boolean;
+}
+interface IUltraModifyMsgOptions {
+    canIncludeExpansion?: boolean;
+    channelId: string;
+    conversationType: ConversationType;
+    targetId: string;
+    messageUId: string;
+    sendTime: number;
     /**
-     * 无差别获取本地置顶列表
+     * 消息内容
      */
-    getTopConversationList(conversationTypes?: ConversationType[], channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
+    content: {
+        /**
+         * 消息内容 key-value，最终会进行 JSON 序列化后发送
+         */
+        [key: string]: any;
+        /**
+         * 消息可携带的用户数据
+         */
+        user?: IUserProfile;
+        /**
+         * 其他拓展信息
+         */
+        extra?: string;
+    };
+}
+interface IUltraMsgQueryInfo {
+    sendTime: number;
+    messageUId: string;
+    channelId?: string;
+}
+interface IUltraMsgQueryOptions {
+    conversationType: ConversationType;
+    targetId: string;
+    messages: IUltraMsgQueryInfo[];
+}
+/**
+ * 被拦截的消息信息
+ * @category Interface
+ */
+interface IBlockedMessageInfo {
+    blockedMessageUId: string;
+    conversationType: number;
+    targetId: string;
+    channelId: string;
+    blockType: MessageBlockType;
+    extra: any;
+    sourceType?: MessageBlockSourceType;
+    sourceContent?: {
+        [key: string]: any;
+    };
+}
+/**
+ * 超级群获取指定会话未读 @ 消息列表参数
+*/
+interface IUltraGroupUnreadMentionedOption {
     /**
-     * 获取单个群聊会话 @ 消息未读数
-     */
-    getUnreadMentionedCount(conversation: IConversationOption): Promise<IAsyncRes<number>>;
+     * 会话 ID
+    */
+    targetId: string;
     /**
-     * 获取所有群聊会话 @ 消息未读数
-     */
-    getAllUnreadMentionedCount(): Promise<IAsyncRes<number>>;
-    clearData(): Promise<IAsyncRes<boolean>>;
+     * 频道 ID
+    */
+    channelId?: string;
     /**
-     * 获取运行时的系统信息，仅限 Electron 平台可用
-     */
-    getOSInfo(): IPromiseResult<IOSInfo>;
+     * 消息的时间戳，首次获取传 0， 后续查询传未读 @ 列表中的消息时间戳
+    */
+    sentTime: number;
     /**
-     * 获取应用主进程信息，仅限 Electron 平台可用
-     */
-    getMainProcessInfo(): IPromiseResult<IProcessInfo>;
+     * 数据个数，最大50
+    */
+    count: number;
+}
+/**
+ * 超级群获取指定会话 @ 未读消息列表结果
+*/
+interface IUltraUnreadMsg {
     /**
-     * 设置代理
-     */
-    setProxy(proxy: IProxy | null): IPromiseResult<IProxy>;
+     * 消息 ID
+    */
+    messageUId?: string;
     /**
-     * 获取代理
-     */
-    getProxy(): IPromiseResult<IProxy>;
+     * 消息时间戳
+    */
+    sentTime: number;
     /**
-     * 测试代理
-     */
-    testProxy(proxy: IProxy, testHost: string): Promise<IResponse>;
-    rtcPing(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<any>>;
-    rtcSignaling(roomId: string, method: string, isQuery: boolean, sourceData: any): Promise<{
-        code: ErrorCode;
-        buffer?: any;
-    }>;
+     * @ 类型： 1 所有人；2: 部分人
+    */
+    mentionedType?: number;
+}
+
+interface IRTCRoomInfo {
+    roomId: string;
+    roomData: unknown[];
+    userCount: number;
+    list: unknown[];
+}
+interface IRtcTokenData {
+    rtcToken: string;
+}
+interface IRTCUsers {
+    users: {
+        [userId: string]: {
+            /**
+             * 发布的资源数据，是一个 JSON 字符串，解析后为发布的资源列表
+             */
+            uris?: string;
+            /**
+             * 加房间的身份标识，保存主房间 roomId
+             */
+            extra?: string;
+        };
+    };
+}
+interface IJoinRTCRoomData extends IRTCUsers {
+    token: string;
+    sessionId: string;
+    roomInfo: {
+        key: string;
+        value: string;
+    }[];
+    kvEntries: IServerRTCRoomEntry[];
+    offlineKickTime: number;
+}
+interface KVString {
+    [key: string]: string;
+}
+/**
+ * 设置 RTC 人员 inner、outer 数据
+ */
+interface IRTCUserData {
+    [key: string]: string;
 }
 
 interface IExpansionMsgContent {
@@ -5197,6 +5202,7 @@ declare class APIContext {
      * rtc 数据变更通知 pluginContext
      */
     private _rtcDataChange;
+    private _meetingEvent;
     /**
      * 导航数据变更通知
      */
@@ -5267,6 +5273,10 @@ declare class APIContext {
      * @param listener
      */
     registerRTCSignalingListener(listener?: (buffer: Uint8Array) => void): void;
+    /**
+     * 监听 RTC Meeting 下行信令通知
+     */
+    registerMeetingEventListener(listener?: (eventType: MeetingEventType, buffer: Uint8Array) => void): void;
     checkSearchPropsMsg(messageType: string, msgContent: any): IAsyncRes;
     /**
      * 发送消息
@@ -5386,13 +5396,7 @@ declare class APIContext {
      */
     getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId?: string): Promise<IAsyncRes<IReceivedMessage | null>>;
     /**
-     * 按UIds批量获取消息
-     * @param msgUids
-     * @returns
-     */
-    getMessageByUids(msgUids: string[]): IReceivedMessage[];
-    /**
-     * 会话内按msgUids批量获取消息
+     * 按msgUids批量获取消息
      */
     getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
     /**
@@ -6164,6 +6168,10 @@ declare class RTCPluginContext extends PluginContext {
      * @param listener
      */
     registerRTCSignalListener(listener?: (buffer: Uint8Array) => void): void;
+    /**
+     * 监听 RTC Meeting 下行信令通知
+     */
+    registerMeetingEventListener(listener?: (eventType: MeetingEventType, buffer: Uint8Array) => void): void;
     /**
      * RTC 调用 signal 服务的通用接口
      * @param roomId 房间 ID
@@ -6214,6 +6222,7 @@ interface IEngineWatcher extends IConnectionListener {
      * RTC 数据变更
      */
     onRTCDataChange: (data: IServerRTCRoomEntry[], roomId?: string) => void;
+    onMeetingEvent: (eventType: number, buffer?: Uint8Array) => void;
     pullFinished: () => void;
     messageDelivered: (data: IMessageDeliver[]) => void;
     groupMessageDeliveredStatus: (data: IGroupMessageDeliverStatus) => void;
@@ -6242,11 +6251,16 @@ declare abstract class AEngine {
      */
     constructor(runtime: IRuntime, rtcCodec: Codec<RTCKeyMaps>, _watcher: IEngineWatcher, _options: IAPIContextOption, logger: BasicLogger);
     protected _rtcSignalingListener?: (buffer: Uint8Array) => void;
+    protected _meetingEventListener?: (eventType: MeetingEventType, buffer: Uint8Array) => void;
     /**
      * 注册 RTC KV 变更监听器
      * @param listener
      */
     registerRTCSignalingListener(listener: ((buffer: Uint8Array) => void) | undefined): void;
+    /**
+     * 注册Meeting事件监听器
+     */
+    registerMeetingEventListener(listener: ((eventType: MeetingEventType, buffer: Uint8Array) => void) | undefined): void;
     /**
      * 忽视缓存，重新请求导航数据
      */
@@ -6424,11 +6438,6 @@ declare abstract class AEngine {
      * 获取第一个未读消息
      */
     abstract getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
-    /**
-     * 按msgUids批量获取消息
-     * @param msgUids
-     */
-    abstract getMessageByUids(msgUids: string[]): IReceivedMessage[];
     /**
      * 按msgUids批量获取消息
      */
@@ -6987,6 +6996,7 @@ declare abstract class AEngine {
      * 接收 rtc 资源变更
      */
     protected _receiveRtcKv(buffer: Uint8Array): void;
+    protected _receiveMeetingEvent(eventType: MeetingEventType, buffer: Uint8Array): void;
     /**
      * Engine 反初始化
      */
@@ -7560,4 +7570,4 @@ declare type AbsCodec<T> = Codec<T>;
  */
 declare const version: string;
 
-export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AssertRules, BAIDU_STORAGE_SERVER_URI, BasicLogger, BasicNavi, BasicReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType, Codec, CodecPBMaps, ConnectionStatus, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DEFAULT_LOG_POLICY, DelayTimer, EnableLogL, ErrorCode, EventEmitter, FORMATED_VERSION, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBlockedMessageInfo, ICancelRoomPKOptions, IChannelAndUserGroupChangeData, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionListener, IConnectionStatusListener, IConversationIdentifier, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IGroupMessageDeliveredStatusInfo, IInsertMessage, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogDB, ILogData, ILogger, IM_CHATROOM_PULL_INTERVAL_TIME, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageDeliver, IMessageDeliveredListener, IMessageListnenr, IMessageReader, IMessageReaderResponse, IMetionedData, INaviCache, INaviInfo, IOSInfo, IOperateInfo, IOperateStatusNotify, IOperateSummary, IPluginGenerator, IProcessCache, IProcessInfo, IPromiseResult, IProxy, IPushConfig, IRTCInnerListener, IRTCJoinedInfo, IRTCRoomBindOption, IRTCRoomInfo, IRTCUserData, IRTCUsers, IReadReceiptInfo, IRecallMsgContent, IRecallMsgOptions, IReceivedConversation, IReceivedConversationByTag, IReceivedMessage, IRemoveChatRoomEntries, IRemoveChatRoomEntry, IRemoveChatroomEntries, IRemoveChatroomEntry, IReqRoomPKOptions, IRequest, IResRoomPKOptions, IResponse, IRtcTokenData, IRuntime, ISendExMsgOptions, ISendMsgOptions, IServerConversationStatus, IServerRTCRoomEntry, IServerUserSetting, ISetConversationStatusOptions, IStorage, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserGroupChangeData, IUserGroupStatusInfo, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, RTCKeyMaps as InnerRTCKeyMaps, ItypingStateListener, KVString, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_SOCKET_CONNECT_URIS, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PUBLIC_CLOUD_NAVI_URIS, PluginContext, QINIU_STORAGE_SERVER_URI, RCAssertError, RCConnectionStatus, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATUS_MESSAGE, STORAGE_ROOT_KEY, SentStatus, StoreKeys, TagChangeType, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, UserGroupChangeType, VERSION, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketNavi, appendUrl, assert, clone, cloneByJSON, deInitLogDB, logger as engineLogger, forEach, getBrowser, getClientMessageId, getMimeKey, getUUID, getUUID22, getUploadFileName, indexOf, initLogDB, isArray, isArrayBuffer, isBoolean, isConnnectAckCode as isConnnectAck, isDisconnectCode as isDisconnectedByServer, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isTypeInConversationList, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, transcsv, usingCppEngine, validate, version };
+export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AssertRules, BAIDU_STORAGE_SERVER_URI, BasicLogger, BasicNavi, BasicReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType, Codec, CodecPBMaps, ConnectionStatus, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DEFAULT_LOG_POLICY, DelayTimer, EnableLogL, ErrorCode, EventEmitter, FORMATED_VERSION, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBlockedMessageInfo, ICancelRoomPKOptions, IChannelAndUserGroupChangeData, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionListener, IConnectionStatusListener, IConversationIdentifier, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IGroupMessageDeliveredStatusInfo, IInsertMessage, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogDB, ILogData, ILogger, IM_CHATROOM_PULL_INTERVAL_TIME, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageDeliver, IMessageDeliveredListener, IMessageListnenr, IMessageReader, IMessageReaderResponse, IMetionedData, INaviCache, INaviInfo, IOSInfo, IOperateInfo, IOperateStatusNotify, IOperateSummary, IPluginGenerator, IProcessCache, IProcessInfo, IPromiseResult, IProxy, IPushConfig, IRTCInnerListener, IRTCJoinedInfo, IRTCRoomBindOption, IRTCRoomInfo, IRTCUserData, IRTCUsers, IReadReceiptInfo, IRecallMsgContent, IRecallMsgOptions, IReceivedConversation, IReceivedConversationByTag, IReceivedMessage, IRemoveChatRoomEntries, IRemoveChatRoomEntry, IRemoveChatroomEntries, IRemoveChatroomEntry, IReqRoomPKOptions, IRequest, IResRoomPKOptions, IResponse, IRtcTokenData, IRuntime, ISendExMsgOptions, ISendMsgOptions, IServerConversationStatus, IServerRTCRoomEntry, IServerUserSetting, ISetConversationStatusOptions, IStorage, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserGroupChangeData, IUserGroupStatusInfo, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, RTCKeyMaps as InnerRTCKeyMaps, ItypingStateListener, KVString, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_SOCKET_CONNECT_URIS, MeetingEventType, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PUBLIC_CLOUD_NAVI_URIS, PluginContext, QINIU_STORAGE_SERVER_URI, RCAssertError, RCConnectionStatus, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATUS_MESSAGE, STORAGE_ROOT_KEY, SentStatus, StoreKeys, TagChangeType, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, UserGroupChangeType, VERSION, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketNavi, appendUrl, assert, clone, cloneByJSON, deInitLogDB, logger as engineLogger, forEach, getBrowser, getClientMessageId, getMimeKey, getUUID, getUUID22, getUploadFileName, indexOf, initLogDB, isArray, isArrayBuffer, isBoolean, isConnnectAckCode as isConnnectAck, isDisconnectCode as isDisconnectedByServer, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isTypeInConversationList, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, transcsv, usingCppEngine, validate, version };