@rongcloud/engine 4.5.4-alpha.1 → 4.5.5-enterprise.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /*
- * RCEngine - v4.5.4-alpha.1
- * CommitId - d1ef74bf72f4e0ee7c6b727b0c7358824c4c5d6e
- * Thu Dec 23 2021 18:35:11 GMT+0800 (China Standard Time)
+ * RCEngine - v4.5.5-enterprise.2
+ * CommitId - e6adede2a4aca77ba626cc317bbb4d4895faf00f
+ * Fri Jul 22 2022 11:50:59 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
 /**
@@ -1461,7 +1461,7 @@ declare class DataCodec {
     /**
       * 设置会话状态 (置顶、免打扰)
     */
-    encodeSetConversationStatus(statusList: Array<IServerConversationStatus>): any;
+    encodeSetConversationStatus(statusList: Array<IServerConversationStatus>, conversationUpdatedTime: number): any;
     /**
      * 序列化发送群组已读回执
      */
@@ -3505,14 +3505,22 @@ declare class APIContext {
      * 建立连接，连接失败则抛出异常，连接成功后返回用户 userId，否则返回相应的错误码
      * @param token
      * @param refreshNavi 是否需要重新请求导航，当值为 `false` 时，优先使用有效缓存导航，若缓存失效则重新获取导航
+     * @param reconnectKickEnable 设置断线重连时是否踢出当前正在重连的设备 (仅 Electron 环境有效)
+     *  同一个账号在一台新设备上登录的时候，会把这个账号在之前登录的设备上踢出。
+        由于 SDK 有断线重连功能，存在下面情况。
+        用户在 A 设备登录，A 设备网络不稳定，没有连接成功，SDK 启动重连机制。
+        用户此时又在 B 设备登录，B 设备连接成功。
+        A 设备网络稳定之后，用户在 A 设备连接成功，B 设备被踢出。
+        这个字段就是为这种情况加的。
+        设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
      */
-    connect(token: string, refreshNavi?: boolean): Promise<IConnectResult>;
+    connect(token: string, refreshNavi?: boolean, reconnectKickEnable?: boolean): Promise<IConnectResult>;
     /**
      * 拉取实时配置 web 端需更新 voipCall 字段
      */
     private _pullUserSettings;
     disconnect(): Promise<void>;
-    reconnect(): Promise<IConnectResult>;
+    reconnect(reconnectKickEnable?: boolean): Promise<IConnectResult>;
     private _getTokenWithoutNavi;
     /**
      * 获取当前缓存的导航数据
@@ -3593,6 +3601,10 @@ declare class APIContext {
      * 清除会话消息未读数
      */
     clearUnreadCount(conversationType: ConversationType, targetId: string, channelId?: string): Promise<ErrorCode>;
+    /**
+     * 清除全部会话消息未读数
+     */
+    clearAllUnreadCount(): Promise<ErrorCode>;
     /**
      * 获取指定会话消息未读数
      */
@@ -3976,8 +3988,9 @@ interface IEngine {
      * 建立连接
      * @param token
      * @param naviInfo
+     * @param reconnectKickEnable
      */
-    connect(token: string, naviInfo: INaviInfo, versionInfo: string): Promise<ErrorCode>;
+    connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean): Promise<ErrorCode>;
     /**
      * 上报版本信息
      * @param version
@@ -4653,8 +4666,9 @@ declare abstract class AEngine implements IEngine {
      * 建立连接
      * @param token
      * @param naviInfo
+     * @param reconnectKickEnable
      */
-    abstract connect(token: string, naviInfo: INaviInfo): Promise<ErrorCode>;
+    abstract connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean): Promise<ErrorCode>;
     /**
      * 发送SDK版本
      * @param versionInfo
@@ -4775,6 +4789,10 @@ declare abstract class AEngine implements IEngine {
      * 清除指定会话未读数
      */
     abstract clearConversationUnreadCount(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    /**
+     * 清除全部会话未读数
+     */
+    abstract clearAllUnreadCount(): Promise<ErrorCode>;
     /**
      * 获取第一个未读消息
      */