@rongcloud/plugin-call-plus 2.2.0-enterprise-lz-alpha.1 → 2.20.0

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, PluginContext, IRuntime, EnableLogL, IReceivedMessage, IPluginGenerator } from '@rongcloud/engine';
+import { RCRemoteTrack, RCTrack, ISubscribeAttr, RCRTCCode, RCLocalAudioTrack, RCRemoteAudioTrack, RCRTCClient, RCRTCRoom, RCLocalTrack, IPublishAttrs, IPubSuccessRes, 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 类型
      */
@@ -520,23 +508,22 @@ interface IStartCallCon {
      */
     oldRoomId?: string;
     /**
-      * 服务端接收的推送扩展
-      */
+     * 服务端接收的推送扩展
+     */
     pushExt?: string;
+    /**
+     * 推送内容
+     */
+    pushContent?: string;
     /**
      * 附加信息，服务器透传
      */
     extra?: string;
-    innerExtra?: string;
 }
 /**
  * 单呼信令内容
  */
 interface IStartSingleCon {
-    /**
-     * 客户端生成，传递给服务
-     */
-    callId?: string;
     /**
      * 用户生成 callId
      */
@@ -582,16 +569,15 @@ interface IStartSingleCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
+    /**
+     * 推送内容
+     */
+    pushContent?: string;
 }
 /**
  * 群呼信令内容
  */
 interface IStartGroupCon {
-    /**
-     * 客户端生成，传递给服务
-     */
-    callId?: string;
     /**
      * 用户生成 callId
      */
@@ -628,16 +614,10 @@ interface IStartGroupCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
     /**
-     * 是否密聊(0: 否；1: 是)
-     * PC 目前无密聊，写死 0
+     * 推送内容
      */
-    secretChat: SecretCallType;
-    /**
-     * 单聊加密 key
-     */
-    secretChatKey?: string;
+    pushContent?: string;
 }
 /**
  * 开始呼叫 Server 返回
@@ -674,7 +654,10 @@ interface IInviteCallCon extends IBaseSingalCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
-    innerExtra?: string;
+    /**
+     * 推送内容
+     */
+    pushContent?: string;
 }
 /**
  * 邀请好友加入信令结果
@@ -753,7 +736,7 @@ interface IPubInviteCon extends IBaseSingalCon {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 是否密聊
      */
@@ -774,14 +757,6 @@ interface IPubInviteCon extends IBaseSingalCon {
      * 附加信息
      */
     extra?: string;
-    /**
-     * 可存储的扩展信息，由发起人发起时定义
-     */
-    innerExtra?: string;
-    /**
-     * 通话加密密钥
-     */
-    secretChatKey?: string;
 }
 /**
  * 通话响铃信令内容
@@ -811,6 +786,10 @@ interface IHangupCallCon extends IBaseSingalCon {
      * 服务端接收的推送扩展
      */
     pushExt?: string;
+    /**
+     * 推送内容
+     */
+    pushContent?: string;
 }
 /**
  * 通话状态上报信令内容
@@ -1010,7 +989,6 @@ interface ISyncCallLogRes extends IBaseSingalCon {
      * 同步数据
      */
     syncTime: number;
-    innerExtra?: string;
 }
 interface ISyncCallLogResList {
     hasMore: 0 | 1;
@@ -1052,7 +1030,7 @@ interface ISignalTransporterListener {
     /**
      * 收到通话状态变更
      */
-    onStatusDown(data: IStatusDownCont, byServer: boolean, traceId: string): void;
+    onStatusDown(data: IStatusDownCont, traceId: string, sessionId?: string): void;
     /**
      * 其他端通话状态变更
      */
@@ -1084,7 +1062,7 @@ interface IGetUserCallStateListRes {
     callStateList: {
         callId: string;
         callType: RCCallPlusType;
-        mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+        mediaType: RCCallPlusMediaType;
         /**
          * 呼叫发起者 ID
          */
@@ -1118,8 +1096,6 @@ interface IGetUserCallStateListRes {
          */
         targetId: string;
         startTime: number;
-        innerExtra?: string;
-        secretChat: SecretCallType;
     }[];
 }
 interface IClearCallLogRes {
@@ -1140,7 +1116,7 @@ interface IGetCallSessionServerRes extends IBaseSingalCon {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 通话状态
      */
@@ -1169,9 +1145,6 @@ interface IGetCallSessionServerRes extends IBaseSingalCon {
      * 同步时间戳
      */
     syncTime: number;
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    secretChatKey?: string;
 }
 interface IGetCallTimeInfoRes extends IBaseSingalCon {
     /**
@@ -1242,14 +1215,6 @@ interface ISessionUser {
      * 成员系统状态
      */
     systemState: RCCallPlusReason;
-    /**
-     * 摄像头是否可用
-     */
-    cameraEnable: boolean;
-    /**
-     * 麦克风是否可用
-     */
-    microphoneEnable: boolean;
     /**
      * 来源组 ID 类型
      */
@@ -1324,14 +1289,6 @@ interface IRCCallPlusCallRecord {
      * 创建时间
      */
     createTimestamp: number;
-    /**
-     * 同步数据
-     */
-    syncData?: string;
-    /**
-     * 是否为加密通话
-     */
-    isSecret: boolean;
 }
 interface IUserInfo {
     /**
@@ -1355,15 +1312,7 @@ interface IUserInfo {
      */
     orgId?: string;
 }
-interface IStartCallOpts {
-    /**
-     * 通话唯一 ID
-     */
-    callId?: string;
-    /**
-     * 客户端 callId
-     */
-    clientCallId: string;
+interface IStartCallOpts extends ICallId {
     /**
      * 被邀请人信息
      */
@@ -1375,7 +1324,7 @@ interface IStartCallOpts {
     /**
      * 通话媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 当前用户来源组 ID 类型
      */
@@ -1397,12 +1346,6 @@ interface IStartCallOpts {
      * 附加信息，服务器透传
      */
     extra?: string;
-    /**
-     * 内部透传信息，服务器会记录该数据
-     */
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    secretChatKey?: string;
 }
 interface IStartCallResult {
     /**
@@ -1542,7 +1485,7 @@ interface IGetCallSessionRes extends ICallId {
     /**
      * 媒体类型
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
      * 通话状态
      */
@@ -1563,12 +1506,6 @@ interface IGetCallSessionRes extends ICallId {
      * 同步时间戳
      */
     syncTime: number;
-    innerExtra?: string;
-    secretChat: SecretCallType;
-    /**
-     * 通话加密密钥
-     */
-    secretChatKey?: string;
 }
 
 declare enum CallTimerEventType {
@@ -1613,17 +1550,8 @@ declare class RCCallInnerSession extends EventEmitter {
      */
     private _callUsers;
     private readonly _logger;
-    private readonly _isSecret;
     /**
-     * 同步数据
-     */
-    private _syncData;
-    /**
-     * 通话加密密钥
-     */
-    private _secretKey;
-    /**
-     * 暂存请求更新的 mediaType，无请求时为 null
+     * 请求更新的 mediaType
      */
     private _reqMediaType;
     /**
@@ -1664,7 +1592,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 通话媒体类型
      */
-    _mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO, 
+    _mediaType: RCCallPlusMediaType, 
     /**
      * session 呼叫发起者
      */
@@ -1676,15 +1604,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 当前 session 人员信息列表
      */
-    _callUsers: ISessionUser[], _logger: BasicLogger, _isSecret: boolean, 
-    /**
-     * 同步数据
-     */
-    _syncData?: string, 
-    /**
-     * 通话加密密钥
-     */
-    _secretKey?: string);
+    _callUsers: ISessionUser[], _logger: BasicLogger);
     /**
      * 获取 CallID
      */
@@ -1700,7 +1620,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 获取媒体类型
      */
-    getMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    getMediaType(): RCCallPlusMediaType;
     /**
      * 获取 session 发起者
      */
@@ -1716,7 +1636,7 @@ declare class RCCallInnerSession extends EventEmitter {
     /**
      * 请求更新的 mediaType
      */
-    getReqMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO | null;
+    getReqMediaType(): RCCallPlusMediaType | null;
     /**
      * inviterTimerId
      */
@@ -1726,7 +1646,6 @@ declare class RCCallInnerSession extends EventEmitter {
      */
     getInviteeTimerId(): number;
     getAllTimerIds(): number[];
-    setUserDeviceEnable(userId: string, mediaType: RCCallPlusMediaType, enable: boolean, traceId: string): void;
     /**
      * 更新人员列表, 并返回更新的人员列表
      * 根据人员状态去添加、删除、更新
@@ -1746,11 +1665,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
      */
@@ -1764,9 +1683,6 @@ declare class RCCallInnerSession extends EventEmitter {
      */
     setIsLocalClientHangup(isLocalClientHangup: boolean): void;
     getIsLocalClientHangup(): boolean;
-    getSyncData(): string | undefined;
-    isSecret(): boolean;
-    getSecretKey(): string;
 }
 
 declare enum CallServerAction {
@@ -2056,10 +1972,13 @@ declare class RCCallPlusReportModule {
         audioLevel: number;
     }[]): void;
     onReceivedCallPlusSummaryMessage(message: IRCCallPlusReceivedSummaryMessage): void;
+    onReceivedGroupCallStatusMessage(message: IReceivedGroupCallStatusMessage): void;
 }
 
 declare class SignalTransporter extends EventEmitter {
     private readonly _context;
+    private readonly _runtime;
+    private readonly _initOpts;
     private readonly _timeCorrectioner;
     private readonly _logger;
     private readonly _reportAppEventModule;
@@ -2075,8 +1994,10 @@ declare class SignalTransporter extends EventEmitter {
     /**
      * constructor
      */
-    constructor(_context: PluginContext, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: ICallPlusInitOpts, _timeCorrectioner: TimeCorrectioner, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
     private _onMessage;
+    private _dealMissMessage;
+    private _dealGroupCallMessage;
     getSessionId(): string;
     getDeviceId(): string;
     registerListener(listener: ISignalTransporterListener): void;
@@ -2207,7 +2128,7 @@ declare class SignalTransporter extends EventEmitter {
     /**
      * 补偿数据处理
      */
-    private _onCompensationData;
+    private _onConpensationData;
 }
 
 /**
@@ -2217,8 +2138,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
      */
@@ -2233,8 +2155,250 @@ declare class AbnormalCall {
     getAbnormalCallIds(userId: string): Promise<string[] | null>;
 }
 
+declare class RTCModule extends EventEmitter {
+    private readonly _context;
+    private readonly _runtime;
+    private readonly _initOpts;
+    private readonly _logger;
+    private readonly _callEngine;
+    private readonly _reportAppEventModule;
+    static __INNER_RTC_PROCESS_FAILED__: string;
+    static __INNER_RTC_PEERCONNECTION_ABNORMAL_CLOSE__: string;
+    static __INNER_ON_SELF_JOINED__: string;
+    static __INNER_ON_OTHER_JOINED__: string;
+    static __INNER_RECEIVE_FIRST_FRAME__: string;
+    static __INNER_ON_KICKOFF__: string;
+    /**
+     * RCRTC 实例
+     */
+    _rtcClient: RCRTCClient;
+    /**
+     * 己方的音视频 tracks
+     */
+    private _localTracks;
+    /**
+     * RCRTCRoom 实例
+     */
+    _room: RCRTCRoom | null;
+    private _callId;
+    private _callMediaType;
+    private _videoConfig;
+    private _audioConfig;
+    private _isPubTiny;
+    private _audioOutputDeviceId;
+    /**
+     * 视频配置是否变更
+     */
+    private _videoConfigIsChange;
+    /**
+     * 音频配置是否变更
+     */
+    private _audioConfigIsChange;
+    /**
+     * 存储设置的人员和视图
+     */
+    private _userViewMap;
+    private _callPlusStatusReportListener;
+    private _remoteAudioEnable;
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: ICallPlusInitOpts, _logger: BasicLogger, _callEngine: RCCallEngine, _reportAppEventModule: RCCallPlusReportModule);
+    setCallPlusStatusReportListener(listener: IStatusReportListener): void;
+    /**
+     * 取摄像头资源
+     * 内存中有时，返回内存中的视轨
+     */
+    getCameraVideoTrack(traceId: string): Promise<{
+        code: number;
+        track?: RCLocalTrack;
+    }>;
+    /**
+     * 取麦克风资源
+     * 内存中有时，返回内存中的音轨
+     */
+    getMicrophoneAudioTrack(traceId: string): Promise<{
+        code: number;
+        track?: RCLocalTrack;
+    }>;
+    /**
+     * 根据通话类型创建音、视频资源
+     * @param mediaType 音频或音视频
+     */
+    createCallMediaTracks(mediaType: RCCallPlusMediaType, traceId: string): Promise<{
+        code: number;
+    }>;
+    setVideoConfig(videoConfig: IVideoConfig): void;
+    setAudioConfig(audioConfig: IAudioConfig): void;
+    setAudioOutputDeviceId(deviceId: string): Promise<{
+        code: number;
+    }>;
+    destroyAllTracks(traceId: string): void;
+    setAllRemoteAudioEnable(enable: boolean, traceId: string): {
+        code: 80001;
+    } | {
+        code: 0;
+    };
+    destroyTrack(track: RCLocalTrack): Promise<void>;
+    /**
+     * session 连接
+     */
+    sessionConnected(callId: string, traceId: string): Promise<void>;
+    sessionClose(callId: string, traceId: string): Promise<void>;
+    /**
+     * 禁用视频 track
+     */
+    disableVideoTrack(): Promise<{
+        code: number | RCRTCCode;
+        track?: RCLocalTrack;
+    }>;
+    /**
+     * 启用视频track
+     * 1. 启用前应用层需先创建视频 track
+     */
+    enableVideoTrack(traceId: string): Promise<{
+        code: number | RCRTCCode;
+    }>;
+    /**
+     * 通话中切换视频设备
+     */
+    changeVideoDevice(traceId: string): Promise<{
+        code: number;
+        track?: RCLocalTrack;
+    }>;
+    /**
+     * 通话中更换音频设备
+     */
+    changeAudioDevice(traceId: string): Promise<{
+        code: number;
+    }>;
+    /**
+     * 禁用音频 track
+     */
+    disableAudioTrack(): Promise<{
+        code: number | RCRTCCode;
+        track?: RCLocalTrack;
+    }>;
+    /**
+     * 媒体类型升、降
+     */
+    changeMediaType(mediaType: RCCallPlusMediaType, traceId: string): Promise<void>;
+    /**
+     * 升级 音频 -> 音视频
+     * 1. 业务层需要先通过 createLocalTracks 创建本地视频 track
+     * 2. SDK 只处理发布视频 track
+     */
+    private _upgradeMediaType;
+    /**
+     * 降级处理
+     */
+    private _downgradeMediaType;
+    /**
+     * 加入 RTC 房间
+     */
+    joinRTCRoom(callId: string, traceId: string): Promise<{
+        code: number;
+        room?: RCRTCRoom;
+        tracks?: RCRemoteTrack[];
+    }>;
+    /**
+     * RTC 订阅
+     */
+    subscribeTracks(tracks: (ISubscribeAttr)[], traceId: string): Promise<{
+        code: number;
+    }>;
+    /**
+     * RTC 取消订阅
+     */
+    unsubscribeTracks(tracks: RCRemoteTrack[], traceId: string): Promise<{
+        code: number;
+    }>;
+    private _releaseStoredData;
+    getRemoteTracks(): {
+        [userId: string]: RCRemoteTrack[];
+    };
+    getRemoteTrack(userId: string, mediaType: RCCallPlusMediaType): RCRemoteTrack | undefined;
+    getRTCSessionId(): string | null;
+    /** ======私有方法============================================================================================= */
+    /**
+     * RTC 事件监听注册
+     */
+    private _regRTCListeners;
+    private _onLocalTrackReady;
+    private _onRemoteTrackReady;
+    private _onKickOff;
+    /**
+     * RTC Peer 异常关闭
+     * 移动端未处理此回调，定义 sysStatus 为 CONNECTION_ERR
+     */
+    private _onRTCPeerConnectionCloseByException;
+    private _onSelfJoined;
+    private _onRemoteTrackPublish;
+    private _onTrackUnpublish;
+    private _onAudioMuteChange;
+    private _onVideoMuteChagne;
+    private _onRTCStateReport;
+    /**
+   * RTC 接收最终失败后需要调用 hangup 挂断的情况
+   */
+    private _onRTCMethodFail;
+    private _onOtherMemJoined;
+    /**
+     * 创建本地音频 track, 创建成功后保存本地并回调通知
+     */
+    private _createAudioTrack;
+    /**
+     * 创建本地视频 track, 创建成功后保存本地并回调通知
+     */
+    private _createVideoTrack;
+    /**
+     * 获得本地缓存视频 track
+     */
+    getLocalVideoTrack(): RCLocalTrack | undefined;
+    /**
+     * 获得本地缓存音频 track
+     */
+    getLocalAudioTrack(): RCLocalTrack | undefined;
+    /**
+     * 发布本地资源的逻辑
+     */
+    publish(tracks: (RCLocalTrack | IPublishAttrs)[], traceId: string): Promise<{
+        code: number;
+    }>;
+    publishVideoTrack(): Promise<IPubSuccessRes>;
+    setVideoView(list: {
+        userId: string;
+        videoElement: HTMLVideoElement;
+        isTiny?: boolean;
+    }[], traceId: string): void;
+    /**
+     * 删除视图时，取消订阅资源
+     */
+    removeVideoView(userIds: string[], traceId: string): void;
+    /**
+     * 获取存储的人员和 video 元素数据
+     */
+    getUserViewMap(): {
+        [userId: string]: {
+            videoView: HTMLVideoElement;
+            isTiny: boolean;
+        };
+    };
+    /**
+     * 播放媒体资源
+     */
+    playMedia(userId: string, mediaType: RCCallPlusMediaType, videoView: HTMLVideoElement, traceId: string): Promise<{
+        code: 80104;
+    } | {
+        code: 80102;
+    } | {
+        code: RCRTCCode.PB_ERROR | RCRTCCode.SIGNAL_DISCONNECTED | RCRTCCode.PARAMS_ERROR | RCRTCCode.REPERT_JOIN_ROOM | RCRTCCode.NOT_IN_ROOM | RCRTCCode.SERVICE_INVALID | RCRTCCode.RTC_TOKEN_INVALID | RCRTCCode.SIGNAL_ERROR | RCRTCCode.CREATE_OFFER_FAILED | RCRTCCode.REQUEST_FAILED | RCRTCCode.MCU_SERVER_NOT_FOUND | RCRTCCode.BROADCAST_SUB_LIST_NOT_EMPTY | RCRTCCode.ROOM_HAS_BEEN_DESTROYED | RCRTCCode.NOT_OPEN_VIDEO_AUDIO_SERVER | RCRTCCode.GET_USER_MEDIA_FAILED | RCRTCCode.GET_DISPLAY_MEDIA_FAILED | RCRTCCode.BROWSER_PERMISSION_DENIED | RCRTCCode.CREATE_CUSTOM_TRACK_FAILED | RCRTCCode.INVALID_TAGS | RCRTCCode.INVALID_USER_ID | RCRTCCode.CREATE_FILE_TRACK_FAILED | RCRTCCode.INVALID_FILE_INSTANCE | RCRTCCode.SET_REMOTE_DESCRIPTION_FAILED | RCRTCCode.BROWSER_NOT_SUPPORT | RCRTCCode.TRACK_NOT_READY | RCRTCCode.VIDEO_TRACK_MISS_MEDIA_ELEMENT | RCRTCCode.TRACK_PLAY_ERROR | RCRTCCode.SIGNAL_AUDIENCE_JOIN_ROOM_FAILED | RCRTCCode.SIGNAL_ROOM_CHANGE_IDENTITY_FAILED | RCRTCCode.PACKAGE_ENVIRONMENT_ERROR | RCRTCCode.PUBLISH_TRACK_LIMIT_EXCEEDED | RCRTCCode.CDN_RESOURCE_IS_EMPTY | RCRTCCode.SIGNAL_JOIN_RTC_ROOM_REFUSED | RCRTCCode.NO_PERMISSION_TO_USE_REQUESTED_DEVICE | RCRTCCode.THE_FUNCTION_IS_DISABLED_IN_PKROOM | RCRTCCode.SOME_TRACKS_PUBLISH_FAILED | RCRTCCode.MAC_IN_ELECTRON_NOT_SUPPORT_SCREEN_SHARE_WITH_AUDIO | RCRTCCode.JWT_TIME_OUT | RCRTCCode.SYSTEM_PERMISSION_DENIED | RCRTCCode.PUBLISH_TRACKS_IS_INVALID | RCRTCCode.TRACK_READYSTATE_IS_ENDED | RCRTCCode.APPLY_3A_NOISE_WORKLET_BEFORE_PUBLISH | RCRTCCode.LOAD_3A_MODULE_FAILED;
+    } | {
+        code: 0;
+    }>;
+}
+
 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;
@@ -2276,10 +2440,14 @@ declare class RCCallEngine extends EventEmitter {
      * client callId
      */
     private _clientCallId;
+    /**
+     * session 需使用 rtc 模块取设备状态
+     */
+    private _rtcModule;
     /**
      * 构造器
      */
-    constructor(_context: PluginContext, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
+    constructor(_context: PluginContext, _runtime: IRuntime, _initOpts: ICallPlusInitOpts, _logger: BasicLogger, _reportAppEventModule: RCCallPlusReportModule);
     /**
      * 发起呼叫
      */
@@ -2401,8 +2569,7 @@ declare class RCCallEngine extends EventEmitter {
      * 通知人员状态
      * CallClient 也需要更新人员状态，定义为公共函数
      */
-    updateUsersState(callId: string, users: ISessionUser[], traceId: string): void;
-    setUserDeviceEnable(userId: string, mediaType: RCCallPlusMediaType, enable: boolean, traceId: string): void;
+    updateUsersState(callId: string, users: ISessionUser[], traceId: string): ISessionUser[];
     /**
      * 获取通话开始时间
      */
@@ -2443,6 +2610,7 @@ declare class RCCallEngine extends EventEmitter {
     endCurrentUserAbnormalCalls(allDevice: boolean): Promise<{
         code: number;
     }>;
+    setRTCModule(rtcModule: RTCModule): void;
     /** ======私有方法============================================================================================= */
     /**
      * IM 状态变更处理
@@ -2528,7 +2696,7 @@ declare class RCCallEngine extends EventEmitter {
      * A2 多端在接听和直接加入 call 时，上报 onPhoneEnd 状态，消除 B 端展示的 onPhone 状态
      */
     private _clearMobileOnPhone;
-    private _onUserStateChange;
+    reportRemoteUserStateChange(callId: string, users: ISessionUser[], traceId: string): void;
     private _onOtherMemberInvite;
     private _onRequestChangeMediaType;
     private _receiveMediaTypeChangeResult;
@@ -2542,10 +2710,12 @@ declare class RCCallPlusSession {
     private readonly _session;
     private readonly _callEngine;
     private readonly _logger;
+    private readonly _rtcModule;
+    private readonly _context;
     private _startTime;
     private _duration;
     private _callId;
-    constructor(_session: RCCallInnerSession, _callEngine: RCCallEngine, _logger: BasicLogger);
+    constructor(_session: RCCallInnerSession, _callEngine: RCCallEngine, _logger: BasicLogger, _rtcModule: RTCModule, _context: PluginContext);
     /**
      * 获取 CallId
      */
@@ -2561,7 +2731,7 @@ declare class RCCallPlusSession {
     /**
      * 获取通话媒体类型
      */
-    getMediaType(): RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    getMediaType(): RCCallPlusMediaType;
     /**
      * 获取通话人员列表
      */
@@ -2593,20 +2763,6 @@ declare class RCCallPlusSession {
         code: number;
         duration?: number;
     }>;
-    /**
-     * 获取通话中的缓存数据，数据由通话发起人在发起通话时定义
-     * @returns
-     */
-    getSyncData(): string | undefined;
-    /**
-     * 通话是否已加密
-     * @returns
-     */
-    isSecret(): boolean;
-    /**
-     * 获取通话加密密钥
-     */
-    getSecretKey(): string;
 }
 
 /**
@@ -2707,9 +2863,13 @@ interface ICallPlusInitOpts {
      * 是否发布小流
      */
     isPubTiny?: boolean;
+    /**
+     * ring 状态下是否允许立即开始新通话，默认为 true
+     */
+    isAllowNewCallWhenRinging?: boolean;
 }
 /**
- * 通话记录的消息 content 字段
+ * 单呼通话记录的消息 content 字段
  */
 interface IRCCallPlusSummaryMessageContent {
     /**
@@ -2744,95 +2904,96 @@ interface IRCCallPlusSummaryMessageContent {
      * 通话挂断原因
      */
     hangupReason: RCCallPlusReason;
+}
+/**
+ * 群呼通话记录的类型
+ */
+declare enum IGroupCallStatusMessageType {
     /**
-     * 是否为加密通话
-     */
-    isSecret: boolean;
-    /**
-     * 通话发起人定义的同步信息
+     * 群呼通话开始
      */
-    syncData?: string;
+    START = 1,
     /**
-     * 是否是本人挂断
+     * 群呼通话结束
      */
-    isSelfHangup: boolean;
+    END = 2
 }
 /**
- * 通话记录的消息结构定义
+ * 群呼通话记录的消息 content 字段
  */
-interface IRCCallPlusReceivedSummaryMessage extends IReceivedMessage {
-}
-/**
- * 发起呼叫参数
- */
-interface IRCCallPlusStartParams {
+interface IRCCallPlusGroupCallStatusMessageContent {
     /**
-     * callId，量子生成相同密钥时使用
+     * 通话呼叫id
      */
-    callId?: string;
+    callId: string;
     /**
-     * 被叫方通话用户列表
+     * 群呼状态:
+     * 1：群呼通话开始
+     * 2：群呼通话结束
      */
-    userIds: string[];
+    eventType: IGroupCallStatusMessageType;
     /**
-     * 通话类型，默认为 `RCCallPlusType.SINGLE`
-     * * `RCCallPlusType.SINGLE` - 发起单人呼叫
-     * * `RCCallPlusType.MULTI` - 发起多人呼叫
+     * 群组 Id
      */
-    type?: RCCallPlusType;
+    groupId: string;
     /**
-     * 通话媒体类型，默认为 `RCCallPlusMediaType.AUDIO_VIDEO` 音视频通话
-     * * `RCCallPlusMediaType.AUDIO` - 音频通话
-     * * `RCCallPlusMediaType.AUDIO_VIDEO` - 音视频通话
+     * 通话类型(0: AUDIO, 1: VIDEO)
      */
-    mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO;
+    mediaType: RCCallPlusMediaType;
     /**
-     * 推送配置，用于定义移动端接收呼叫时的推送行为
+     * 发起者 ID
      */
-    pushConfig?: IRCCallPlusPushConfig;
+    startUserId: string;
+    /**
+     * 通话开始时间
+     */
+    startTime: number;
     /**
-     * 透传信息，该信息将通过 `onReceivedCall` 回调时透传给被叫方
+     * 同步时间
      */
-    extra?: string;
+    syncTime: number;
     /**
-     * 定义通话同步数据，该数据与 `extra` 不同点，在于数据会被服务器存储，同时可通过 `session.getSyncData()` 获取；
-     * 数据不可超出 1024 Bytes
+     * 通话结束时间
      */
-    syncData?: string;
+    endTime: number;
     /**
-     * 加密配置
+     * 是否加密通话
      */
-    encryption?: {
-        /**
-         * 是否加密，默认不加密
-         */
-        isSecret: boolean;
-        /**
-         * 密钥
-         */
-        secretKey: string;
-    };
+    secretChat: SecretCallType;
+}
+/**
+ * 单呼通话记录的消息结构定义
+ */
+interface IRCCallPlusReceivedSummaryMessage extends IReceivedMessage {
+}
+/**
+ * 群呼通话记录的消息结构定义
+ */
+interface IReceivedGroupCallStatusMessage extends IReceivedMessage {
 }
 /**
  * callPlus 对外事件定义
  */
 interface ICallPlusEventListener {
     /**
-     * 呼入通知
-     * 收到呼入时，可选择接听或挂断通话
+     * 被呼叫通知
+     * 被呼叫或被邀请时，收到的通知
+     * 收到被呼叫时，可选择接听或挂断通话
      * @param session 通话实例
      * @param extra 透传呼叫方发起呼叫时携带的附加信息
      */
     onReceivedCall(session: RCCallPlusSession, extra?: string): void;
     /**
-     * 群组通话收到远端人员被邀请加入通话通知，如 A 与 B 通话中，A 邀请 C，则 B 会收到此回调
-     * @param inviteeUserList - 受邀人用户 ID 列表
-     * @param inviterUserId - 邀请者用户 ID
+     * 群组通话中，远端人员被邀请通知，如 A 与 B 通话中，A 邀请 C，则 B 会收到此回调
+     * @param inviteeUserList - 被邀请用户 ID 列表
+     * @param inviterUserId - 发起邀请者的用户 ID
      * @param callId - 所属通话；群聊中，己方已不在通话中的情况下，也会收到服务侧的事件通知
      */
     onRemoteUserInvited(inviteeUserList: string[], inviterUserId: string, callId: string): void;
     /**
-     * 通话已建立，sdk 内部会发布音视频资源
+     * 通话建立成功通知
+     * 通话建立后，sdk 内部会发布音视频资源
+     * @param session 通话实例
      */
     onCallConnected(session: RCCallPlusSession): void;
     /**
@@ -2843,54 +3004,54 @@ interface ICallPlusEventListener {
      */
     onUserMediaAvailable(userId: string, mediaType: RCCallPlusMediaType): void;
     /**
-     * 通话结束（群组通话时，客户端挂断不代表通话结束）
+     * 通话结束通知
+     * @description 群组通话，收到此通知时，仅代表本人退出通话，不代表通话结束，因为其他人可能仍在通话中
      * @param session 通话实例
      * @param reason 通话结束原因
      */
     onCallEnded(session: RCCallPlusSession, reason: RCCallPlusReason): void;
     /**
-     * 通话类型变更
-     * @param type 单呼或群呼
+     * 通话类型变更通知
+     * @param type 通话类型，单呼或群呼
      * @param callId 通话 id
      */
     onCallTypeChanged?(type: RCCallPlusType, callId: string): void;
     /**
-     * 人员状态变更
-     * @param callId 通话 id
-     * @param userId 状态变更人员 id
-     * @param state 人员变更后状态
-     * @param reason 变更原因
-     * @param extra 透传远端人员接听、挂断时携带的附加信息
+     * 远端人员状态变更通知
+     * @param callId 通话 Id
+     * @param userId 远端人员的 userId
+     * @param state 远端用户变更后的状态
+     * @param reason 远端用户状态变更原因
      */
     onRemoteUserStateChanged?(callId: string, userId: string, state: RCCallPlusSessionUserState, reason?: RCCallPlusReason): void;
     /**
-     * 远端摄像头开、关通知
+     * 远端用户摄像头开、关状态通知
      * @param callId 通话 id
-     * @param userId 用户 id
-     * @param disabled 是否关闭
+     * @param userId 远端用户 id
+     * @param disabled 摄像头是否关闭，true 为关闭状态，false 为打开状态
      */
     onRemoteCameraStateChanged?(callId: string, userId: string, disabled: boolean): void;
     /**
-     * 远端麦克风开、关通知
+     * 远端用户麦克风开、关状态通知
      * @param callId 通话 id
-     * @param userId 用户 id
-     * @param disabled 是否关闭
+     * @param userId 远端用户 id
+     * @param disabled 麦克风是否关闭，true 为关闭状态，false 为打开状态
      */
     onRemoteMicrophoneStateChanged?(callId: string, userId: string, disabled: boolean): void;
     /**
-     * 单呼或群呼结束后，服务器下发的通话日志
+     * 单呼或群呼结束后，服务器下发通话记录通知
      * @param record 数据接口定义为：IRCCallPlusCallRecord，可通过 apiDoc 查看具体包含字段
      */
     onReceivedCallRecord?(record: IRCCallPlusCallRecord): void;
     /**
-     * 收到媒体类型变更请求（仅单聊）
-     * @param userId 请求发起人
+     * 通话中，收到远端用户请求切换媒体类型通知（仅单聊）
+     * @param userId 远端用户 id，即请求发起人
      * @param transactionId 事物 id，本次请求和应答的唯一标识
-     * @param mediaType 请求变更的媒体类型
+     * @param mediaType 请求切换的媒体类型，音频或音视频
      */
     onReceivedChangeMediaTypeRequest?(userId: string, transactionId: string, mediaType: RCCallPlusMediaType): void;
     /**
-     * 媒体类型变更结果（仅单聊）
+     * 通话中，收到切换媒体类型结果通知（仅单聊）
      * @param info.userId
      * @param info.transactionId 事物 id，本次请求和应答的唯一标识
      * @param info.mediaType 最终的媒体类型
@@ -2906,10 +3067,11 @@ interface ICallPlusEventListener {
         code: RCCallPlusMediaTypeChangeResult;
     }): void;
     /**
-     * 收到通话开始计时
+     * 通话开始时间通知
      * @param info.callId 通话 id
-     * @param info.callType 单聊或群聊
-     * @param info.callStartTime 通话开始时间
+     * @param info.callType 通话类型，单聊或群聊
+     * @param info.callStartTime 通话开始时间戳(ms)
+     * @description 通话开始时间戳，为通话对应的房间首次被加入时的时间
      */
     onReceivedCallStartTime?(info: {
         callId: string;
@@ -2917,10 +3079,11 @@ interface ICallPlusEventListener {
         callStartTime: number;
     }): void;
     /**
-     * 收到首帧时间
-     * 收到首帧开始计费
+     * 收到首帧时间通知
+     * 通话从首帧时间开始计费
      * @param callId 通话 id
      * @param callFirstFrameTime 通话首帧到达时间
+     * @description 首帧时间戳，为通话中所有用户最早收到首帧的时间
      */
     onReceivedCallFirstFrameTime?(callId: string, callFirstFrameTime: number): void;
     /**
@@ -2930,20 +3093,32 @@ interface ICallPlusEventListener {
      */
     onFetchRemoteMediaError?(userId: string, code: number): void;
     /**
-     * 人员音量变化
+     * 通话中人员音量通知
+     * @description 默认每秒上报一次
      * @param userId 本端或远端人员 id
      * @param audioLevel 音量值（0-100）
      */
     onUserAudioLevelChanged?(userId: string, audioLevel: number): void;
     /**
-     * 收到通话结束的消息记录，可用于在 IM 聊天界面插入通话结束消息
-     * 仅单聊可收到
+     * 收到通话结束的消息记录通知
+     * @description 仅单聊可收到，可用于在 IM 聊天界面插入通话结束消息
      * 触发时机:
      * 1.单聊在线通话结束后
      * 2.离线时收到单聊呼叫，通话结束后，重新连接 IM 在线时
      * @param message 通话记录的消息体
      */
     onReceivedCallPlusSummaryMessage?(message: IRCCallPlusReceivedSummaryMessage): void;
+    /**
+     * 收到群组通话开始和结束的消息，可用于在 IM 聊天界面插入通话开始和结束消息
+     * 触发条件:
+     * 1.仅在同一个群组中的人员可收到
+     * 2.需在发起呼叫时设置 targtId 参数，targtId 为群组 id
+     * 触发时机:
+     * 1.群组通话开始或结束后
+     * 2.离线时群组里产生新通话，重新连接 IM 在线时
+     * @param message 通话记录的消息体
+     */
+    onReceivedGroupCallStatusMessage?(message: IReceivedGroupCallStatusMessage): void;
 }
 /**
  * 通话前视频配置
@@ -3067,15 +3242,6 @@ interface IStatusReportListener {
     onReceivePacketLoss(data: {
         [userId: string]: RCCallPlusPacketLossStats;
     }): void;
-    /**
-     * 上报远端视频信息，每秒回调一次
-     * @param info.width 视频宽度
-     * @param info.height 视频高度
-     */
-    onReceiveRemoteVideoInfo?(info: {
-        width: number;
-        height: number;
-    }): void;
 }
 /**
  * 人员及人员状态
@@ -3092,6 +3258,10 @@ interface IRCCallPlusPushConfig {
      * 推送标题
      */
     pushTitle: string;
+    /**
+     * 推送内容
+     */
+    pushContent?: string;
     /**
      * iOSConfig
      */
@@ -3198,19 +3368,6 @@ interface IAndroidPushConfig {
      */
     imageUrlHonor?: string;
 }
-/**
- * 服务端需要的 pushConfig 数据格式
- */
-interface IServerPushExt {
-    title: string;
-    templateId: string;
-    pushId: string;
-    disableTitle: boolean;
-    forceShowPushContent: boolean;
-    pushConfigs: {
-        [key: string]: any;
-    }[];
-}
 
 declare class RCAudioConfigBuilder {
     private _logger;
@@ -3336,6 +3493,7 @@ declare class RCCallPlusAndroidPushConfigBuilder {
 declare class RCCallPlusClient {
     private readonly _context;
     private readonly _logger;
+    private readonly _runtime;
     private readonly _initOpts;
     /**
      * 摄像头采集配置
@@ -3367,7 +3525,7 @@ declare class RCCallPlusClient {
      * 上报应用层事件模块
      */
     _reportAppEventModule: RCCallPlusReportModule;
-    constructor(_context: PluginContext, _logger: BasicLogger, _initOpts: ICallPlusInitOpts);
+    constructor(_context: PluginContext, _logger: BasicLogger, _runtime: IRuntime, _initOpts: ICallPlusInitOpts);
     /**
      * 加房间、发布、订阅失败时需结束通话，并上报原因
      */
@@ -3392,10 +3550,6 @@ declare class RCCallPlusClient {
      * 被踢出房间时，需结束通话
      */
     private _kickoffHandle;
-    /**
-     * 远端资源音视频状态变化，需更新 session 中人员的设备状态
-     */
-    private _receiveDeviceEnableChangeHandle;
     /**
      * 通话挂断时，需清空内存，离开房间
      */
@@ -3404,10 +3558,11 @@ declare class RCCallPlusClient {
      * 注册应用层事件
      * 包含“收到呼叫、通话结束、通话人员状态变更、通话类型变更”等事件
      * ICallPlusEventListener 对象请参考 apiDoc
+     * @description 重复调用时，会覆盖前一次的设置
      */
     setCallPlusEventListener(listener: ICallPlusEventListener): void;
     /**
-     * 注册音视频上下行丢包数据监听
+     * 设置通话质量数据监听
      * 每秒上报一次
      * @param listener 类型为 IStatusReportListener，详细定义可参考 apiDoc
      * @param listener.onSendPacketLoss  发送丢包率信息回调
@@ -3415,11 +3570,12 @@ declare class RCCallPlusClient {
      */
     setStatusReportListener(listener: IStatusReportListener): void;
     /**
-     * 设置要观看人员(包括自己和对方)的媒体播放器
+     * 设置渲染视图(包括自己和对方)
      * @param list 为一个列表，可传入多人的媒体播放器
      * @param item.userId 用户 id
      * @param item.videoElement 一个 video 元素，用于播放视频，需要挂载在业务层页面上
      * @param item.isTiny 是否观看别人的小流，小窗口时可以配置为 true，可节省带宽，userId 为远端用户时有效
+     * @description 暂不支持动态切换大小流
      * @returns code 返回是否设置成功
      */
     setVideoView(list: {
@@ -3430,7 +3586,7 @@ declare class RCCallPlusClient {
         code: number;
     };
     /**
-     * 删除某个人的媒体播放器
+     * 删除渲染视图
      * 不观看某个人的视频时，业务层可以直接移除对应的 video 标签，
      * 调 removeVideoView 方法，SDK 内部会停止接收对方的媒体传输
      * @param userIds 用户 id 列表
@@ -3444,12 +3600,9 @@ declare class RCCallPlusClient {
      * 播放某个人的视频前，请确保已经调用 `setVideoView` 方法为其设置视频视图
      * @param userId 指定要查看某个人的媒体资源
      * @param mediaType 指定播放音频还是视频
-     * @param volume 有效值为 0-100
      * @returns 返回是否播放成功
      */
-    playMedia(userId: string, mediaType: RCCallPlusMediaType, options?: {
-        volume?: number;
-    }): Promise<{
+    playMedia(userId: string, mediaType: RCCallPlusMediaType): Promise<{
         code: number;
     }>;
     /**
@@ -3459,8 +3612,8 @@ declare class RCCallPlusClient {
      */
     createVideoConfigBuilder(): RCVideoConfigBuilder;
     /**
-     * 设置视频配置
-     * 下次采集时生效，如切换摄像头、重新建立通话
+     * 设置视频配置：分辨率、最大/最小码率、帧率、摄像头 ID 等信息
+     * 需要通话建立前设置
      */
     setVideoConfig(cfg: IVideoConfig): {
         code: number;
@@ -3479,8 +3632,8 @@ declare class RCCallPlusClient {
      */
     createAndroidPushConfigBuilder(): RCCallPlusAndroidPushConfigBuilder;
     /**
-     * 设置音频配置
-     * 下次采集时生效，如重新建立通话
+     * 设置音频配置：码率、采样率、音频采集设备 ID
+     * 需要通话建立前设置
      */
     setAudioConfig(cfg: IAudioConfig): {
         code: number;
@@ -3494,36 +3647,32 @@ declare class RCCallPlusClient {
     }>;
     /**
      * 发起呼叫
-     * @deprecated 接口已废弃，请使用 `startCallWithParams` 接口替代
      * @param userIds 被叫人员 userId 列表，单人呼叫仅需在数组中放置对方一人的 userId
-     * @param callType 单人呼叫 or 多人呼叫
-     * @param mediaType 通话媒体类型: 音频 or 音视频
+     * @param type 单人呼叫或多人呼叫
+     * @param mediaType 通话媒体类型: 音频或音视频
      * @param pushConfig 移动端推送信息
      * @param extra 附加信息，会透传给被呼叫方
+     * @param targetId 多人通话时，共同所在的群组 id
+     * @description 重试逻辑：信令发送失败时，sdk 内部会间隔 2 秒重试一次，直到成功或超过，超时时间为一分钟
      * @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, targetId?: string): Promise<{
         code: number;
         callId?: string;
     }>;
     /**
      * 直接加入进行中的群组通话
+     * @description 只要能获取到群组通话ID，无论是否被邀请过，都可以直接加入
+     * @description 重试逻辑：信令发送失败时，sdk 内部会间隔 2 秒重试一次，直到成功或超过，超时时间为一分钟
      * @param callId 通话 id
      */
     joinMultiCall(callId: string): Promise<{
         code: number;
     }>;
     /**
-     * 通话中邀请他人
-     * 单人通话中邀请他人会引发通话类型变更
+     * 单聊或群组通话过程中邀请其他人加入
+     * @description 单人通话中邀请他人会引发通话类型变更
+     * @description 重试逻辑：信令发送失败时，sdk 内部会间隔 2 秒重试一次，直到成功或超过，超时时间为一分钟
      * @param userIds 被邀请人列表
      * @param pushConfig 移动端推送信息
      * @param extra 附加信息，会透传给被邀请方
@@ -3535,25 +3684,28 @@ declare class RCCallPlusClient {
     }>;
     /**
      * 接听通话
+     * @description 重试逻辑：信令发送失败时，sdk 内部会间隔 2 秒重试一次，直到成功或超过，超时时间为一分钟
      * @param callId 通话 id
      * @param pushConfig 移动端推送信息
      */
     accept(callId: string, pushConfig?: IRCCallPlusPushConfig): Promise<{
         code: number;
     }>;
-    private _innerHangup;
+    private __innerHangup;
     /**
      * 挂断通话
-     * @param callId 可选参数；当存在多个通话时，可通过该参数指定要挂断的通话；不传时 SDK 将挂断当前进行中的通话；
+     * @param callId 为可选参数，不传时，挂断正在进行的主 session，传入时可指定挂断主通话或暂未建立连接的通话
+     * 暂未建立连接的通话：指已在通话中时，收到呼叫但暂未接听的通话
+     * 挂断指定通话时，不影响其他通话状态
      * @param pushConfig 移动端推送信息
      */
-    hangup(callId?: string, pushConfig?: IRCCallPlusPushConfig, reason?: RCCallPlusReason): Promise<{
+    hangup(callId?: string, pushConfig?: IRCCallPlusPushConfig): Promise<{
         code: number;
     }>;
-    private _hangup;
     /**
-     * 通话中发起媒体类型变更请求
-     * @param mediaType 媒体类型
+     * 通话中发起媒体类型切换请求
+     * @param mediaType 媒体类型，音频或音视频
+     * @description 仅单呼时支持媒体类型切换，无需业务层操作摄像头
      * @returns transactionId 客户端和服务端交互的事务 id，在取消或应答媒体类型切换时传入
      */
     requestChangeMediaType(mediaType: RCCallPlusMediaType.AUDIO | RCCallPlusMediaType.AUDIO_VIDEO): Promise<{
@@ -3561,26 +3713,29 @@ declare class RCCallPlusClient {
         transactionId?: string;
     }>;
     /**
-     * 取消切换媒体类型变更请求
+     * 取消已经发起的媒体类型切换请求
      * @param transactionId 客户端和服务端交互的事务 id，为发起媒体类型变更请求返回的 transactionId
+     * @description 仅单呼时支持，可在调用 requestChangeMediaType 之后执行取消
      */
     cancelChangeMediaType(transactionId: string): Promise<{
         code: number;
     }>;
     /**
-     * 媒体类型变更应答
+     * 响应通话中媒体类型切换请求
      * @param transactionId 客户端和服务端交互的事务 id，为 onReceivedChangeToVideo 监听收到 transactionId 参数值
+     * @param isAgree 是否同意切换媒体类型
+     * @description 仅单呼时支持
      */
     replyChangeMediaType(transactionId: string, isAgree: boolean): Promise<{
         code: number;
     }>;
     /**
-     * 获取当前进行中的通话
+     * 获取当前进行中的通话实例
      * @returns RCCallPlusSession 对象或 null 为当前正在进行的通话对象
      */
     getCurrentCallSession(): RCCallPlusSession | null;
     /**
-     * 从服务器获取未结束的通话记录
+     * 从服务器获取当前用户未结束的通话记录
      * @returns records 一组未结束的通话记录
      */
     getAvailableCallRecordsFromServer(): Promise<{
@@ -3588,7 +3743,7 @@ declare class RCCallPlusClient {
         records?: IRCCallPlusCallRecord[];
     }>;
     /**
-     * 分页查找当前用户的全部通话记录
+     * 获取当前用户的通话记录
      * @param startTimestamp 起始时间戳，
      * 首次获取可传 -1，倒序时，返回最新的通话记录，正序时，返回最早的通话记录
      * order 为正序时，返回大于此时间戳的通话记录
@@ -3606,20 +3761,21 @@ declare class RCCallPlusClient {
         result?: IRCCallPlusGetCallRecordRes;
     }>;
     /**
-     * 根据 callId 集合批量删除通话记录
-     * @param callIds callId 列表
+     * 批量删除当前用户通话记录
+     * @param callIds 需要删除通话记录的 callId 列表
      */
     deleteCallRecordsFromServer(callIds: string[]): Promise<{
         code: number;
     }>;
     /**
-     * 清空所有通话记录
+     * 删除当前用户所有通话记录
      */
     deleteAllCallRecordsFromServer(): Promise<{
         code: number;
     }>;
     /**
      * 开启摄像头
+     * @description 视频通话建立后默认状态为开启
      * @description 通话过程中打开摄像头，如果扩散资源失败，即对方没收到本端打开摄像头的通知时，此次行为失败
      * @returns track 摄像头视频资源
      */
@@ -3633,7 +3789,8 @@ declare class RCCallPlusClient {
         code: number;
     }>;
     /**
-     * 切换摄像头功能，通话前和通话中都可调用。
+     * 切换指定摄像头
+     * @description 通话建立前和通话过程中都可调用
      * @param cameraId 浏览器中取得的摄像头设备 id，可调 getCameras 方法取得
      * @description 切换成功后，`ICallPlusEventListener` 监听器的 `onUserMediaAvailable` 会被触发，此时调用 `callPlusClient.playMedia` 方法播放新的资源。
      */
@@ -3642,6 +3799,7 @@ declare class RCCallPlusClient {
     }>;
     /**
      * 开启麦克风
+     * @description 通话建立后默认开启
      * @description 通话过程中打开麦克风，如果扩散资源失败，即对方没收到本端打开麦克风的通知时，此次行为失败
      */
     startMicrophone(): Promise<{
@@ -3655,12 +3813,13 @@ declare class RCCallPlusClient {
         code: number;
     }>;
     /**
-     * 麦克风是否开启
+     * 获取麦克风开关状态
      */
     isMicrophoneEnabled(): boolean;
     /**
      * 设置所有远端音频流是否可用
      * @param enable 为 true 时，启用所有远端音频流；为 false 时，静音所有远端音频流
+     * @description 静音操作仅不播放远端用户音频流，媒体通道还会继续接收远端音频数据
      */
     setAllRemoteAudioEnable(enable: boolean): Promise<{
         code: number;
@@ -3691,14 +3850,8 @@ declare class RCCallPlusClient {
     switchMicrophone(microphoneId: string): Promise<{
         code: number;
     }>;
-    /**
-     * 客户端生成 callId，量子特定，用于生成同样的密钥
-     * 呼叫时传给服务，通话 callId 为此 callId
-     * @param userId 用户 id
-     */
-    generateCallId(userId: string): string;
 }
 
 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, IGroupCallStatusMessageType, IRCCallPlusCallRecord, IRCCallPlusGetCallRecordRes, IRCCallPlusGroupCallStatusMessageContent, IRCCallPlusPushConfig, IRCCallPlusReceivedSummaryMessage, IRCCallPlusSummaryMessageContent, IReceivedGroupCallStatusMessage, IStatusReportListener, IVideoConfig, IVideoConfigBuilder, IiOSPushConfig, RCAudioConfigBuilder, RCCallPlusAndroidPushConfigBuilder, RCCallPlusCallState, RCCallPlusCallUser, RCCallPlusClient, RCCallPlusCode, RCCallPlusMediaType, RCCallPlusMediaTypeChangeResult, RCCallPlusPacketLossStats, RCCallPlusReason, RCCallPlusSession, RCCallPlusSessionUserState, RCCallPlusType, RCVideoConfigBuilder, installer };