@rongcloud/plugin-call-plus 2.1.7-enterprise.1 → 2.1.7

package/index.d.ts

@@ -1,5 +1,5 @@
-import { RCConnectionStatus, EventEmitter, BasicLogger, PluginContext, EnableLogL, IReceivedMessage, IPluginGenerator } from '@rongcloud/engine';
-import { RCRemoteTrack, RCTrack, ISubscribeAttr, RCRTCCode, RCLocalAudioTrack, RCRemoteAudioTrack, RCRTCClient, RCFrameRate, RCResolution } from '@rongcloud/plugin-rtc';
+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';
 
 /**
@@ -413,11 +413,7 @@ declare enum RCCallPlusReason {
     /**
      * 远端用户的其他端已经在房间中，不允许 joinRoom 进行音视频通话
      */
-    REMOTE_OTHER_CLIENT_IN_RTC = 1214,
-    /**
-     * 加密通话失败，如获取秘钥失败等
-     */
-    ENCRYPT_FAILED = 1216
+    REMOTE_OTHER_CLIENT_IN_RTC = 1214
 }
 
 /**
@@ -475,10 +471,6 @@ interface IBaseSingalCon {
  * 开始呼叫信令内容
  */
 interface IStartCallCon {
-    /**
-     * 客户端生成，传给服务
-     */
-    callId: string;
     /**
      * 用户生成 callId
      */
@@ -499,10 +491,6 @@ interface IStartCallCon {
      * 是否密聊
      */
     secretChat: SecretCallType;
-    /**
-     * 密钥
-     */
-    secretChatKey: string;
     /**
      * 当前用户的来源组 ID 类型
      */
@@ -527,16 +515,11 @@ interface IStartCallCon {
      * 附加信息，服务器透传
      */
     extra?: string;
-    innerExtra?: string;
 }
 /**
  * 单呼信令内容
  */
 interface IStartSingleCon {
-    /**
-     * 客户端生成，传递给服务
-     */
-    callId: string;
     /**
      * 用户生成 callId
      */
@@ -582,16 +565,11 @@ interface IStartSingleCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
 }
 /**
  * 群呼信令内容
  */
 interface IStartGroupCon {
-    /**
-     * 客户端生成，传递给服务
-     */
-    callId: string;
     /**
      * 用户生成 callId
      */
@@ -628,16 +606,6 @@ interface IStartGroupCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
-    /**
-     * 是否密聊(0: 否；1: 是)
-     * PC 目前无密聊，写死 0
-     */
-    secretChat: SecretCallType;
-    /**
-     * 单聊加密 key
-     */
-    secretChatKey?: string;
 }
 /**
  * 开始呼叫 Server 返回
@@ -674,7 +642,6 @@ interface IInviteCallCon extends IBaseSingalCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
 }
 /**
  * 邀请好友加入信令结果
@@ -753,7 +720,7 @@ interface IPubInviteCon extends IBaseSingalCon {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 是否密聊
      */
@@ -774,14 +741,6 @@ interface IPubInviteCon extends IBaseSingalCon {
      * 附加信息
      */
     extra?: string;
-    /**
-     * 可存储的扩展信息，由发起人发起时定义
-     */
-    innerExtra?: string;
-    /**
-     * 通话加密密钥
-     */
-    secretChatKey?: string;
 }
 /**
  * 通话响铃信令内容
@@ -912,7 +871,7 @@ interface IDialogUpCallCon extends IBaseSingalCon {
      * 附加数据，上传为可选
      */
     extraKeyVal?: {
-        mediaType: RCCallPlusMediaType;
+        mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
         reason?: DialogAction;
     } | {
         cameraOn: 0 | 1;
@@ -938,7 +897,7 @@ interface IDialogDownCallCon extends IDialogUpCallCon {
      * 附加数据
      */
     extraKeyVal: {
-        mediaType: RCCallPlusMediaType;
+        mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
         reason?: DialogAction;
     };
 }
@@ -1010,7 +969,6 @@ interface ISyncCallLogRes extends IBaseSingalCon {
      * 同步数据
      */
     syncTime: number;
-    innerExtra?: string;
 }
 interface ISyncCallLogResList {
     hasMore: 0 | 1;
@@ -1084,7 +1042,7 @@ interface IGetUserCallStateListRes {
     callStateList: {
         callId: string;
         callType: RCCallPlusType;
-        mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+        mediaType: RCCallPlusMediaType;
         /**
          * 呼叫发起者 ID
          */
@@ -1118,8 +1076,6 @@ interface IGetUserCallStateListRes {
          */
         targetId: string;
         startTime: number;
-        innerExtra?: string;
-        secretChat: SecretCallType;
     }[];
 }
 interface IClearCallLogRes {
@@ -1140,7 +1096,7 @@ interface IGetCallSessionServerRes extends IBaseSingalCon {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 通话状态
      */
@@ -1169,9 +1125,6 @@ interface IGetCallSessionServerRes extends IBaseSingalCon {
      * 同步时间戳
      */
     syncTime: number;
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    secretChatKey?: string;
 }
 interface IGetCallTimeInfoRes extends IBaseSingalCon {
     /**
@@ -1324,14 +1277,6 @@ interface IRCCallPlusCallRecord {
      * 创建时间
      */
     createTimestamp: number;
-    /**
-     * 同步数据
-     */
-    syncData?: string;
-    /**
-     * 是否为加密通话
-     */
-    isSecret: boolean;
 }
 interface IUserInfo {
     /**
@@ -1367,7 +1312,7 @@ interface IStartCallOpts extends ICallId {
     /**
      * 通话媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 当前用户来源组 ID 类型
      */
@@ -1389,12 +1334,6 @@ interface IStartCallOpts extends ICallId {
      * 附加信息，服务器透传
      */
     extra?: string;
-    /**
-     * 内部透传信息，服务器会记录该数据
-     */
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    secretChatKey?: string;
 }
 interface IStartCallResult {
     /**
@@ -1534,7 +1473,7 @@ interface IGetCallSessionRes extends ICallId {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 通话状态
      */
@@ -1555,12 +1494,6 @@ interface IGetCallSessionRes extends ICallId {
      * 同步时间戳
      */
     syncTime: number;
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    /**
-     * 通话加密密钥
-     */
-    secretChatKey?: string;
 }
 
 declare enum CallTimerEventType {
@@ -1605,17 +1538,8 @@ declare class RCCallInnerSession extends EventEmitter {
      */
     private _callUsers;
     private readonly _logger;
-    private readonly _isSecret;
-    /**
-     * 同步数据
-     */
-    private _syncData;
     /**
-     * 通话加密密钥
-     */
-    private _secretKey;
-    /**
-     * 暂存请求更新的 mediaType，无请求时为 null
+     * 请求更新的 mediaType
      */
     private _reqMediaType;
     /**
@@ -1656,7 +1580,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 通话媒体类型
      */
-    _mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO, 
+    _mediaType: RCCallPlusMediaType, 
     /**
      * session 呼叫发起者
      */
@@ -1668,15 +1592,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 当前 session 人员信息列表
      */
-    _callUsers: ISessionUser[], _logger: BasicLogger, _isSecret: boolean, 
-    /**
-     * 同步数据
-     */
-    _syncData?: string, 
-    /**
-     * 通话加密密钥
-     */
-    _secretKey?: string);
+    _callUsers: ISessionUser[], _logger: BasicLogger);
     /**
      * 获取 CallID
      */
@@ -1692,7 +1608,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 获取媒体类型
      */
-    getMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    getMediaType(): RCCallPlusMediaType;
     /**
      * 获取 session 发起者
      */
@@ -1708,7 +1624,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 请求更新的 mediaType
      */
-    getReqMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO | null;
+    getReqMediaType(): RCCallPlusMediaType | null;
     /**
      * inviterTimerId
      */
@@ -1738,11 +1654,11 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 更新媒体类型（升降级）
      */
-    updateMediaType(mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO): void;
+    updateMediaType(mediaType: RCCallPlusMediaType): void;
     /**
      * 更新请求的媒体类型（升降级）
      */
-    updateReqMediaType(mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO | null): void;
+    updateReqMediaType(mediaType: RCCallPlusMediaType | null): void;
     /**
      * 更新 invter timer id
      */
@@ -1756,9 +1672,26 @@ declare class RCCallInnerSession extends EventEmitter {
      */
     setIsLocalClientHangup(isLocalClientHangup: boolean): void;
     getIsLocalClientHangup(): boolean;
-    getSyncData(): string | undefined;
-    isSecret(): boolean;
-    getSecretKey(): string;
+}
+
+interface IRCCallInitOptions {
+    /**
+     * RTC 实例
+     */
+    rtcClient: RCRTCClient;
+    /**
+     * RTC 房间加入类型
+     */
+    joinType?: RTCJoinType;
+    /**
+     * 控制台日志输出等级
+     */
+    outputLogLevel?: EnableLogL;
+    /**
+     * 修改默认的 log 输出函数
+     * @deprecated
+     */
+    logStdout?: (logLevel: EnableLogL, content: string) => void;
 }
 
 declare enum CallServerAction {
@@ -2052,6 +1985,8 @@ declare class RCCallPlusReportModule {
 
 declare class SignalTransporter extends EventEmitter {
     private readonly _context;
+    private readonly _runtime;
+    private readonly _initOpts;
     private readonly _timeCorrectioner;
     private readonly _logger;
     private readonly _reportAppEventModule;
@@ -2067,10 +2002,9 @@ declare class SignalTransporter extends EventEmitter {
     /**
      * constructor
      */
-    constructor(_context: PluginContext, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: IRCCallInitOptions, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
     private _onMessage;
     getSessionId(): string;
-    getDeviceId(): string;
     registerListener(listener: ISignalTransporterListener): void;
     startCall(msg: IStartCallCon, traceId: string): Promise<{
         code: number;
@@ -2172,7 +2106,7 @@ declare class SignalTransporter extends EventEmitter {
      * deviceId 为空字符串或 null 直接下发
      * deviceId 有具体的值，根据 deviceId 判断是否是己端的 deviceId
      */
-    isValidData(toDeviceId: string | null): boolean;
+    private _isValidData;
     /**
      * 收到邀请
      * @param isDirectly 是否为直发信令
@@ -2209,8 +2143,9 @@ declare class SignalTransporter extends EventEmitter {
  */
 declare class AbnormalCall {
     private readonly _logger;
+    private _localStore;
     private static _STORAGE_KEY;
-    constructor(_logger: BasicLogger);
+    constructor(runtime: IRuntime, _logger: BasicLogger);
     /**
      * 添加异常 callId
      */
@@ -2227,6 +2162,8 @@ declare class AbnormalCall {
 
 declare class RCCallEngine extends EventEmitter {
     private readonly _context;
+    private readonly _runtime;
+    private readonly _initOpts;
     private readonly _logger;
     private readonly _reportAppEventModule;
     static __INNER_SESSION_CLOSE__: string;
@@ -2271,7 +2208,7 @@ declare class RCCallEngine extends EventEmitter {
     /**
      * 构造器
      */
-    constructor(_context: PluginContext, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: IRCCallInitOptions, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
     /**
      * 发起呼叫
      */
@@ -2553,7 +2490,7 @@ declare class RCCallPlusSession {
     /**
      * 获取通话媒体类型
      */
-    getMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    getMediaType(): RCCallPlusMediaType;
     /**
      * 获取通话人员列表
      */
@@ -2585,20 +2522,6 @@ declare class RCCallPlusSession {
         code: number;
         duration?: number;
     }>;
-    /**
-     * 获取通话中的缓存数据，数据由通话发起人在发起通话时定义
-     * @returns
-     */
-    getSyncData(): string | undefined;
-    /**
-     * 通话是否已加密
-     * @returns
-     */
-    isSecret(): boolean;
-    /**
-     * 获取通话加密密钥
-     */
-    getSecretKey(): string;
 }
 
 /**
@@ -2736,67 +2659,12 @@ interface IRCCallPlusSummaryMessageContent {
      * 通话挂断原因
      */
     hangupReason: RCCallPlusReason;
-    /**
-     * 是否为加密通话
-     */
-    isSecret: boolean;
-    /**
-     * 通话发起人定义的同步信息
-     */
-    syncData?: string;
 }
 /**
  * 通话记录的消息结构定义
  */
 interface IRCCallPlusReceivedSummaryMessage extends IReceivedMessage {
 }
-/**
- * 发起呼叫参数
- */
-interface IRCCallPlusStartParams {
-    /**
-     * 被叫方通话用户列表
-     */
-    userIds: string[];
-    /**
-     * 通话类型，默认为 `RCCallPlusType.SINGLE`
-     * * `RCCallPlusType.SINGLE` - 发起单人呼叫
-     * * `RCCallPlusType.MULTI` - 发起多人呼叫
-     */
-    type?: RCCallPlusType;
-    /**
-     * 通话媒体类型，默认为 `RCCallPlusMediaType.AUDIO_VIDEO` 音视频通话
-     * * `RCCallPlusMediaType.AUDIO` - 音频通话
-     * * `RCCallPlusMediaType.AUDIO_VIDEO` - 音视频通话
-     */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
-    /**
-     * 推送配置，用于定义移动端接收呼叫时的推送行为
-     */
-    pushConfig?: IRCCallPlusPushConfig;
-    /**
-     * 透传信息，该信息将通过 `onReceivedCall` 回调时透传给被叫方
-     */
-    extra?: string;
-    /**
-     * 定义通话同步数据，该数据与 `extra` 不同点，在于数据会被服务器存储，同时可通过 `session.getSyncData()` 获取；
-     * 数据不可超出 1024 Bytes
-     */
-    syncData?: string;
-    /**
-     * 加密配置
-     */
-    encryption?: {
-        /**
-         * 是否加密，默认不加密
-         */
-        isSecret: boolean;
-        /**
-         * 密钥
-         */
-        secretKey: string;
-    };
-}
 /**
  * callPlus 对外事件定义
  */
@@ -3302,8 +3170,11 @@ declare class RCCallPlusAndroidPushConfigBuilder {
     setimageUrlHonor(imageUrlHonor: string): this;
     /**
      * 构建 IAndroidPushConfig
+  <<<<<<< HEAD
+  =======
      * @returns IAndroidPushConfig 安卓推送配置数据
      * 返回值需传入 startCall、invite、hangup 方法的 pushConfig.androidConfig 中
+  >>>>>>> develop
      */
     build(): IAndroidPushConfig;
 }
@@ -3311,6 +3182,7 @@ declare class RCCallPlusAndroidPushConfigBuilder {
 declare class RCCallPlusClient {
     private readonly _context;
     private readonly _logger;
+    private readonly _runtime;
     private readonly _initOpts;
     /**
      * 摄像头采集配置
@@ -3342,7 +3214,7 @@ declare class RCCallPlusClient {
      * 上报应用层事件模块
      */
     _reportAppEventModule: RCCallPlusReportModule;
-    constructor(_context: PluginContext, _logger: BasicLogger, _initOpts: ICallPlusInitOpts);
+    constructor(_context: PluginContext, _logger: BasicLogger, _runtime: IRuntime, _initOpts: ICallPlusInitOpts);
     /**
      * 加房间、发布、订阅失败时需结束通话，并上报原因
      */
@@ -3466,23 +3338,14 @@ declare class RCCallPlusClient {
     }>;
     /**
      * 发起呼叫
-     * @deprecated 接口已废弃，请使用 `startCallWithParams` 接口替代
      * @param userIds 被叫人员 userId 列表，单人呼叫仅需在数组中放置对方一人的 userId
-     * @param callType 单人呼叫 or 多人呼叫
+     * @param type 单人呼叫 or 多人呼叫
      * @param mediaType 通话媒体类型: 音频 or 音视频
      * @param pushConfig 移动端推送信息
      * @param extra 附加信息，会透传给被呼叫方
      * @returns callId 呼叫成功后，产生的会话 id
      */
-    startCall(userIds: string[], callType?: RCCallPlusType, mediaType?: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO, pushConfig?: IRCCallPlusPushConfig, extra?: string): Promise<{
-        code: number;
-        callId?: string;
-    }>;
-    /**
-     * 发起呼叫
-     * @param params - {@inheritDoc IRCCallPlusStartParams}
-     */
-    startCallWithParams(params: IRCCallPlusStartParams): Promise<{
+    startCall(userIds: string[], callType?: RCCallPlusType, mediaType?: RCCallPlusMediaType, pushConfig?: IRCCallPlusPushConfig, extra?: string): Promise<{
         code: number;
         callId?: string;
     }>;
@@ -3513,16 +3376,17 @@ declare class RCCallPlusClient {
     accept(callId: string, pushConfig?: IRCCallPlusPushConfig): Promise<{
         code: number;
     }>;
-    private _innerHangup;
+    private __innerHangup;
     /**
      * 挂断通话
-     * @param callId 可选参数；当存在多个通话时，可通过该参数指定要挂断的通话；不传时 SDK 将挂断当前进行中的通话；
+     * @param callId 为可选参数，不传时，挂断正在进行的主 session，传入时可指定挂断主通话或暂未建立连接的通话
+     * @param pushConfig 移动端推送信息
+     * 暂未建立连接的通话：指已在通话中时，收到呼叫但暂未接听的通话
      * @param pushConfig 移动端推送信息
      */
-    hangup(callId?: string, pushConfig?: IRCCallPlusPushConfig, reason?: RCCallPlusReason): Promise<{
+    hangup(callId?: string, pushConfig?: IRCCallPlusPushConfig): Promise<{
         code: number;
     }>;
-    private _hangup;
     /**
      * 通话中发起媒体类型变更请求
      * @param mediaType 媒体类型
@@ -3667,4 +3531,4 @@ declare class RCCallPlusClient {
 
 declare const installer: IPluginGenerator<RCCallPlusClient, ICallPlusInitOpts>;
 
-export { IAndroidPushConfig, IAudioConfig, IAudioConfigBuilder, ICallOpts, ICallPlusEventListener, ICallPlusInitOpts, IRCCallPlusCallRecord, IRCCallPlusGetCallRecordRes, IRCCallPlusPushConfig, IRCCallPlusReceivedSummaryMessage, IRCCallPlusStartParams, IRCCallPlusSummaryMessageContent, 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 };