@rongcloud/engine 5.32.0-c-dq.3 → 5.32.1-c-test-alpha.1

package/index.d.ts

@@ -557,10 +557,6 @@ declare const Log: {
     readonly A_UPDATE_MY_USER_PROFILE_R: "A-update_my_user_profile-R";
     readonly A_GET_CONVERSATIONS_INCLUDING_ROBOTS_T: "A-get_conversations_including_robots-T";
     readonly A_GET_CONVERSATIONS_INCLUDING_ROBOTS_R: "A-get_conversations_including_robots-R";
-    readonly L_PULL_SG_UNREAD_COUNT_T: "L-pull_sg_unread_count-T";
-    readonly L_PULL_SG_UNREAD_COUNT_R: "L-pull_sg_unread_count-R";
-    readonly A_MARK_REMOTE_CONVERSATION_AS_READ_T: "A-mark_remote_conversation_as_read-T";
-    readonly A_MARK_REMOTE_CONVERSATION_AS_READ_R: "A-mark_remote_conversation_as_read-R";
 };
 
 /** [EN]
@@ -3120,18 +3116,6 @@ declare enum ErrorCode {
      * @since 5.26.0
      */
     INVALID_PARAMETER_MESSAGE_INFO_MAP = 34345,
-    /**
-     * 34435
-     * 服务端记录会话未读数功能开启时禁止调用此方法
-     * @since 5.32.0
-     */
-    SERVER_RECORD_UNREAD_COUNT_ENABLED_FORBIDDEN = 34435,
-    /**
-     * 34436
-     * 服务端记录会话未读数功能未开启
-     * @since 5.32.0
-     */
-    SERVER_RECORD_UNREAD_COUNT_DISABLED = 34436,
     /**
      * 35001
      * 【已废弃】群组信息异常
@@ -4557,10 +4541,6 @@ declare const FilterRobotType: {
 };
 declare type FilterRobotType = (typeof FilterRobotType)[keyof typeof FilterRobotType];
 
-/** [EN]
- * Message moderation status
- * @category Enum
- */
 /**
  * 消息审核类型
  * @category Enum
@@ -6345,7 +6325,7 @@ interface IReadReceiptData {
  * @since 5.9.0
  * @hidden
  */
-interface IPrivateReadReceiptData extends IConversationIdentifier {
+interface IPrivateReadReceiptData extends IConversationOption {
     /**
      * 最后已读消息时间 (单聊)
      */
@@ -6357,7 +6337,7 @@ interface IPrivateReadReceiptData extends IConversationIdentifier {
  * @since 5.9.0
  * @hidden
  */
-interface IGroupReadReceiptData extends IConversationIdentifier {
+interface IGroupReadReceiptData extends IConversationOption {
     /**
      * 已读人数 (群聊)
      */
@@ -6377,7 +6357,7 @@ interface IGroupReadReceiptData extends IConversationIdentifier {
  * @since 5.9.0
  * @hidden
  */
-interface ISyncReadStatusData extends IConversationIdentifier {
+interface ISyncReadStatusData extends IConversationOption {
     /**
      * 已读消息时间
      */
@@ -6435,23 +6415,15 @@ interface IMessageExtraData {
      */
     sentTime?: number;
 }
+/** [EN]
+ * Message data received from the server
+ * @category Interface
+ */
 /**
- * 内部消息结构定义，上面会携带一些不适合透漏给业务层的字段定义，用于内部业务处理。
- * @hidden
+ * 从服务端接收到的消息数据
+ * @category Interface
  */
-interface IInnerMessage<T = any> {
-    /**
-     * 内部数据，用于内部业务处理
-     * @hidden
-     */
-    __innerData__?: {
-        /**
-         * 接收到的该条撤回消息，是否保持本地未读数不变，仅当消息为 RC:RcCmd 撤回消息时有效
-         * * 开启服务器记录会话未读数功能时，从服务器解析获取。
-         * * 未开启服务器记录会话未读数功能时，该值默认赋值为 false，表示需要本地未读数 -1，保持原有逻辑不变
-         */
-        keepUnreadCount?: boolean;
-    };
+interface IReceivedMessage<T = any> {
     /** [EN]
      * The business identifier of the conversation
      */
@@ -6710,22 +6682,11 @@ interface IInnerMessage<T = any> {
      */
     modifyInfo?: MessageModifyInfo;
     /**
-     * 业务层发送消息时的透传数据，仅允许通过 serverApi 进行发送，SDK 不支持发送该字段
+     * 业务层发送消息时的透传数据，仅允许通过 serverApi 进行发送，SDK 不发送支持自定义
      * @hidden 暂为和讯网定制化需求
-     * @since 5.30.1
      */
     extraData?: IMessageExtraData;
 }
-/** [EN]
- * Message data received from the server
- * @category Interface
- */
-/**
- * 从服务端接收到的消息数据
- * @category Interface
- */
-interface IReceivedMessage<T = any> extends Omit<IInnerMessage<T>, '__innerData__'> {
-}
 /** [EN]
  * First unread message information
  * @category Interface
@@ -7397,7 +7358,7 @@ interface MentionedInfo {
 /**
  * @category Interface
  */
-interface IClearMessageOption extends IConversationIdentifier {
+interface IClearMessageOption extends IConversationOption {
     /** [EN]
      * Timestamp
      */
@@ -7465,7 +7426,7 @@ interface IModifyMessageParams {
     /**
      * 会话信息
      */
-    conversation: IConversationIdentifier;
+    conversation: IConversationOption;
 }
 /**
  * 刷新引用消息参数
@@ -7479,7 +7440,7 @@ interface IRefreshReferenceMessageParams {
     /**
      * 会话信息
      */
-    conversationIdentifier: IConversationIdentifier;
+    conversationIdentifier: IConversationOption;
     /**
      * 本地消息回调
      */
@@ -9882,10 +9843,9 @@ declare class EventDispatcher<T> {
      * 连接目标事件监听器，本实例派发的事件会被传递给入参事件监听器
      * 举例：a.pipe(b) 后，当 a.emit 后，b 的所有监听器也会触发，但会晚于所有 a 的监听器；
      * @param emitter
-     * @param types 指定事件类型列表，如果指定，则只有指定类型的事件会被传递给入参事件监听器
      * @hidden
      */
-    pipe(emitter: EventDispatcher<T>, types?: Array<keyof T>): void;
+    pipe<K extends T>(emitter: EventDispatcher<K>): void;
 }
 
 declare class RCResult<T = void> {
@@ -10338,8 +10298,8 @@ interface INaviInfo {
     grpRRVer?: number;
     /**
      * 会话驱动类型
-     * * 0: 默认，客户端离线消息驱动计算未读数 (客户端通过 pullMsg 结果计算)
-     * * 1: 服务端会话驱动计算未读数 (调用 pullSes 进行初始化),暂只影响更新会话已读时间接口
+     * 0: 默认，客户端离线消息驱动计算未读数 (客户端通过 pullMsg 结果计算)
+     * 1: 服务端会话驱动计算未读数 (调用 pullSes 进行初始化),暂只影响更新会话已读时间接口
      */
     sesDriven?: number;
     /**
@@ -10457,13 +10417,6 @@ interface INaviInfo {
      * 2. 拉取历史消息时，不再返回 RC:RcCmd 消息。
      */
     supportRecallRefactor?: 0 | 1;
-    /**
-     * 是否开启服务器记录单群聊会话未读数；
-     * 0: 关闭，未读数由客户端计算，保持原有逻辑不变；
-     * 1: 开启，未读数由服务器保存，SDK 连接后先同步服务器未读数信息，再拉离线消息。
-     * @since 5.34.0
-     */
-    serverSaveUnread?: 0 | 1;
 }
 
 /** [EN]
@@ -12248,10 +12201,6 @@ interface IIPCMethods {
      * 连接时间
      */
     getConnectedTime(): number;
-    /**
-     * 忽视缓存，重新请求导航数据
-     */
-    refetchNaviInfo(): Promise<RCResult<INaviInfo | null>>;
     /**
      * 获取历史消息
      */
@@ -12561,6 +12510,12 @@ interface IIPCMethods {
      * 获取当前 userId
      */
     getCurrentUserId(): string;
+    /**
+     * 设置用户在线状态监听器
+     */
+    setUserStatusListener(config: {
+        userIds: string[];
+    }, listener: Function): void;
     /**
      * 设置当前用户在线状态
      */
@@ -12669,10 +12624,6 @@ interface IIPCMethods {
      * 删除时间戳前的未读数
      */
     clearUnreadCountByTimestamp(conversation: IConversationIdentifier, timestamp: number): Promise<RCResult>;
-    /**
-     * 标记远程会话为已读，发送 SRSMsg 消息到服务器，并在发送成功后清理本地未读数信息
-     */
-    markRemoteConversationAsRead(identifier: IConversationIdentifier, sendOpts: IMessageSendOptions, traceId: string): Promise<RCResult>;
     /**
      * 获取所有群聊会话 @ 消息未读数，不包含超级群会话
      */
@@ -13006,15 +12957,14 @@ interface IIPCMethods {
 
 /**
  * 连接事件监听器
+ * @typeParam T - onConnected 是否包含 fromSuspend 参数
  */
-declare type IConnectionListener = {
+declare type IConnectionListener<T extends boolean = false> = {
     /**
      * 连接成功
      * @description 仅 Electron 平台会返回 processCache 参数，用于同步主进程缓存数据
-     * @param fromSuspend 是否从暂停状态连接
-     * @param processCache 主进程缓存数据，仅 Electron 平台有效
      */
-    onConnected(fromSuspend: boolean, processCache?: IProcessCache): void;
+    onConnected: T extends true ? (fromSuspend: boolean) => void : (processCache?: IProcessCache) => void;
     /**
      * 连接中止，SDK 内部会进行重连
      * @param code 中止原因
@@ -13287,7 +13237,7 @@ interface IUserGroupStatusInfo {
     userGroupUnBindChannel?: IChannelAndUserGroupChangeData[];
 }
 
-interface IEngineWatcher extends IConnectionListener {
+interface IEngineWatcher extends IConnectionListener<false> {
     /**
      * @param message 消息
      * @param leftCount 参数废弃，值始终为 undefined
@@ -13673,12 +13623,12 @@ declare abstract class BasicLogger {
     protected readonly _appkey: string;
     protected readonly _id: string;
     protected readonly _type: LogType;
-    protected readonly proxy: LogDBProxy;
+    protected readonly logDB: LogDBProxy;
     /**
      * traceId 计数
      */
     private static _traceIdCount;
-    constructor(_appkey: string, _id: string, _type: LogType, proxy: LogDBProxy);
+    constructor(_appkey: string, _id: string, _type: LogType, logDB: LogDBProxy);
     protected _write(logData: ILogData): void;
     /**
      * 生成事务追踪 ID，全局唯一，便于跨进程、异步事务追踪，需要考虑多进程
@@ -14929,9 +14879,7 @@ declare class DataHosting extends BaseModule {
 /**
  * 会话聊天模块
  */
-interface IChatService extends Pick<IIPCMethods, 'getTotalUnreadCount' | 'getConversation' | 'batchSetConversationToTop' | 'batchSetConversationNotificationLevel' | 'getConversationNotificationLevel' | 'setConversationTypeNotificationLevel' | 'getConversationTypeNotificationLevel' | 'clearAllSGUnreadCount' | 'deleteRemoteMessage' | 'deleteRemoteMessageByTimestamp' | 'batchClearRemoteHistoryMessages' | 'sendReadReceiptResponseV5' | 'getMessageReadReceiptInfoV5ByIdentifiers' | 'getMessagesReadReceiptUsersByPageV5' | 'getMessagesReadReceiptByUsersV5' | 'searchConversationByContent' | 'requestSpeechToTextForMessage' | 'setMessageSpeechToTextVisible' | 'addTagForConversations' | 'getTagsForConversation' | 'setConversationStatusInTag' | 'removeTagForConversations' | 'removeTagsForConversation' | 'getConversationListByTag' | 'getUnreadCountByTag' | 'getUntaggedConversationListByPage' | 'batchSetConversationTranslateStrategy' | 'modifyMessageWithParams' | 'refreshReferenceMessageWithParams' | 'batchDeleteConversations' | 'sendReadReceiptV2' | 'syncRemoteConversations' | 'sendUltraGroupTypingStatus' | 'getUltraGroupList' | 'getRemoteMessagesByUIds' | 'getUGUnreadMentionedDigest' | 'getHistoryMessagesByObjectNames' | 'getContinuousMessages' | 'getMessagesAroundTimestamp' | 'deleteLocalUGMessagesForAllChannel' | 'updateUGMessageExpansion' | 'setUGDefaultNotificationLevel' | 'getUGDefaultNotificationLevel' | 'getUnreadMentionedMessages' | 'getUnreadMentionedCount' | 'getAllUnreadMentionedCount' | 'getTotalUnreadCountByLevels' | 'getConversationUnreadCount' | 'getFirstUnreadMessage' | 'getFirstUnreadMessageDigest' | 'getUGUnreadCountForAllChannels' | 'getUGUnreadInfoList' | 'getUGFirstUnreadMessageDigest' | 'getConversations' | 'clearConversationUnreadCount' | 'markRemoteConversationAsRead' | 'getTopConversationList' | 'getUnreadConversationList' | 'getConversationListByPageIndex' | 'getAllConversationList' | 'getConversationListByTimestamp' | 'clearConversations' | 'getBlockedConversationList' | 'getBlockedUGList' | 'saveEditedMessageDraft' | 'getEditedMessageDraft' | 'clearEditedMessageDraft' | 'getUnreadMentionMeConversationList' | 'sendUltraGroupTypingStatus' | 'updateConversationReadTime' | 'clearUnreadCountByTimestamp' | 'getMessageReader' | 'getMessageReadReceiptV4' | 'sendReadReceiptMessageV4' | 'getConversationsIncludingRobots'> {
-    /** 超级群是否已同步完成 */
-    get ugSynced(): boolean;
+interface IChatService extends Pick<IIPCMethods, 'getTotalUnreadCount' | 'getConversation' | 'batchSetConversationToTop' | 'batchSetConversationNotificationLevel' | 'getConversationNotificationLevel' | 'setConversationTypeNotificationLevel' | 'getConversationTypeNotificationLevel' | 'clearAllSGUnreadCount' | 'deleteRemoteMessage' | 'deleteRemoteMessageByTimestamp' | 'batchClearRemoteHistoryMessages' | 'sendReadReceiptResponseV5' | 'getMessageReadReceiptInfoV5ByIdentifiers' | 'getMessagesReadReceiptUsersByPageV5' | 'getMessagesReadReceiptByUsersV5' | 'searchConversationByContent' | 'requestSpeechToTextForMessage' | 'setMessageSpeechToTextVisible' | 'addTagForConversations' | 'getTagsForConversation' | 'setConversationStatusInTag' | 'removeTagForConversations' | 'removeTagsForConversation' | 'getConversationListByTag' | 'getUnreadCountByTag' | 'getUntaggedConversationListByPage' | 'batchSetConversationTranslateStrategy' | 'modifyMessageWithParams' | 'refreshReferenceMessageWithParams' | 'batchDeleteConversations' | 'sendReadReceiptV2' | 'syncRemoteConversations' | 'sendUltraGroupTypingStatus' | 'getUltraGroupList' | 'getRemoteMessagesByUIds' | 'getUGUnreadMentionedDigest' | 'getHistoryMessagesByObjectNames' | 'getContinuousMessages' | 'getMessagesAroundTimestamp' | 'deleteLocalUGMessagesForAllChannel' | 'updateUGMessageExpansion' | 'setUGDefaultNotificationLevel' | 'getUGDefaultNotificationLevel' | 'getUnreadMentionedMessages' | 'getUnreadMentionedCount' | 'getAllUnreadMentionedCount' | 'getTotalUnreadCountByLevels' | 'getConversationUnreadCount' | 'getFirstUnreadMessage' | 'getFirstUnreadMessageDigest' | 'getUGUnreadCountForAllChannels' | 'getUGUnreadInfoList' | 'getUGFirstUnreadMessageDigest' | 'getConversations' | 'clearConversationUnreadCount' | 'getTopConversationList' | 'getUnreadConversationList' | 'getConversationListByPageIndex' | 'getAllConversationList' | 'getConversationListByTimestamp' | 'clearConversations' | 'getBlockedConversationList' | 'getBlockedUGList' | 'saveEditedMessageDraft' | 'getEditedMessageDraft' | 'clearEditedMessageDraft' | 'getUnreadMentionMeConversationList' | 'sendUltraGroupTypingStatus' | 'updateConversationReadTime' | 'clearUnreadCountByTimestamp' | 'getMessageReader' | 'getMessageReadReceiptV4' | 'sendReadReceiptMessageV4' | 'getConversationsIncludingRobots'> {
     getRealtimeConversations(count: number, startTime: number, order: 0 | 1): Promise<RCResult<IReceivedConversation[]>>;
     getRealtimeConTotalUnreadCount(): Promise<RCResult<number>>;
     clearRealtimeConUnreadCount(identifier: IConversationIdentifier): Promise<RCResult>;
@@ -14986,7 +14934,7 @@ declare class ConversationListLoader extends BaseModule {
     get isLoading(): boolean;
     /**
      * 加载会话列表
-     * @param count 获取数量，有效值 [1, 100]
+     * @param count 获取数量
      */
     load(count: number): Promise<RCResult<IReceivedConversation[]>>;
 }
@@ -15016,14 +14964,6 @@ declare class ChatModule extends BaseModule {
      * @param timestamp 同步时间戳
      */
     sendSyncReadStatusMessage(identifier: IConversationIdentifier, timestamp: number): Promise<RCResult>;
-    /**
-     * 清除会话消息未读数
-     */
-    clearUnreadCount(identifier: IConversationIdentifier): Promise<RCResult>;
-    /**
-     * 清除全部会话消息未读数，不包含超级群会话
-     */
-    clearAllUnreadCount(): Promise<RCResult>;
     clearUnreadCountByTimestamp(identifier: IConversationIdentifier, timestamp: number): Promise<RCResult>;
     /**
      * 发送群已读回执请求（v1 版本）
@@ -15062,7 +15002,6 @@ declare class ChatModule extends BaseModule {
     getMessageReadReceiptV4(conversation: IConversationIdentifier, messageUId: string): Promise<RCResult<IMessageReadReceiptV4Response>>;
     batchGetMessageReadReceiptInfoV4(conversation: IConversationIdentifier, messageUIds: string[]): Promise<RCResult<IGroupReadReceiptData[]>>;
     getConversationsIncludingRobots(options: IGetConversationsIncludingRobotsOption): Promise<RCResult<IReceivedConversation[]>>;
-    markRemoteConversationAsRead(identifier: IConversationIdentifier): Promise<RCResult>;
 }
 
 declare class APIContext {
@@ -15101,6 +15040,10 @@ declare class APIContext {
      * engine 内部日志工具
      */
     readonly logger: BasicLogger;
+    /**
+     * 超级群同步完成记录
+     */
+    private _ugSynced;
     constructor(options: IAPIContextOption);
     /**
      * 安装使用插件，并初始化插件实例
@@ -15404,6 +15347,14 @@ declare class APIContext {
      * 获取超级群免打扰列表
      */
     getBlockedUGList(): Promise<RCResult<IReceivedConversation[]>>;
+    /**
+     * 清除会话消息未读数
+     */
+    clearUnreadCount(conversation: IConversationOption): Promise<RCResult>;
+    /**
+     * 清除全部会话消息未读数，不包含超级群会话
+     */
+    clearAllUnreadCount(): Promise<RCResult>;
     /**
      * 获取指定会话消息未读数
      */
@@ -15619,6 +15570,12 @@ declare class APIContext {
      * 删除所有会话，目前仅 v2 提供
     */
     clearConversations(conversationTypes?: ConversationType[], tag?: string): Promise<RCResult>;
+    /**
+     * 设置用户连接状态监听器
+    */
+    setUserStatusListener(config: {
+        userIds: string[];
+    }, listener: Function): void;
     /**
      * 添加用户黑名单
      */
@@ -16017,10 +15974,11 @@ declare class RTCPluginContext extends PluginContext {
  */
 declare type IUserSettingsModule = Pick<IIPCMethods, 'setTranslationLanguage' | 'getTranslationLanguage' | 'setAutoTranslateEnabled' | 'getAutoTranslateEnabled'>;
 
-declare type IIPCMethodsInEngine = Pick<IIPCMethods, 'searchMessagesWithParams' | 'createTag' | 'removeTag' | 'updateTag' | 'getTagList' | 'translateWithParams' | 'getFileUrl' | 'saveTextMessageDraft' | 'getTextMessageDraft' | 'clearTextMessageDraft' | 'getHistoryMessage' | 'clearLocalMessages' | 'deleteLocalMessages' | 'deleteLocalMessagesByTimestamp' | 'batchClearLocalMessagesByTimestamp' | 'insertMessage' | 'batchInsertMessage' | 'setMessageContent' | 'getLocalMessageCount' | 'recallMsg' | 'getSubscribeUsersOnlineStatus' | 'getSubscribeUserStatus' | 'subscribeUser' | 'unSubscribeUser' | 'getSubscribeUserList' | 'getUserProfiles' | 'getMyUserProfile' | 'updateMyUserProfile' | 'sendMessage' | 'refetchNaviInfo' | 'connect' | 'disconnect' | 'addToBlacklist' | 'removeFromBlacklist' | 'getBlacklist' | 'getBlacklistStatus' | 'setMessageReceivedStatus' | 'setMessageSentStatus' | 'setCheckDuplicateMessage' | 'setProxy' | 'getProxy' | 'testProxy' | 'getFileToken' | 'rtcSignaling' | 'rtcPing' | 'setCallInfo' | 'getUserStatus' | 'searchConversationByContentWithAllChannel' | 'getAllRobots'>;
+declare type IIPCMethodsInEngine = Pick<IIPCMethods, 'searchMessagesWithParams' | 'createTag' | 'removeTag' | 'updateTag' | 'getTagList' | 'translateWithParams' | 'getFileUrl' | 'saveTextMessageDraft' | 'getTextMessageDraft' | 'clearTextMessageDraft' | 'getHistoryMessage' | 'clearLocalMessages' | 'deleteLocalMessages' | 'deleteLocalMessagesByTimestamp' | 'batchClearLocalMessagesByTimestamp' | 'insertMessage' | 'batchInsertMessage' | 'setMessageContent' | 'getLocalMessageCount' | 'recallMsg' | 'getSubscribeUsersOnlineStatus' | 'getSubscribeUserStatus' | 'subscribeUser' | 'unSubscribeUser' | 'getSubscribeUserList' | 'getUserProfiles' | 'getMyUserProfile' | 'updateMyUserProfile' | 'sendMessage' | 'connect' | 'disconnect' | 'addToBlacklist' | 'removeFromBlacklist' | 'getBlacklist' | 'getBlacklistStatus' | 'setMessageReceivedStatus' | 'setMessageSentStatus' | 'setCheckDuplicateMessage' | 'setProxy' | 'getProxy' | 'testProxy' | 'setUserStatusListener' | 'getFileToken' | 'rtcSignaling' | 'rtcPing' | 'setCallInfo' | 'getUserStatus' | 'searchConversationByContentWithAllChannel' | 'getAllRobots'>;
 declare abstract class BasicEngine implements IIPCMethodsInEngine, IModuleContext {
     protected readonly _watcher: IEngineWatcher;
     protected readonly _options: IAPIContextOption;
+    private readonly _logger;
     /**
      * 连接时间
     */
@@ -16041,7 +15999,7 @@ declare abstract class BasicEngine implements IIPCMethodsInEngine, IModuleContex
     get initOption(): IAPIContextOption;
     abstract get connectionStatus(): RCConnectionStatus;
     abstract get userId(): string;
-    abstract get logger(): BasicLogger;
+    get logger(): BasicLogger;
     abstract get usingCppEngine(): boolean;
     /**
      * 用户信息托管模块
@@ -16051,14 +16009,17 @@ declare abstract class BasicEngine implements IIPCMethodsInEngine, IModuleContex
      * 引擎初始化
      * @param _appkey
      */
-    constructor(_watcher: IEngineWatcher, _options: IAPIContextOption);
+    constructor(_watcher: IEngineWatcher, _options: IAPIContextOption, _logger: BasicLogger);
     protected _rtcSignalingListener?: (buffer: Uint8Array) => void;
     /**
      * 注册 RTC KV 变更监听器
      * @param listener
      */
     registerRTCSignalingListener(listener: ((buffer: Uint8Array) => void) | undefined): void;
-    abstract refetchNaviInfo(): Promise<RCResult<INaviInfo | null>>;
+    /**
+     * 忽视缓存，重新请求导航数据
+     */
+    abstract refetchNaviInfo(): IPromiseResult<INaviInfo | null>;
     /**
      * 为非 engine 包创建 logger 工具实例
      */
@@ -16162,6 +16123,12 @@ declare abstract class BasicEngine implements IIPCMethodsInEngine, IModuleContex
      * @param options
      */
     abstract sendUltraMessage(identifier: IConversationIdentifier, options: IMessageSendOptions, traceId: string, onSendBefore?: (messageId: number) => void): Promise<RCResult<IReceivedMessage>>;
+    /**
+     * 设置用户在线状态监听器
+    */
+    abstract setUserStatusListener(config: {
+        userIds: string[];
+    }, listener: Function): void;
     /**
      * 设置当前用户在线状态
     */