@rongcloud/engine 5.7.2-alpha.1 → 5.7.2-beem.2

package/index.d.ts

@@ -454,7 +454,7 @@ declare enum ErrorCode {
      */
     CHATROOM_KV_OVERWRITE_INVALID = 23424,
     /**
-     * 聊天室 KV 存储功能没有开通
+     * 未开通聊天室属性自定义设置。请在开发者后台"免费基础功能"页面开通"聊天室属性自定义设置
      */
     CHATROOM_KV_STORE_NOT_OPEN = 23426,
     /**
@@ -1462,7 +1462,8 @@ declare enum LogTagId {
     A_SET_MSG_CONTENT_O = "A_SET_MSG_CONTENT_O",
     A_REMOVE_PROXY_O = "A-remove_proxy-O",
     A_SET_PROXY_O = "A-set_proxy-O",
-    A_TEST_PROXY_O = "A-test_proxy-O"
+    A_TEST_PROXY_O = "A-test_proxy-O",
+    L_WEBSOCKET_DISACCORD_E = "L-websocket_disaccord-e"
 }
 
 /**
@@ -1530,7 +1531,8 @@ declare enum UltraMsgChangeType {
     MSG_EXPANSION = 1,
     MSG_MODIFY = 2,
     MSG_RECALL = 3,
-    CHANNEL_CHANGE = 4
+    CHANNEL_CHANGE = 4,
+    USER_GROUP_CHANGE = 5
 }
 /** PB 结构 MsgChange 属性 subChangeType 对应枚举值 */
 declare enum UltraMsgSubChangeType {
@@ -1541,6 +1543,13 @@ declare enum UltraMsgSubChangeType {
     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
+}
 
 /**
  * 音视频模式
@@ -1686,10 +1695,33 @@ interface IAndroidPushConfig {
      * 小米的 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
      */
@@ -1916,6 +1948,10 @@ interface IReceivedMessage {
      * 拉取历史消息时表示该消息是否为超级群频道类型（仅超级群有效）
      */
     channelType?: UltraGroupChannelType;
+    /**
+    * 扩展内容
+    */
+    extraContent?: string;
 }
 /**
  * @category Interface
@@ -2134,6 +2170,10 @@ interface ISendMsgOptions {
      * 超级群专有字段，是否断档，若断档需要客户判断是否拉取
      */
     isInterrupt?: boolean;
+    /**
+    * 标识该消息是否为重发消息，仅 electron 中有效。
+    */
+    isResend?: boolean;
 }
 interface IInsertMsgOptions {
     senderUserId: string;
@@ -2958,6 +2998,7 @@ declare enum NetworkType {
     UNKONWN = "unknown"
 }
 interface IWebSocket {
+    id: number;
     /**
      * 监听连接建立事件，此时 WebSocket 实例已准备好收发数据
      * @param callback
@@ -3047,7 +3088,32 @@ interface IExtraMethod {
 }
 
 /**
- * 导航信息数据就结构
+ * 连接协议
+ * 截止 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 {
     /**
@@ -3074,15 +3140,18 @@ interface INaviInfo {
     /**
      * CMP 服务 Websocket 连接地址，包含域名与端口，不含 ws 或 wss 协议头
      * @example a.domain.com:443
+     * @note 在 V2 版本废弃
      */
     server: string;
     /**
      * 备用 CMP 服务地址，包含域名与端口，不含 ws 或 wss 协议头，多个备用地址以 ',' 分割
      * @example a.domain.com:443,b.domain.com:443
+     * @note 在 V2 版本废弃
      */
     backupServer?: string;
     /**
      * 备用 CMP 服务地址，POST 请求 TCP 连接返回的是 bs 字段，非 backupServer 字段
+     * @note 在 V2 版本废弃
      */
     bs?: string;
     /**
@@ -3121,6 +3190,7 @@ interface INaviInfo {
      * @description
      * 1. 公有云下，该地址为七牛云服务器地址
      * 2. 私有云下，该地址为私有云自研文件服务器地址
+     * @note 在 V2 版本废弃
      */
     uploadServer: string;
     /**
@@ -3169,6 +3239,7 @@ interface INaviInfo {
      * @todo
      * 1. 确定其控制的功能
      * 2. 确定 web 相关性
+     * @note 在 V2 版本废弃
      */
     isFormatted: number;
     /**
@@ -3203,6 +3274,7 @@ interface INaviInfo {
      * 百度 BOS 存储服务地址
      * @description 公有云独有配置
      * @example `gz.bcebos.com`
+     * @deprecated 已废弃
      */
     bosAddr?: string;
     /**
@@ -3259,6 +3331,7 @@ interface INaviInfo {
     onlinelogserver?: string;
     /**
      * 链路加密字段，内容为 JSON 字符串，仅限 C++ 可用
+     * @note 在 V2 版本废弃
      */
     crypto?: string;
     /**
@@ -3273,6 +3346,24 @@ interface INaviInfo {
      * 鉴权认证
      */
     jwt?: string;
+    /**
+     * 数据中心
+     */
+    dc?: string;
+    /**
+     * 是否开启 tls
+     */
+    openTLS?: number;
+    /**
+     * V2 版本中新增字段
+     * 服务地址列表
+     */
+    serverAddr?: ICmpData[];
+    /**
+     * V2 版本中新增字段
+     * 新版本控制tag
+     */
+    excludeLogTag?: string;
 }
 
 declare type INaviCache = {
@@ -3324,7 +3415,17 @@ declare abstract class BasicNavi {
      * @param timeout 请求超时时间
      * @param traceId
      */
-    protected abstract httpRequest(uri: string, appkey: string, token: string, version: string, timeout: number, traceId: string): IPromiseResult<INaviInfo>;
+    protected abstract httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
+    /**
+     * 向目标导航服务发送请求
+     * @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>;
     /**
      * 转换 Navi 接口 HTTP 请求状态码为 ErrorCode 定义
      * @param code
@@ -3353,6 +3454,12 @@ declare abstract class BasicNavi {
      * @param voipCallInfo
      */
     updateVoipCallInfo(token: string, voipCallInfo: string): void;
+    protected getNaviV2RequestOption(option: INaviRequestOption): IRequest;
+    /**
+     * 是否使用 v2 版本导航
+     * 仅私有云 rcx 使用 v1 版本
+     */
+    useV2Navi(): boolean;
 }
 
 /**
@@ -3368,8 +3475,9 @@ declare class WebSocketNavi extends BasicNavi {
     /**
      * 小程序平台服务地址，多个地址以 ',' 分割
      */
-    miniCmpUris: string, navigators?: string[]);
-    protected httpRequest(uri: string, appkey: string, token: string, version: string, timeout: number, traceId: string): IPromiseResult<INaviInfo>;
+    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;
 }
@@ -3537,6 +3645,11 @@ declare abstract class AConnectionMgr {
      * @returns
      */
     getCurrentUserId(): string;
+    /**
+     * 缓存的 cmp 权重
+     * disconnect 时重置
+     */
+    private cmpWeightCache?;
     /**
      * 修改连接状态
      * @param status
@@ -3636,6 +3749,15 @@ declare abstract class AConnectionMgr {
      * 清理重连计时器
      */
     private stopReconnectTimer;
+    /**
+     * 获取 CMP 列表
+     */
+    protected getCmpList(navi: INaviInfo, isTcp?: boolean): ICmpData[];
+    /**
+     * 修改 CMP 权重
+     */
+    protected updateCmpWeight(cmpUrl: string, isRise?: boolean): void;
+    private clearCmpWeightCache;
 }
 
 /**
@@ -3826,6 +3948,10 @@ interface IEngine {
      * 获取第一个未读消息
      */
     getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
+    /**
+     * 按msgUids打量获取消息
+     */
+    getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
     /**
      * 设置/保存指定会话消息草稿
      * @draft 草稿内容
@@ -4089,6 +4215,10 @@ interface IEngine {
      * 获取消息
      */
     getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
+    /**
+     * 设置消息附加信息
+     */
+    setTextMessageExtra(messageId: number, content: any): Promise<ErrorCode>;
     /**
      * 设置消息内容
      */
@@ -4420,9 +4550,6 @@ interface IEndRoomPKOptions {
     keys: string[];
 }
 
-/**
- * 消息送达相关接口
- */
 /**
  * 送达的用户信息
  * @hidden
@@ -4466,6 +4593,29 @@ interface IGroupMessageDeliverStatus {
     list: IGroupMessageDeliveredStatusInfo[];
 }
 
+/**
+* 用户组变更数据
+*/
+interface IUserGroupChangeData {
+    conversation: IConversationIdentifier;
+    userGroupIds: string[];
+}
+/**
+* 频道和用户组关系变更数据
+*/
+interface IChannelAndUserGroupChangeData {
+    conversation: IConversationOption;
+    channelType: UltraGroupChannelType;
+    userGroupIds: string[];
+}
+interface IUserGroupStatusInfo {
+    userGroupDisband?: IUserGroupChangeData[];
+    userAdded?: IUserGroupChangeData[];
+    userRemoved?: IUserGroupChangeData[];
+    userGroupBindChannel?: IChannelAndUserGroupChangeData[];
+    userGroupUnBindChannel?: IChannelAndUserGroupChangeData[];
+}
+
 /**
  * 定义已废弃，请使用 `IRemoveChatroomEntries` 替换
  * @deprecated
@@ -4621,6 +4771,14 @@ declare const deInitLogDB: () => Promise<void>;
  */
 declare const transcsv: (log: ILogData) => string;
 
+/**
+ * 会话标识
+ * @category Interface
+ */
+interface IConversationIdentifier {
+    conversationType: ConversationType;
+    targetId: string;
+}
 /**
  * 会话属性
  * @category Interface
@@ -4745,11 +4903,6 @@ interface IWatcher {
     conversationState?: IConversationStateListener;
     chatroomState?: IChatroomListener;
     expansion?: IExpansionListener;
-    /**
-     * 为兼容老版本 RTCLib 与 CallLib 接收消息的方式，新版本消息走插件机制
-     * @deprecated
-     */
-    rtcInnerWatcher?: IRTCInnerListener;
     /**
      * 标签的增删改监听
      */
@@ -4786,6 +4939,7 @@ interface IWatcher {
     ultraGroupChannelChangeType?: (list: IUltraChannelChangeInfo[]) => void;
     ultraGroupChannelUserKicked?: (list: IUltraChannelUserKickedInfo[]) => void;
     ultraGroupChannelDelete?: (list: IUltraChannelDeleteInfo[]) => void;
+    userGroupStatus?: (data: IUserGroupStatusInfo) => void;
 }
 interface IAPIContextOption {
     /**
@@ -4918,6 +5072,23 @@ declare class Codec<T> {
     private fixInt64Values;
 }
 
+declare const keymaps: CodecPBMaps;
+/**
+ * 仅限 IM 内部包使用，禁止 RTCLib 直接使用从而导致业务依赖
+ */
+declare type RTCKeyMaps = typeof keymaps;
+
+declare class RTCEntryHandler {
+    private _pullQueue;
+    private _isPulling;
+    private _engine;
+    private _pullTime;
+    constructor(engine: AEngine);
+    private _startPull;
+    pullEntry(roomId: string, timestamp: number): void;
+    reset(): void;
+}
+
 declare class APIContext {
     private _runtime;
     private static _context?;
@@ -4941,7 +5112,8 @@ declare class APIContext {
      * RTC 相关的编解码模块，用于向前兼容 RTC 旧版本的编解码，
      * 包括向 CppEngine 提供 RTC 业务编解码能力
      */
-    private readonly _rtcCodec;
+    readonly rtcCodec: Codec<RTCKeyMaps>;
+    readonly rtcKVManager: RTCEntryHandler;
     /**
      * engine 内部日志工具
      */
@@ -5007,6 +5179,7 @@ declare class APIContext {
     private _ultraGroupChannelChangeTypeListener;
     private _ultraGroupChannelUserKickedListener;
     private _ultraGroupChannelDeleteListener;
+    private _userGroupStatusListener;
     /**
      * rtc 数据变更通知 pluginContext
      */
@@ -5194,6 +5367,10 @@ declare class APIContext {
      * 获取第一个未读消息
      */
     getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId?: string): Promise<IAsyncRes<IReceivedMessage | null>>;
+    /**
+     * 按msgUids批量获取消息
+     */
+    getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
     /**
      * 设置会话免打扰
      * 原： setConversationStatus 已废弃
@@ -5207,6 +5384,8 @@ declare class APIContext {
      */
     setConversationNotificationLevel(conversationType: ConversationType, targetId: string, notificationLevel?: NotificationLevel, channelId?: string): Promise<ErrorCode>;
     setConversationStatus(conversationType: ConversationType, targetId: string, isTop?: boolean, notificationStatus?: 1 | 2, channelId?: string): Promise<ErrorCode>;
+    setConversationsMuteStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    setConversationsTopStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
     saveConversationMessageDraft(conversationType: ConversationType, targetId: string, draft: string, channelId?: string): Promise<ErrorCode>;
     getConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId?: string): Promise<IAsyncRes<string>>;
     clearConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId?: string): Promise<ErrorCode>;
@@ -5575,6 +5754,10 @@ declare class APIContext {
      * 获取本地消息
     */
     getMessage(messageId: number | string): Promise<IAsyncRes<IReceivedMessage>>;
+    /**
+     * 设置消息附加信息
+     */
+    setTextMessageExtra(messageId: number, value: string): Promise<ErrorCode>;
     /**
      * 设置消息内容
     */
@@ -5660,74 +5843,7 @@ declare class APIContext {
         code: ErrorCode;
         buffer?: Uint8Array;
     }>;
-    /**
-     * 加入房间
-     * @param roomId
-     * @param mode 房间模式：直播 or 会议
-     * @param mediaType 直播房间模式下的媒体资源类型
-     */
-    joinRTCRoom(roomId: string, mode: RTCMode, mediaType?: number, joinType?: RTCJoinType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): Promise<IAsyncRes<IJoinRTCRoomData>>;
-    quitRTCRoom(roomId: string): Promise<ErrorCode>;
     rtcPing(roomId: string, mode: number, mediaType?: number): Promise<IAsyncRes<any>>;
-    getRTCRoomInfo(roomId: string): Promise<IAsyncRes<IRTCRoomInfo>>;
-    getRTCUserInfoList(roomId: string): Promise<IAsyncRes<IRTCUsers>>;
-    getRTCUserInfo(roomId: string): IPromiseResult<unknown>;
-    setRTCUserInfo(roomId: string, key: string, value: string): Promise<ErrorCode>;
-    removeRTCUserInfo(roomId: string, keys: string[]): Promise<ErrorCode>;
-    setRTCData(roomId: string, key: string, value: string, isInner: boolean, apiType: RTCApiType, message?: {
-        name: string;
-        content: string;
-    }): Promise<ErrorCode>;
-    setRTCTotalRes(roomId: string, message: {
-        name: string;
-        content: string;
-    }, valueInfo: string, objectName: string, mcuValInfo?: string): Promise<ErrorCode>;
-    setRTCCDNUris(roomId: string, objectName: string, CDNUris: string): Promise<ErrorCode>;
-    getRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType): Promise<IAsyncRes<KVString>>;
-    removeRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType, message?: {
-        name: string;
-        content: string;
-    }): Promise<ErrorCode>;
-    setRTCOutData(roomId: string, rtcData: unknown, type: number, message: unknown): Promise<ErrorCode>;
-    getRTCOutData(roomId: string, userIds: string[]): IPromiseResult<unknown>;
-    getRTCToken(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<IRtcTokenData>>;
-    setRTCState(roomId: string, report: string): Promise<ErrorCode>;
-    getRTCUserList(roomId: string): IPromiseResult<IRTCUsers>;
-    /**
-     * 直播观众加房间
-     */
-    joinLivingRoomAsAudience(roomId: string, mode: RTCMode, broadcastType?: number): Promise<IAsyncRes<{
-        token: string;
-        kvEntries: IServerRTCRoomEntry[];
-    }>>;
-    /**
-     * 直播观众退出房间
-     */
-    quitLivingRoomAsAudience(roomId: string): Promise<ErrorCode>;
-    /**
-     * 直播身份切换
-     */
-    rtcIdentityChange(roomId: string, changeType: RTCIdentityChangeType, broadcastType?: number): Promise<IAsyncRes<IJoinRTCRoomData>>;
-    /**
-     * 获取加入 RTC 房间的用户信息（当前仅能查自己的）
-     */
-    getRTCJoinedUserInfo(userId: string): Promise<IAsyncRes<IRTCJoinedInfo[]>>;
-    /**
-     * 连麦 PK 请求
-     */
-    requestRoomPK(options: IReqRoomPKOptions): Promise<ErrorCode>;
-    /**
-     * 取消连麦 PK 请求
-     */
-    cancelRoomPK(options: ICancelRoomPKOptions): Promise<ErrorCode>;
-    /**
-     * 响应连麦 PK 请求
-     */
-    responseRoomPK(options: IResRoomPKOptions): Promise<ErrorCode>;
-    /**
-     * 结束连麦 PK
-     */
-    endRoomPK(options: IEndRoomPKOptions): Promise<ErrorCode>;
     /**
      * SDK设置聊天室关联的rtc房间
      */
@@ -5878,11 +5994,11 @@ declare class RTCPluginContext extends PluginContext {
      */
     rtcPingResVersion(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<any>>;
     /**
-     * @deprecated
+     * @deprecated 兼容 rtc v3 方法调用
      */
     getRTCRoomInfo(roomId: string): IPromiseResult<IRTCRoomInfo>;
     /**
-     * @deprecated
+     * @deprecated 兼容 rtc v3 方法调用
      */
     getRTCUserInfoList(roomId: string): IPromiseResult<IRTCUsers>;
     /**
@@ -5890,11 +6006,11 @@ declare class RTCPluginContext extends PluginContext {
      */
     getRTCUserInfo(roomId: string): IPromiseResult<unknown>;
     /**
-     * @deprecated
+     * @deprecated 兼容 rtc v3 方法调用
      */
     setRTCUserInfo(roomId: string, key: string, value: string): Promise<ErrorCode>;
     /**
-     * @deprecated
+     * @deprecated 兼容 rtc v3 方法调用
      */
     removeRTCUserInfo(roomId: string, keys: string[]): Promise<ErrorCode>;
     /**
@@ -5974,11 +6090,11 @@ declare class RTCPluginContext extends PluginContext {
      */
     getRTCToken(roomId: string, mode: number, broadcastType?: number): IPromiseResult<IRtcTokenData>;
     /**
-     * @deprecated
+     * @deprecated RTC 北极星数据上报
      */
     setRTCState(roomId: string, report: string): Promise<ErrorCode>;
     /**
-     * @deprecated
+     * @deprecated 兼容 rtc v3 方法调用
      */
     getRTCUserList(roomId: string): IPromiseResult<IRTCUsers>;
     /**
@@ -6050,12 +6166,6 @@ declare class RTCPluginContext extends PluginContext {
     getRTCJoinedUserInfo(userId: string): IPromiseResult<IRTCJoinedInfo[]>;
 }
 
-declare const keymaps: CodecPBMaps;
-/**
- * 仅限 IM 内部包使用，禁止 RTCLib 直接使用从而导致业务依赖
- */
-declare type RTCKeyMaps = typeof keymaps;
-
 interface IEngineWatcher extends IConnectionListener {
     /**
      * @param message 消息
@@ -6085,6 +6195,7 @@ interface IEngineWatcher extends IConnectionListener {
     groupMessageDeliveredStatus: (data: IGroupMessageDeliverStatus) => void;
     callInfo: (data: string) => void;
     onNaviDataChange: (naviInfo: INaviInfo) => void;
+    userGroupStatus: (info: IUserGroupStatusInfo) => void;
 }
 /**
  * 引擎定义
@@ -6289,6 +6400,10 @@ declare abstract class AEngine {
      * 获取第一个未读消息
      */
     abstract getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
+    /**
+     * 按msgUids批量获取消息
+     */
+    abstract getMessageByMsgUids(targetId: string, channelId: string, conversationType: ConversationType, msgUids: string[]): IReceivedMessage[];
     /**
      * 设置/保存指定会话消息草稿
      * @draft 草稿内容
@@ -6310,6 +6425,8 @@ declare abstract class AEngine {
      * 批量设置会话 置顶、免打扰
      */
     abstract batchSetConversationStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    abstract setConversationsMuteStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    abstract setConversationsTopStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
     abstract sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, 
     /**
      * c++ 消息写库后存在自增 Id，必要时需要向业务层暴露，JSEngine 无需实现
@@ -6662,6 +6779,10 @@ declare abstract class AEngine {
      * 获取消息
     */
     abstract getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
+    /**
+     * 设置消息附加信息
+     */
+    abstract setTextMessageExtra(messageId: number, value: string): Promise<ErrorCode>;
     /**
      * 设置消息内容
     */
@@ -6817,51 +6938,7 @@ declare abstract class AEngine {
         buffer?: Uint8Array;
     }>;
     abstract rtcPing(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<any>>;
-    joinRTCRoom(roomId: string, mode: RTCMode, broadcastType?: number, joinType?: RTCJoinType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): IPromiseResult<IJoinRTCRoomData>;
-    quitRTCRoom(roomId: string): Promise<ErrorCode>;
-    getRTCRoomInfo(roomId: string): IPromiseResult<IRTCRoomInfo>;
-    getRTCUserInfoList(roomId: string): IPromiseResult<IRTCUsers>;
-    getRTCUserInfo(roomId: string): IPromiseResult<unknown>;
-    setRTCUserInfo(roomId: string, key: string, value: string): Promise<ErrorCode>;
-    removeRTCUserInfo(roomId: string, keys: string[]): Promise<ErrorCode>;
-    setRTCData(roomId: string, key: string, value: string, isInner: boolean, apiType: RTCApiType, message?: {
-        name: string;
-        content: string;
-    }): Promise<ErrorCode>;
-    /**
-     * 全量订阅资源修改
-     * @param roomId 房间 Id
-     * @param message 向前兼容的消息内容
-     * @param valueInfo 全量资源数据
-     * @param objectName 全量 URI 消息名
-     */
-    setRTCTotalRes(roomId: string, message: {
-        name: string;
-        content: string;
-    }, valueInfo: string, objectName: string, mcuValInfo: string): Promise<ErrorCode>;
-    getRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType): IPromiseResult<KVString>;
-    removeRTCData(roomId: string, keys: string[], isInner: boolean, apiType: RTCApiType, message?: {
-        name: string;
-        content: string;
-    }): Promise<ErrorCode>;
-    setRTCOutData(roomId: string, rtcData: unknown, type: number, message: unknown): Promise<ErrorCode>;
-    getRTCOutData(roomId: string, userIds: string[]): IPromiseResult<unknown>;
-    getRTCToken(roomId: string, mode: number, broadcastType?: number): IPromiseResult<IRtcTokenData>;
-    setRTCState(roomId: string, report: string): Promise<ErrorCode>;
-    getRTCUserList(roomId: string): IPromiseResult<IRTCUsers>;
-    joinLivingRoomAsAudience(roomId: string, mode: RTCMode, broadcastType?: number): Promise<IAsyncRes<{
-        token: string;
-        kvEntries: IServerRTCRoomEntry[];
-    }>>;
     pullRTCRoomEntry(roomId: string, _timestamp: number): Promise<IAsyncRes<IChrmKVPullData>>;
-    quitLivingRoomAsAudience(roomId: string): Promise<ErrorCode>;
-    rtcIdentityChange(roomId: string, changeType: RTCIdentityChangeType, broadcastType?: number): Promise<IAsyncRes<IJoinRTCRoomData>>;
-    getRTCJoinedUserInfo(userId: string): Promise<IAsyncRes<IRTCJoinedInfo[]>>;
-    setRTCCDNUris(roomId: string, objectName: string, CDNUris: string): Promise<ErrorCode>;
-    requestRoomPK(options: IReqRoomPKOptions): Promise<ErrorCode>;
-    cancelRoomPK(options: ICancelRoomPKOptions): Promise<ErrorCode>;
-    responseRoomPK(options: IResRoomPKOptions): Promise<ErrorCode>;
-    endRoomPK(options: IEndRoomPKOptions): Promise<ErrorCode>;
     /**
      * 设置聊天室关联的rtc房间
      */
@@ -7061,7 +7138,7 @@ declare function ID(): string;
 /**
  * @deprecated
  */
-declare function init(userLogInfo: any): void;
+declare function init(_logger: BasicLogger): void;
 /**
  * @deprecated
  */
@@ -7348,6 +7425,14 @@ declare const PUBLIC_CLOUD_NAVI_URIS: string[];
  * 小程序 websocket 连接地址
  */
 declare const MINI_SOCKET_CONNECT_URIS: string[];
+/**
+ * 七牛存储服务地址
+ */
+declare const QINIU_STORAGE_SERVER_URI: string;
+/**
+ * 百度存储服务地址
+ */
+declare const BAIDU_STORAGE_SERVER_URI: string;
 /**
  * IM 接口超时时间，单位毫秒
  */
@@ -7435,4 +7520,4 @@ declare type AbsCodec<T> = Codec<T>;
  */
 declare const version: string;
 
-export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AssertRules, 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, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionListener, IConnectionStatusListener, 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, 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, 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, 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, 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 };