@rongcloud/plugin-call-plus 2.0.1-alpha.1 → 2.1.1

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { RCConnectionStatus, EventEmitter, BasicLogger, RTCJoinType, EnableLogL, PluginContext, IRuntime, IPluginGenerator } from '@rongcloud/engine';
-import { EnableLogL as EnableLogL$1 } from '@rongcloud/imlib-next';
+import { RCConnectionStatus, EventEmitter, BasicLogger, RTCJoinType, EnableLogL, PluginContext, IRuntime, IReceivedMessage, IPluginGenerator } from '@rongcloud/engine';
 import { RCRTCClient, RCRemoteTrack, RCTrack, ISubscribeAttr, RCRTCCode, RCLocalAudioTrack, RCRemoteAudioTrack, RCFrameRate, RCResolution } from '@rongcloud/plugin-rtc';
 export { RCFrameRate as RCCallPlusFrameRate, RCResolution as RCCallPlusResolution } from '@rongcloud/plugin-rtc';
 
@@ -918,6 +917,10 @@ interface ISyncCallLogCon {
      * 每页记录数 默认 30
      */
     count?: number;
+    /**
+     * 正序或倒序
+     */
+    order?: 0 | 1;
 }
 interface ISyncCallLogRes extends IBaseSingalCon {
     callType: RCCallPlusType;
@@ -974,6 +977,10 @@ interface ISyncCallLogResList {
      * 列表中最大时间戳
      */
     maxTime: number;
+    /**
+     * 通话记录列表中最小的时间戳
+     */
+    minTime: number;
     /**
      * 删除的列表
      */
@@ -1148,6 +1155,16 @@ interface ISysStatusUpOpts extends IBaseSingalCon {
      */
     forward: ForwardType;
 }
+interface IEndAbnormalCallOpts {
+    /**
+     * 0 当前端；1 所有端
+     */
+    allDevice: 0 | 1;
+    /**
+     * 异常的 callId 列表
+     */
+    callIds: string[];
+}
 interface IGetDelayTimeInfoRes {
     /**
      * 获取 CallServer 与用户本地时间的差值，用于矫正与 CallServer 的时间
@@ -1393,6 +1410,10 @@ interface IGetCallLogListOpts {
      * 获取数量
      */
     count?: number;
+    /**
+     * 正序或倒序
+     */
+    order?: 0 | 1;
 }
 interface IRCCallPlusGetCallRecordRes {
     /**
@@ -1404,9 +1425,9 @@ interface IRCCallPlusGetCallRecordRes {
      */
     list: IRCCallPlusCallRecord[];
     /**
-     * 列表中最大时间戳
+     * hasMore 为 true 时，继续获取通话记录需传入的时间戳
      */
-    maxTime: number;
+    syncTime: number;
 }
 interface IReqChangeMediaTypeOpts {
     /**
@@ -1890,12 +1911,85 @@ declare class TimeCorrectioner {
     private _loopCorrectClientTime;
 }
 
+declare enum RCCallPlusMediaTypeChangeResult {
+    /**
+     * 请求方取消媒体类型变更
+     */
+    CANCEL_CHANGE_MEDIA_TYPE = 0,
+    /**
+     * 应答方拒绝媒体类型切换
+     */
+    REFUSE_CHANGE_MEDIA_TYPE = 1,
+    /**
+     * 服务仲裁允许媒体类型切换
+     */
+    SERVER_ALLOW_MEDIA_TYPE = 2,
+    /**
+     * 媒体类型切换超时
+     */
+    CHANGE_MEDIA_TYPE_TIMEOUT = 3
+}
+
+declare class RCCallPlusReportModule {
+    private readonly _logger;
+    private _listener;
+    constructor(_logger: BasicLogger);
+    /**
+     * 状态机事件注册
+     */
+    registerEventListener(listener: ICallPlusEventListener): void;
+    /**
+    * 回调应用层事件
+    * @param eventName
+    * @param attrs
+    * @returns
+    */
+    private _callAppListener;
+    onReceivedCall(session: RCCallPlusSession, traceId: string, extra?: string): void;
+    onRemoteUserInvited(inviteeUserList: string[], inviterUserId: string, callId: string): void;
+    onCallConnected(session: RCCallPlusSession): void;
+    onCallTypeChanged(callType: RCCallPlusType, callId: string, traceId: string): void;
+    /**
+     * 增量上报远端人员状态变化
+     */
+    onRemoteUserStateChanged(data: {
+        callId: string;
+        userId: string;
+        userState: RCCallPlusSessionUserState;
+        reason?: RCCallPlusReason;
+    }, traceId: string): void;
+    onCallEnded(session: RCCallPlusSession, reason: RCCallPlusReason, traceId: string): void;
+    onRemoteCameraStateChanged(callId: string, track: RCRemoteTrack): void;
+    onRemoteMicrophoneStateChanged(callId: string, track: RCRemoteTrack): void;
+    onReceivedCallRecord(record: IRCCallPlusCallRecord, traceId: string): void;
+    onReceivedChangeMediaTypeRequest(userId: string, transactionId: string, mediaType: RCCallPlusMediaType, traceId: string): void;
+    onReceivedChangeMediaTypeResult(info: {
+        userId: string;
+        transactionId: string;
+        mediaType: RCCallPlusMediaType;
+        code: RCCallPlusMediaTypeChangeResult;
+    }, traceId: string): void;
+    onReceivedCallStartTime(info: {
+        callId: string;
+        callStartTime: number;
+    }, traceId: string): void;
+    onReceivedCallFirstFrameTime(callId: string, callFirstFrameTime: number, traceId: string): void;
+    onUserMediaAvailable(tracks: RCTrack[], traceId?: string): void;
+    onFetchRemoteMediaError(tracks: ISubscribeAttr[], code: RCRTCCode): void;
+    onUserAudioLevelChanged(audioLevelReportList: {
+        track: RCLocalAudioTrack | RCRemoteAudioTrack;
+        audioLevel: number;
+    }[]): void;
+    onReceivedCallPlusSummaryMessage(message: IRCCallPlusReceivedSummaryMessage): void;
+}
+
 declare class SignalTransporter extends EventEmitter {
     private readonly _context;
     private readonly _runtime;
     private readonly _initOpts;
     private readonly _timeCorrectioner;
     private readonly _logger;
+    private readonly _reportAppEventModule;
     /**
      * 监听对象
      */
@@ -1908,7 +2002,8 @@ declare class SignalTransporter extends EventEmitter {
     /**
      * constructor
      */
-    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: IRCCallInitOptions, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger);
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: IRCCallInitOptions, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
+    private _onMessage;
     getSessionId(): string;
     registerListener(listener: ISignalTransporterListener): void;
     startCall(msg: IStartCallCon, traceId: string): Promise<{
@@ -1987,6 +2082,12 @@ declare class SignalTransporter extends EventEmitter {
     upCallLogReaded(opts: IBaseSingalCon): Promise<{
         code: number;
     }>;
+    /**
+     * 清除用户正在呼叫中的通话会话（*非暴露接口，供调试酌情调用）
+     */
+    endUserAbnormalCalls(opts: IEndAbnormalCallOpts): Promise<{
+        code: number;
+    }>;
     /** ======私有方法============================================================================================= */
     private _onIMConnectionStateChange;
     /**
@@ -2068,77 +2169,6 @@ declare class AbnormalCall {
     private _getByIndexDB;
 }
 
-declare enum RCCallPlusMediaTypeChangeResult {
-    /**
-     * 请求方取消媒体类型变更
-     */
-    CANCEL_CHANGE_MEDIA_TYPE = 0,
-    /**
-     * 应答方拒绝媒体类型切换
-     */
-    REFUSE_CHANGE_MEDIA_TYPE = 1,
-    /**
-     * 服务仲裁允许媒体类型切换
-     */
-    SERVER_ALLOW_MEDIA_TYPE = 2,
-    /**
-     * 媒体类型切换超时
-     */
-    CHANGE_MEDIA_TYPE_TIMEOUT = 3
-}
-
-declare class RCCallPlusReportModule {
-    private readonly _logger;
-    private _listener;
-    constructor(_logger: BasicLogger);
-    /**
-     * 状态机事件注册
-     */
-    registerEventListener(listener: ICallPlusEventListener): void;
-    /**
-    * 回调应用层事件
-    * @param eventName
-    * @param attrs
-    * @returns
-    */
-    private _callAppListener;
-    onReceivedCall(session: RCCallPlusSession, traceId: string, extra?: string): void;
-    onRemoteUserInvited(inviteeUserList: string[], inviterUserId: string, callId: string): void;
-    onCallConnected(session: RCCallPlusSession): void;
-    onCallTypeChanged(callType: RCCallPlusType, callId: string, traceId: string): void;
-    /**
-     * 增量上报远端人员状态变化
-     */
-    onRemoteUserStateChanged(data: {
-        callId: string;
-        userId: string;
-        userState: RCCallPlusSessionUserState;
-        reason?: RCCallPlusReason;
-    }, traceId: string): void;
-    onCallEnded(session: RCCallPlusSession, reason: RCCallPlusReason, traceId: string): void;
-    onRemoteCameraStateChanged(callId: string, track: RCRemoteTrack): void;
-    onRemoteMicrophoneStateChanged(callId: string, track: RCRemoteTrack): void;
-    onReceivedCallRecord(record: IRCCallPlusCallRecord, traceId: string): void;
-    onReceivedChangeMediaTypeRequest(userId: string, transactionId: string, mediaType: RCCallPlusMediaType, traceId: string): void;
-    onReceivedChangeMediaTypeResult(info: {
-        userId: string;
-        transactionId: string;
-        mediaType: RCCallPlusMediaType;
-        code: RCCallPlusMediaTypeChangeResult;
-    }, traceId: string): void;
-    onReceivedCallStartTime(info: {
-        callId: string;
-        callStartTime: number;
-    }, traceId: string): void;
-    onReceivedCallFirstFrameTime(callId: string, callFirstFrameTime: number, traceId: string): void;
-    onUserMediaAvailable(tracks: RCTrack[], traceId?: string): void;
-    onFetchRemoteMediaError(tracks: ISubscribeAttr[], code: RCRTCCode): void;
-    onUserAudioLevelChanged(audioLevelReportList: {
-        track: RCLocalAudioTrack | RCRemoteAudioTrack;
-        audioLevel: number;
-    }[]): void;
-}
-
 declare class RCCallEngine extends EventEmitter {
     private readonly _context;
     private readonly _runtime;
@@ -2345,6 +2375,14 @@ declare class RCCallEngine extends EventEmitter {
      * holdSession 升级为 mainSession
      */
     upgradeMainSession(holdCallId: string): void;
+    /**
+     * 清除异常结束的 call
+     */
+    endCurrentUserAbnormalCalls(opts: {
+        allDevice: boolean;
+    }): Promise<{
+        code: number;
+    }>;
     /** ======私有方法============================================================================================= */
     /**
      * IM 状态变更处理
@@ -2412,6 +2450,10 @@ declare class RCCallEngine extends EventEmitter {
      * 通话结束
      */
     private _onSessionClose;
+    /**
+     * 上报在线通话结束的 summary 消息
+     */
+    private _reportCallPlusSummaryMessage;
     /**
      * 根据 callId 移除 session
      */
@@ -2586,12 +2628,54 @@ interface ICallPlusInitOpts {
     /**
      * 定义 callplus SDK 内部的日志输出等级，默认值 LogL.WARN
      */
-    logOutputLevel?: EnableLogL$1;
+    logOutputLevel?: EnableLogL;
     /**
      * 是否发布小流
      */
     isPubTiny?: boolean;
 }
+/**
+ * 通话记录的消息 content 字段
+ */
+interface IRCCallPlusSummaryMessageContent {
+    /**
+     * 唯一通话标识
+     */
+    callId: string;
+    /**
+     * 通话发起者 userId
+     */
+    callerUserId: string;
+    /**
+     * 通话对方 targetId
+     */
+    targetId: string;
+    /**
+     * 媒体类型：0 音频、1 音视频
+     */
+    mediaType: RCCallPlusMediaType;
+    /**
+     * 收到首帧时间
+     */
+    firstFrameTime: number;
+    /**
+     * 通话开始时间
+     */
+    callStartTime: number;
+    /**
+     * 通话结束时间
+     */
+    callEndTime: number;
+    /**
+     * 通话挂断原因
+     */
+    hangupReason: RCCallPlusReason;
+}
+/**
+ * 通话记录的消息结构定义
+ */
+interface IRCCallPlusReceivedSummaryMessage extends IReceivedMessage {
+}
 /**
  * callPlus 对外事件定义
  */
@@ -2714,6 +2798,15 @@ interface ICallPlusEventListener {
      * @param audioLevel 音量值（0-100）
      */
     onUserAudioLevelChanged?(userId: string, audioLevel: number): void;
+    /**
+     * 收到通话结束的消息记录，可用于在 IM 聊天界面插入通话结束消息
+     * 仅单聊可收到
+     * 触发时机:
+     * 1.单聊在线通话结束后
+     * 2.离线时收到单聊呼叫，通话结束后，重新连接 IM 在线时
+     * @param message 通话记录的消息体
+     */
+    onReceivedCallPlusSummaryMessage?(message: IRCCallPlusReceivedSummaryMessage): void;
 }
 /**
  * 通话前视频配置
@@ -2900,6 +2993,7 @@ interface IAndroidPushConfig {
      * Large icon 可以出现在大图版和多字版消息中，显示在右边。
      * 国内版仅 MIUI12 以上版本支持，以下版本均不支持；国际版支持。
      * 图片要求：大小 120 * 120px，格式为 png 或者 jpg 格式。
+     * @deprecated 由于小米官方已停止支持该能力，该字段已失效
      */
     miLargeIconUrl?: string;
     /**
@@ -3033,6 +3127,7 @@ declare class RCCallPlusAndroidPushConfigBuilder {
     setChannelIdMi(channelIdMi: string): this;
     /**
      * 设置小米 Large icon 链接
+     * @deprecated 由于小米官方已停止支持该能力，该方法已失效
      */
     setMiLargeIconUrl(miLargeIconUrl: string): this;
     /**
@@ -3334,13 +3429,19 @@ declare class RCCallPlusClient {
     }>;
     /**
      * 分页查找当前用户的全部通话记录
-     * @param startTimestamp 起始时间戳，返回大于此时间戳的通话记录
+     * @param startTimestamp 起始时间戳，
+     * 首次获取可传 -1，倒序时，返回最新的通话记录，正序时，返回最早的通话记录
+     * order 为正序时，返回大于此时间戳的通话记录
+     * order 为倒序时，返回小于此时间戳的通话记录
      * @param count 每次获取的数量
+     * @param order 正序或倒序获取，默认为正序
+     * 0 为正序，向开始时间戳之后查询
+     * 1 为倒序，向开始时间戳之前查询
      * @returns result.hasMore 是否有更多通话记录
      * @returns result.list 通话记录列表，类型为 IRCCallPlusCallRecord[]，可通过 apiDoc 查看具体包含字段
-     * @returns result.maxTime 列表中最大时间戳，如果 hasMore 为 true，继续获取时，传入此时间戳
+     * @returns result.syncTime hasMore 为 true 时，继续获取通话记录需传入的时间戳
      */
-    getCallRecords(startTimestamp: number, count: number): Promise<{
+    getCallRecords(startTimestamp: number, count: number, order?: 0 | 1): Promise<{
         code: number;
         result?: IRCCallPlusGetCallRecordRes;
     }>;
@@ -3432,4 +3533,4 @@ declare class RCCallPlusClient {
 
 declare const installer: IPluginGenerator<RCCallPlusClient, ICallPlusInitOpts>;
 
-export { IAndroidPushConfig, IAudioConfig, IAudioConfigBuilder, ICallOpts, ICallPlusEventListener, ICallPlusInitOpts, IRCCallPlusCallRecord, IRCCallPlusGetCallRecordRes, IRCCallPlusPushConfig, IServerPushExt, IStatusReportListener, IVideoConfig, IVideoConfigBuilder, IiOSPushConfig, RCAudioConfigBuilder, RCCallPlusAndroidPushConfigBuilder, RCCallPlusCallState, RCCallPlusCallUser, RCCallPlusClient, RCCallPlusCode, RCCallPlusMediaType, RCCallPlusMediaTypeChangeResult, RCCallPlusPacketLossStats, RCCallPlusReason, RCCallPlusSession, RCCallPlusSessionUserState, RCCallPlusType, RCVideoConfigBuilder, installer };
+export { IAndroidPushConfig, IAudioConfig, IAudioConfigBuilder, ICallOpts, ICallPlusEventListener, ICallPlusInitOpts, IRCCallPlusCallRecord, IRCCallPlusGetCallRecordRes, IRCCallPlusPushConfig, IRCCallPlusReceivedSummaryMessage, IRCCallPlusSummaryMessageContent, IServerPushExt, IStatusReportListener, IVideoConfig, IVideoConfigBuilder, IiOSPushConfig, RCAudioConfigBuilder, RCCallPlusAndroidPushConfigBuilder, RCCallPlusCallState, RCCallPlusCallUser, RCCallPlusClient, RCCallPlusCode, RCCallPlusMediaType, RCCallPlusMediaTypeChangeResult, RCCallPlusPacketLossStats, RCCallPlusReason, RCCallPlusSession, RCCallPlusSessionUserState, RCCallPlusType, RCVideoConfigBuilder, installer };