@rongcloud/plugin-rtc 5.5.6 → 5.6.2-enterprise.1

package/dist/index.d.ts

@@ -1,11 +1,10 @@
 /*
- * RCRTC - v5.5.6
- * CommitId - bdde7363c1a0707e32aa8e4383c0ab3796755c6c
- * Tue Nov 01 2022 18:49:56 GMT+0800 (China Standard Time)
+ * RCRTC - v5.6.2-enterprise.1
+ * CommitId - 997fa7d5adea5b993240a0ca44660464b5de8b5f
+ * Mon Nov 14 2022 16:28:20 GMT+0800 (China Standard Time)
  * ©2020 RongCloud, Inc. All rights reserved.
  */
-import * as _rongcloud_engine from '@rongcloud/engine';
-import { EventEmitter, RTCPluginContext, AbsCodec, IPromiseResult, ErrorCode, KVString, IAsyncRes, ConnectionStatus, ConversationType, ISendMsgOptions, IReceivedMessage, IRuntime, LogLevel, IPluginGenerator } from '@rongcloud/engine';
+import { EventEmitter, BasicLogger, INaviInfo, RTCPluginContext, AbsCodec, IPromiseResult, ErrorCode, KVString, IRuntime, IAsyncRes, ConnectionStatus, ConversationType, ISendMsgOptions, IReceivedMessage, EnableLogL, IPluginGenerator } from '@rongcloud/engine';
 
 /**
  * 错误码，与移动端对齐
@@ -20,6 +19,8 @@ import { EventEmitter, RTCPluginContext, AbsCodec, IPromiseResult, ErrorCode, KV
 declare enum RCRTCCode {
     /** 成功 */
     SUCCESS = 10000,
+    /** PB 错误 */
+    PB_ERROR = 40001,
     /** IM 服务未连接 */
     SIGNAL_DISCONNECTED = 50000,
     /** 参数错误 */
@@ -172,6 +173,8 @@ declare abstract class RCTrack extends EventEmitter {
     protected readonly _streamId: string;
     protected _msTrack?: MediaStreamTrack;
     private _msStream;
+    protected _logger: BasicLogger | null;
+    protected readonly DataTrackId: string;
     constructor(_tag: string, _userId: string, _kind: 'audio' | 'video', _isLocalTrack: boolean, _roomId?: string | undefined);
     /**
      * 获取音视轨所属的 streamId，streamId 相同的音轨和视轨可认为属于统一道流
@@ -538,11 +541,11 @@ declare enum RCRTCPingResult {
  */
 declare enum RCRTCLiveRole {
     /**
-     * 主播
+     * 主播降级
      */
     ANCHOR = 1,
     /**
-     * 观众
+     * 观众升级
      */
     AUDIENCE = 2
 }
@@ -646,7 +649,19 @@ declare enum RTCMode {
     /**
     * 跨应用直播
     */
-    CROSS_LIVE = 8
+    CROSS_LIVE = 8,
+    /**
+     * sip呼叫
+     */
+    SIP = 4,
+    /**
+     * 呼叫模式.包括单呼和群呼
+     */
+    CALL = 5,
+    /**
+     * 会议
+     */
+    MEETING = 6
 }
 
 /**
@@ -1241,8 +1256,9 @@ declare enum RTCIdentityChangeType {
 }
 
 declare const keymaps: {
-    readonly RtcInput: readonly ["roomType", "broadcastType", "extraInnerData", "needSysChatroom", "identityChangeType", "joinType", "innerDatas", "outerDatas"];
-    readonly RtcUserListOutput: readonly ["users", "token", "sessionId", "roomInfo"];
+    readonly RtcInput: readonly ["roomType", "broadcastType", "extraInnerData", "needSysChatroom", "identityChangeType", "joinType", "innerDatas", "outerDatas", "supportNtf"];
+    readonly RtcOutput: readonly ["version"];
+    readonly RtcUserListOutput: readonly ["users", "token", "sessionId", "roomInfo", "version"];
     readonly SetUserStatusInput: readonly ["status"];
     readonly RtcSetDataInput: readonly ["interior", "target", "key", "value", "objectName", "content"];
     readonly RtcUserSetDataInput: readonly ["valueInfo", "objectName", "content"];
@@ -1266,6 +1282,16 @@ declare const keymaps: {
     readonly RtcCancelInviteInput: readonly ["invitedUserId", "invitedRoomId", "inviteInfo", "inviteSessionId"];
     readonly RtcInviteAnswerInput: readonly ["inviteUserId", "answerCode", "inviteRoomId", "inviteSessionId", "content", "key", "value"];
     readonly RtcEndInviteInput: readonly ["inviteRoomId", "inviteSessionId", "inviteContent", "inviteRoomKeys"];
+    readonly RtcRoomStatusInput: readonly ["version"];
+    readonly RtcRoomStatusOutput: readonly ["bFullStatus", "version", "usersData", "roomStatus"];
+    readonly RtcReportSDKInput: readonly ["sdkInfo"];
+    readonly RCRTCPBPolaris: readonly ["type", "appKey", "sessionId", "roomId", "roomCreateTime", "userId", "userRole", "joinTime", "signalDataCenter", "r1Info", "r2Info", "r3Info", "r4Info"];
+    readonly RCRTCPBR1Info: readonly ["joinTime", "rtcVersion", "imVersion", "platform", "device", "os", "browserName", "browserVersion"];
+    readonly RCRTCPBR2Info: readonly ["joinTime", "sendTime", "rtcActionType", "rtcActionStatus", "trackId"];
+    readonly RCRTCPBR3Info: readonly ["info"];
+    readonly RCRTCPBR4Info: readonly ["info"];
+    readonly RCRTCPBStatusInfo: readonly ["joinTime", "receiveTime", "totalBitRate", "appCPUUsage", "systemCPUUsage", "systemCPUFrequency", "networkStatus", "googleRTTNetwork", "ipAddress", "useReceiveBroadBand", "useSendBroadBand", "packetLossCount", "streams"];
+    readonly RCRTCPBStreamInfo: readonly ["trackId", "codeName", "volume", "samplingRate", "bitRate", "packetLossRate", "frameRate", "resolution", "blockTime", "jitterData", "nAckCount", "pliCount", "googleRTTTotalTime", "isReceiveFirstFrameRate", "codeType", "isEnabled"];
 };
 declare type RTCKeyMaps = typeof keymaps;
 
@@ -1331,6 +1357,10 @@ interface IJoinRTCRoomData extends IRTCUsers {
     }[];
     kvEntries: IServerRTCRoomEntry[];
     offlineKickTime: number;
+    codeFormat?: string;
+    roomCreateTime?: number;
+    userJoinTime?: number;
+    version: number;
 }
 interface IReqRoomPKOptions {
     /**
@@ -1436,11 +1466,42 @@ interface IEndRoomPKOptions {
      */
     keys: string[];
 }
+interface IRTCNaviInfo extends INaviInfo {
+    /**
+     * jwt token
+    */
+    jwt?: string;
+    /**
+     * http3 上报域名
+    */
+    logServer?: string;
+    /**
+     * 数据中心
+    */
+    dc?: string;
+    /**
+     *  openGzip  开启标识,默认是false,开启使用true
+    */
+    openGzip?: boolean;
+}
+
+/**
+ * 自定义上报北极星数据响应 code
+*/
+declare enum RCSendCode {
+    NOT_REPORT = -1,
+    REPORT_SUCCESS = 10000,
+    REPORT_FAIL = 0,
+    PB_ERROR = 40001
+}
 
 declare class RTCContext {
     private context;
     private codec;
+    roomCreateTime: number | undefined;
+    userJoinTime: number | undefined;
     constructor(context: RTCPluginContext, codec: AbsCodec<RTCKeyMaps>);
+    logger: BasicLogger | null;
     joinRTCRoom(roomId: string, mode: RTCMode, broadcastType?: number, joinType?: RTCJoinType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): IPromiseResult<IJoinRTCRoomData>;
     quitRTCRoom(roomId: string): Promise<ErrorCode>;
     getRTCRoomInfo(roomId: string): IPromiseResult<IRTCRoomInfo>;
@@ -1472,6 +1533,10 @@ declare class RTCContext {
     getRTCOutData(roomId: string, userIds: string[]): IPromiseResult<unknown>;
     getRTCToken(roomId: string, mode: number, broadcastType?: number): IPromiseResult<IRtcTokenData>;
     setRTCState(roomId: string, report: string): Promise<ErrorCode>;
+    /**
+     * 通过 http 方式上报 rtc state
+    */
+    setRTCStateByHttp(logServer: string, runtime: IRuntime, report: IRCRTCReportData, reportType: string): Promise<RCSendCode | RCRTCCode>;
     getRTCUserList(roomId: string): IPromiseResult<IRTCUsers>;
     joinLivingRoomAsAudience(roomId: string, mode: RTCMode, broadcastType?: number): Promise<IAsyncRes<{
         token: string;
@@ -1485,16 +1550,41 @@ declare class RTCContext {
     endRoomPK(options: IEndRoomPKOptions): Promise<ErrorCode>;
     getRTCJoinedUserInfo(userId: string): Promise<IAsyncRes<IRTCJoinedInfo[]>>;
     pullRTCRoomEntry(roomId: string): Promise<IAsyncRes<IChrmKVPullData>>;
+    /**
+     * 通知拉取房间数据
+     * @param roomId 房间 id
+     * @param version 本地最大得房间数据版本号
+     */
+    pullRTCRoomStatus(roomId: string, version: number): Promise<{
+        code: ErrorCode;
+        data?: IPullRTCRoomStatus;
+    }>;
     decodeRtcNotify(buffer: Uint8Array): {
         time: number;
         type: any;
         roomId: any;
     };
     getCurrentId(): string;
-    getNaviInfo(): _rongcloud_engine.INaviInfo | null;
+    getNaviInfo(): IRTCNaviInfo | null;
     getConnectionStatus(): ConnectionStatus;
     getAppkey(): string;
-    rtcPing(roomId: string, roomMode: number, broadcastType?: number): Promise<ErrorCode>;
+    /** web 端发 rtcPing */
+    webRtcPing(roomId: string, roomMode: RTCMode, broadcastType?: number): Promise<{
+        code: ErrorCode;
+        data?: {
+            version: number;
+        };
+    }>;
+    /**
+     * 协议栈 rtcping 依赖 imlib 编解码数据
+     * web 单独走 imlib 提供的 rtcSignaling 方法，减少对 imlib 的依赖
+     */
+    rtcPing(roomId: string, roomMode: RTCMode, broadcastType?: number): Promise<{
+        code: ErrorCode;
+        data?: {
+            version: number;
+        } | undefined;
+    }> | Promise<IAsyncRes<any>>;
     sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions): IPromiseResult<IReceivedMessage>;
     registerRTCSignalListener(listener?: ((buffer: Uint8Array) => void) | undefined): void;
     registerConnectionStateChangeListener(listener: (status: ConnectionStatus) => void): void;
@@ -1503,6 +1593,9 @@ declare class RTCContext {
     registerMessageListener(listener: (message: IReceivedMessage) => boolean): void;
     getCoreVersion(): string;
     getPluginContext(): RTCPluginContext;
+    reportSDKInfo(versionInfo: {
+        [name: string]: string;
+    }): void;
 }
 
 declare class RCMediaService {
@@ -1546,7 +1639,7 @@ declare class RCMediaService {
     private static msInDetector;
     private static detectorTime;
     private static detectValidMinute;
-    private static naviRefetchCount;
+    static jwtToken: string;
     private _msList;
     constructor(_runtime: IRuntime, _context: RTCContext, 
     /**
@@ -1584,7 +1677,7 @@ declare class RCMediaService {
      * @param header
      * @param body
      */
-    exchange(headers: IRTCReqHeader, body: IExchangeReqBody): Promise<{
+    exchange(headers: IRTCReqHeader, body: IExchangeReqBody, traceId: string): Promise<{
         code: RCRTCCode;
         data?: IExchangeResponse | undefined;
     }>;
@@ -1672,6 +1765,7 @@ declare class RCRTCPeerCManager {
      * 存储创建的所有 peerC，key 为 pcName，/exchange 请求中 request header 中的 Peer-Connection-Id 值
      */
     private _mutilPeerC;
+    onTrackTrouble?: Function;
     constructor(
     /**
      * 是否使用多 peerConnection
@@ -1692,7 +1786,7 @@ declare class RCRTCPeerCManager {
     /**
      * 北极星上报模块
      */
-    _polarisReport?: PolarisReporter | undefined);
+    _polarisReport?: PolarisHttpReporter | undefined);
     get useMutilPeerC(): boolean;
     /**
      * 根据 track 判断是否为上行
@@ -1812,7 +1906,7 @@ declare abstract class ReadableStore {
     readonly roomId: string;
     readonly crtUserId: string;
     readonly roomMode: RTCMode;
-    readonly polarisReport: PolarisReporter;
+    readonly polarisReport: PolarisHttpReporter;
     readonly isUpgrade?: boolean | undefined;
     readonly isMainRoom?: boolean | undefined;
     /**
@@ -1844,7 +1938,8 @@ declare abstract class ReadableStore {
     protected _CDNUris: ICDNUris | null;
     protected _CDNEnable: boolean;
     protected _destroyed: boolean;
-    constructor(context: RTCContext, service: RCMediaService, peerMgr: RCRTCPeerCManager, roomId: string, crtUserId: string, roomMode: RTCMode, polarisReport: PolarisReporter, isUpgrade?: boolean | undefined, isMainRoom?: boolean | undefined);
+    protected _roomStatusVersion: number;
+    constructor(context: RTCContext, service: RCMediaService, peerMgr: RCRTCPeerCManager, roomId: string, crtUserId: string, roomMode: RTCMode, polarisReport: PolarisHttpReporter, isUpgrade?: boolean | undefined, isMainRoom?: boolean | undefined);
     get useMutilPeerC(): boolean;
     getResourcesByUserId(userId: string): IPublishedResource[] | undefined;
     getRemoteTrack(trackId: string): RCRemoteTrack | undefined;
@@ -1864,10 +1959,11 @@ declare abstract class ReadableStore {
     getTrackState(trackId: string): 0 | 1;
     getCDNEnable(): boolean;
     getCDNUris(): ICDNUris | null;
+    getRoomStatusVersion(): number;
 }
 declare class Store extends ReadableStore {
     private _initRemoteTracks;
-    initWithRoomData(data: IJoinRTCRoomData): void;
+    initWithRoomData(data: IJoinRTCRoomData, traceId: string): void;
     assignRoomData(data: RoomData): void;
     setResourcesByUserId(userId: string, arr: IPublishedResource[]): void;
     removeRemoteTrack(trackId: string): void;
@@ -1878,6 +1974,7 @@ declare class Store extends ReadableStore {
     setCDNUris(uris: ICDNUris | null): void;
     resetSubscribedList(subscribeList: ISubscribeAttr[]): void;
     resetCollectSubscribeList(collectSubscribeList: ISubscribeAttr[]): void;
+    setRoomStatusVersion(version: number): void;
 }
 
 declare enum CommandPriority {
@@ -1944,7 +2041,7 @@ declare class BaseInvoker<STORE> {
  * 房间任务队列管理
  */
 declare class Invoker extends BaseInvoker<Store> {
-    constructor(context: RTCContext, service: RCMediaService, peerMrg: RCRTCPeerCManager, roomId: string, crtUserId: string, mode: RTCMode, reporter: PolarisReporter, isUpgrade?: boolean, isMainRoom?: boolean);
+    constructor(context: RTCContext, service: RCMediaService, peerMrg: RCRTCPeerCManager, roomId: string, crtUserId: string, mode: RTCMode, reporter: PolarisHttpReporter, isUpgrade?: boolean, isMainRoom?: boolean);
     /**
      * 获取 store 存储实例，返回值类型 `ReadableStore`，避免非 command 定义中修改内存
      */
@@ -2142,6 +2239,7 @@ declare abstract class RCAbstractRoom extends EventEmitter {
      */
     protected readonly _useMutilPeerC?: boolean | undefined;
     protected readonly _clientSessionId: string;
+    protected readonly signalRetryTime: number;
     /**
      * 房间保活 rtcPing
      */
@@ -2149,7 +2247,7 @@ declare abstract class RCAbstractRoom extends EventEmitter {
     /**
      * 北极星上报实例
      */
-    protected _polarisReport: PolarisReporter | null;
+    protected _polarisReport: PolarisHttpReporter | null;
     /**
      * 音量上报实例
      */
@@ -2160,12 +2258,31 @@ declare abstract class RCAbstractRoom extends EventEmitter {
     protected _peerCManager: RCRTCPeerCManager | null;
     protected readonly _invoker: Invoker;
     protected readonly _store: ReadableStore;
+    /**
+     * RCRTCRoom 类的构造函数。
+     * @param {RTCContext} _context - RTC上下文，
+     * @param {IRuntime} _runtime - 运行时
+     * @param {string} _roomId - 房间号
+     * @param {RTCMode} _roomMode - RTC模式，
+     * @param {RCMediaService} _service - RCMediaService
+     * @param {IRCRTCInitOptions} _initOptions - IRCRTCInitOptions
+     * @param {boolean} [isUpgrade] - 是否是升级，如果是升级则不会创建新的peerConnection
+     * @param {boolean} [isMainRoom] - 无论是主房间，主房间都是用户创建的房间，子房间是用户创建的房间。
+     * @param {boolean} [_useMutilPeerC] - 是否使用多个 peerConnections
+     * @param {string} _clientSessionId - 客户端会话 ID，用于标识客户端。
+     * @param {number} signalRetryTime - 发送信号的时间间隔。
+     */
     constructor(_context: RTCContext, _runtime: IRuntime, _roomId: string, _roomMode: RTCMode, _service: RCMediaService, _initOptions: IRCRTCInitOptions, isUpgrade?: boolean, isMainRoom?: boolean, 
     /**
      * 是否使用多 peerConnection
      */
-    _useMutilPeerC?: boolean | undefined, _clientSessionId?: string);
-    __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): Promise<{
+    _useMutilPeerC?: boolean | undefined, _clientSessionId?: string, signalRetryTime?: number);
+    /**
+     * 拉取房间数据
+     * @param roomId 房间 id
+     */
+    private _startPullRTCRoomStatus;
+    __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData, traceId?: string): Promise<{
         code: RCRTCCode | ErrorCode;
         data?: IJoinRTCRoomData;
     }>;
@@ -2185,7 +2302,7 @@ declare abstract class RCAbstractRoom extends EventEmitter {
     private _onTrackReady;
     protected _callAppListener(eventType: keyof IRoomEventListener, ...attrs: any[]): void;
     private _onTrackUnpublish;
-    __parseInnerMessage(message: IReceivedMessage): boolean;
+    __parseInnerMessage(message: IReceivedMessage, traceId: string): boolean;
     /**
      * 被踢出房间通知
      * @param byServer
@@ -2200,13 +2317,17 @@ declare abstract class RCAbstractRoom extends EventEmitter {
      * @param messageType 消息类型
      * @param userId 消息发送者
      */
-    protected _resourceHandle(content: ResourceMsgContent, messageType: RCRTCMessageType.PUBLISH | RCRTCMessageType.UNPUBLISH | RCRTCMessageType.MODIFY | RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId: string): Promise<void>;
+    protected _resourceHandle(content: ResourceMsgContent, messageType: RCRTCMessageType.PUBLISH | RCRTCMessageType.UNPUBLISH | RCRTCMessageType.MODIFY | RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId: string, traceId: string): Promise<void>;
     private _onTrackPublish;
     /**
      * 处理 `RCRTCMessageType.STATE` 消息
      * @param content
      */
     private _stateHandle;
+    /**
+     * 处理人员应用层事件
+     */
+    private _dealUserAppListener;
     /**
      * 获取房间 Id
      */
@@ -2573,7 +2694,7 @@ declare class RCAudienceLivingRoom {
     /**
      * 北极星上报实例
      */
-    protected _polarisReport: PolarisReporter | null;
+    protected _polarisReport: PolarisHttpReporter | null;
     /**
      * 音量上报实例
      */
@@ -2821,7 +2942,7 @@ declare class PolarisReporter {
      * @param resourceId userId_11_1_tiny 改为 userId_11_tiny_video
      */
     private _getPolarisTrackId;
-    sendR3R4Data(data: IInnerRCRTCStateReport): Promise<boolean>;
+    sendR3R4Data(data: IInnerRCRTCStateReport): Promise<RCSendCode>;
     /**
      * 加入房间
      */
@@ -2833,6 +2954,51 @@ declare class PolarisReporter {
     sendR2(action: string, status: string, trackIds: string[]): void;
 }
 
+declare class PolarisHttpReporter {
+    private readonly _context;
+    private readonly _runtime;
+    private readonly _roomId;
+    private readonly _crtRTCRoom;
+    private readonly _userRole;
+    protected _polarisSignalReporter: PolarisReporter | null;
+    private _useHttp;
+    static logServer: string | undefined;
+    static dc: string | undefined;
+    constructor(_context: RTCContext, _runtime: IRuntime, _roomId: string, _crtRTCRoom: RCAbstractRoom | RCAudienceLivingRoom, _userRole?: PolarisRole);
+    private _send;
+    private _refetchNaviInfo;
+    /**
+     * 小流需去掉 _tiny，小流 resourceId 为 userId_tag_mediaType_tiny
+     */
+    private _getRealResourceId;
+    /**
+     * 生成北极星上报的 trackId
+     * @param resourceId userId_11_1_tiny 改为 userId_11_tiny_video
+     */
+    private _getPolarisTrackId;
+    private _formatReportBaseData;
+    private _formatReportData;
+    private _formatR1Data;
+    private _formatR2Data;
+    private _formatR3R4Data;
+    sendR3R4Data(data: IInnerRCRTCStateReport): Promise<RCSendCode>;
+    /**
+     * 加入房间
+     */
+    sendR1(): Promise<void>;
+    /**
+     * RTC 和 LIVE 发布、取消发布
+     * RTC 订阅、取消订阅
+     */
+    sendR2(action: string, status: string, trackIds: string[]): Promise<void>;
+}
+
+declare enum RCEncoder {
+    VP8 = "VP8",
+    VP9 = "VP9",
+    H264 = "H264"
+}
+
 /**
  * PC 实例管理类
  */
@@ -2853,6 +3019,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * 北极星上传实例
      */
     private readonly _polarisReport?;
+    private readonly onTrackTrouble?;
     static __INNER_EVENT_TRACK_READY__: string;
     private readonly _rtcPeerConn;
     private readonly _sdpStrategy;
@@ -2862,6 +3029,9 @@ declare class RCRTCPeerConnection extends EventEmitter {
     private _reportStatsTimer;
     private _reportR3R4ToPolarisTimer;
     private _isDestroyed;
+    private _reportStatsData?;
+    private _originReportStatsData?;
+    private _logger;
     constructor(
     /**
      * peerConnection 对应名称
@@ -2878,10 +3048,12 @@ declare class RCRTCPeerConnection extends EventEmitter {
     /**
      * 北极星上传实例
      */
-    _polarisReport?: PolarisReporter | undefined);
+    _polarisReport?: PolarisHttpReporter | undefined, onTrackTrouble?: Function | undefined);
     getName(): string;
     getLocalTracks(): RCLocalTrack[];
     private _onConnectionStateChange;
+    private startAutoExecute;
+    private stopAutoExecute;
     private _onICEConnectionStateChange;
     private _onTrackReady;
     /**
@@ -2889,12 +3061,35 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @deprecated use RCLocalTrack.setBitrate instead of setBitrate
      */
     setBitrate(max: number, min: number, start?: number): Promise<void>;
+    /**
+     * `createOffer` 是一个创建报价并记录报价 SDP 和 SDP 语义的函数
+     * @param {boolean} iceRestart - 布尔值
+     * @returns 具有两个属性的对象：
+     *   - sdp：SDP 字符串
+     *   - 语义：SDP 语义
+     */
     createOffer(iceRestart: boolean): Promise<IOfferInfo>;
     setRemoteAnswer(answer: string): Promise<RCRTCCode>;
     getLocalTrack(trackId: string): RCLocalTrack | null;
+    /**
+     * 它将本地轨道添加到对等连接。
+     * @param {RCLocalTrack} track - 要添加的本地轨道。
+     */
     addLocalTrack(track: RCLocalTrack): void;
+    /**
+     * 按 ID 删除本地轨道
+     * @param {string} trackId - 要移除的轨道的 ID。
+     * @returns 正在删除的轨道。
+     */
     removeLocalTrackById(trackId: string): void;
+    /**
+     * 它会删除所有本地Track。
+     */
     removeAllLocalTrack(): void;
+    /**
+     * 从对等连接中删除本地轨道。
+     * @param {RCLocalTrack} track - 要删除的本地轨道。
+     */
     removeLocalTrack(track: RCLocalTrack): void;
     private _updateRecvTransceiverMap;
     updateSubRemoteTracks(remoteTracks: RCRemoteTrack[]): void;
@@ -2916,7 +3111,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @returns 返回格式化后的数据
      */
     private _getStatsData;
-    getAudioLevelReportData(): Promise<{
+    getAudioLevelReportData(gap?: number): Promise<{
         trackId: string;
         audioLevel: number | null;
     }[] | undefined>;
@@ -2925,6 +3120,10 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @todo
      */
     private _reportHandle;
+    /**
+     * 获取缓存的本地质量数据
+     */
+    _getCacheStatsData(): IInnerRCRTCStateReport | null | undefined;
     /**
      * 北极星上报 R3、R4 数据
      */
@@ -2934,9 +3133,47 @@ declare class RCRTCPeerConnection extends EventEmitter {
      */
     __reportR3R4ToPolaris(): Promise<void>;
     getRTCPeerConn(): RTCPeerConnection;
+    /**
+     * 它返回一个 RTCRtpCodecCapability 对象数组，第一个元素是与传入的编码器类型匹配的元素
+     * @param {RCEncoder} encoder - RCEncoder.H264
+     * @returns 正在返回 RTCRtpCodecCapability[] 数组。
+     */
+    private getCapabilitiesCodes;
+    /**
+     * 它为视频流设置编码器首选项。
+     * @param {RCEncoder} [encoder] - RC编码器
+     */
+    setEncoderPreferences(encoder?: RCEncoder): Promise<void>;
     destroy(): void;
     clearReTryExchangeTimer(): void;
     isDestroyed(): boolean;
+    /**
+     * 视频不可使用的收集器
+     */
+    private troubleTracksCollection;
+    private setTroubleTrack;
+}
+
+/**
+ * 通知拉取到的房间增量数据列表中每一项数据的动作
+ */
+declare enum PullRoomStatusEvent {
+    /**
+     * 人员加入
+     */
+    JOIN = 0,
+    /**
+     * 人员离开
+     */
+    LEAVE = 1,
+    /**
+     * 人员离线
+     */
+    OFFLINE = 2,
+    /**
+     * 资源变动
+     */
+    RESOURCECHANGE = 3
 }
 
 interface IRCTrackBitrate {
@@ -2974,10 +3211,8 @@ interface IResource {
     uri: string;
     /**
      * 资源特征，simulcast 代表这道流支持大小流
-     * @description 此参数存疑，MediaServer 似乎并未下发此字段，Web 端暂不启用
-     * @deprecated
      */
-    features?: ['simulcast'] | [];
+    simulcast: number;
 }
 /**
  * 向房间内发布的媒体数据
@@ -3238,6 +3473,228 @@ interface IRCRTCStateReport {
      */
     receivers: IRCTrackStat[];
 }
+/**
+ * http3 北极星上报基础数据
+*/
+interface IRCRTCReportBaseData {
+    /**
+     * 上报数据类型 R1-R4
+    */
+    type: string;
+    appKey: string;
+    /**
+     * 房间通话id
+    */
+    sessionId: string;
+    roomId: string;
+    /**
+     * 房间创建时间
+    */
+    roomCreateTime: number;
+    userId: string;
+    userRole: number;
+    joinTime: number;
+    /**
+     * signal 数据中心
+     * */
+    signalDataCenter: string;
+}
+/**
+ * http3 北极星上报 R1 数据
+*/
+interface IR1Info {
+    /**
+     * 用户加入房间的时间
+    */
+    joinTime: number;
+    /**
+     * RTC 版本号
+    */
+    rtcVersion: string;
+    /**
+     * IM SDK 版本
+    */
+    imVersion: string;
+    /**
+     * 平台(如：Android、iOS、Web)
+    */
+    platform: string;
+    /**
+     * 设备信息(手机名称+型号)
+    */
+    device: string;
+    /**
+     * 系统版本(手机系统版本)
+    */
+    os: string;
+    /**
+     * 浏览器名称, 没有用 -1 表示
+    */
+    browserName?: string;
+    /**
+     * 浏览器版本, 没有用 -1 表示
+    */
+    browserVersion?: string;
+    /**
+     * 发送数据的时间
+    */
+    receiveTime?: number;
+}
+/**
+ * http3 北极星上报 R2 数据
+*/
+interface IR2Info {
+    /**
+     * 用户加入房间的时间
+    */
+    joinTime: number;
+    /**
+     * 客户端 发布/取消发布 订阅/取消订阅 资源的时间
+    */
+    sendTime: number;
+    /**
+     * 发布类型  subscribe : 订阅   publish : 发布
+    */
+    rtcActionType: string;
+    /**
+     * 发布状态  begin : 开始   tend : 结束
+    */
+    rtcActionStatus: string;
+    trackId: string[];
+    /**
+     * 发送数据的时间
+    */
+    receiveTime?: number;
+}
+/**
+ * http3 北极星上报 R3 数据
+*/
+interface IR3R4Info {
+    info: IR3R4CommonInfo;
+}
+interface IR3R4CommonInfo {
+    /**
+     * 用户加入房间的时间
+    */
+    joinTime?: number;
+    /**
+     * 用户发布数据流的时间（毫秒），暂时由客户端生成，后期如果有问题服务端做兜底处理
+    */
+    receiveTime?: number;
+    /**
+     * 总码率
+    */
+    totalBitRate?: number;
+    /**
+     * APP CPU占用率
+    */
+    appCPUUsage?: number;
+    /**
+     * 系统 CPU占用率
+    */
+    systemCPUUsage?: number;
+    /**
+     * 系统CPU频率 (安卓8.0以上)
+    */
+    systemCPUFrequency?: number;
+    /**
+     * 实时网络状态(2g、3g、4g、wifi)
+    */
+    networkStatus?: string;
+    /**
+     * Goog rtt 网络延迟
+    */
+    googleRTTNetwork?: number;
+    /**
+     * ip地址
+    */
+    ipAddress?: string;
+    /**
+     * 可接收带宽(单位: bit)
+    */
+    useReceiveBroadBand?: string;
+    /**
+     * 可用发送带宽(单位: bit)
+    */
+    useSendBroadBand?: string;
+    /**
+     * 丢包数
+    */
+    packetLossCount?: string;
+    streams?: IR3R4StreamInfo[];
+}
+/**
+ * http3 北极星上报 R3、R4 streamInfo 数据
+*/
+interface IR3R4StreamInfo {
+    trackId: string;
+    /**
+     * 编解码名称
+    */
+    codeName?: string;
+    /**
+     * 音频播放音量
+    */
+    volume?: string;
+    /**
+     * 音频采样率
+    */
+    samplingRate: number;
+    /**
+     * 下行码率
+    */
+    bitRate?: number;
+    packetLossRate?: number;
+    /**
+     * 视频接收帧率(单位:fps)
+    */
+    frameRate?: number;
+    /**
+     * 视频分辨率(格式:640*480)
+    */
+    resolution?: string;
+    /**
+     * 接收卡顿(间隔时间, 单位: ms)
+    */
+    blockTime?: number;
+    /**
+     * jitter数据抖动
+    */
+    jitterData?: number;
+    /**
+     * nack数量
+    */
+    nAckCount?: string;
+    /**
+     * PLI请求数
+    */
+    pliCount?: string;
+    /**
+     * googRtt往返时长
+    */
+    googleRTTTotalTime?: number;
+    /**
+     * 第一个关键帧是否正常收到
+    */
+    isReceiveFirstFrameRate?: number;
+    /**
+     * 编码方式
+    */
+    codeType?: string;
+    /**
+     * 当前流的状态是否可用
+    */
+    isEnabled?: number;
+}
+/**
+ * http3 北极星上报总数据
+*/
+interface IRCRTCReportData extends IRCRTCReportBaseData {
+    r1Info?: IR1Info;
+    r2Info?: IR2Info;
+    r3Info?: IR3R4Info;
+    r4Info?: IR3R4Info;
+}
 interface IRCRTCReportListener {
     /**
      * RTCPeerConnection 的详细状态数据
@@ -3341,6 +3798,11 @@ interface IRoomEventListener extends IRCRTCTrackEventListener {
      * @param failedList 订阅失败的列表
      */
     onTaskCompleted?(code: RCRTCCode, subscribe: ISubscribeAttr[], unsubscribe: ISubscribeAttr[], failedList: ISubscribeAttr[]): void;
+    /**
+     * 当房间内资源（音频视频）异常时给出处理
+     *
+     */
+    onTrackTrouble?(tracks: RCLocalTrack[]): void;
 }
 /**
  * RTCClient 初始化配置
@@ -3357,16 +3819,16 @@ interface IRCRTCInitOptions {
     /**
      * 输出日志等级，生产环境默认使用 WARN，开发环境默认为 DEBUG
      * @description
-     * * 0 - DEBUG
-     * * 1 - INFO
+     * * 4 - DEBUG
+     * * 3 - INFO
      * * 2 - WARN
-     * * 3 - ERROR
+     * * 1 - ERROR
      */
-    logLevel?: LogLevel;
+    logLevel?: EnableLogL;
     /**
      * 修改默认的 log 输出函数
      */
-    logStdout?: (logLevel: LogLevel, content: string) => void;
+    logStdout?: (logLevel: EnableLogL, content: string) => void;
     /**
      * 与 MediaServer 的 http 请求超时时间，单位为毫秒，默认值为 `5000`，有效值 `5000-30000`。
      * 优先级：用户配置 > 导航配置 > 默认时间。
@@ -3547,6 +4009,79 @@ interface IChrmKVPullData {
     isFullUpdate?: boolean;
     syncTime?: number;
 }
+/**
+ * 通知拉取到的房间数据
+ */
+interface IPullRTCRoomStatus {
+    /**
+     * 是否是全量数据
+     */
+    bFullStatus: boolean;
+    /**
+     * 当前房间的最大版本号
+     */
+    version: number;
+    /**
+     * 如果是全量数据，usersData 不为空,给的是房间全部的人以及发布的资源
+     */
+    usersData: IPullRTCRoomUsersData[];
+    /**
+     * 房间增量数据
+     */
+    roomStatus: IRoomStatus[];
+}
+/**
+ * 通知拉取到的房间增量数据
+ */
+interface IRoomStatus {
+    /**
+     * 用户 id
+     */
+    userId: string;
+    /**
+     * 本次变更的动作类型
+     */
+    event: PullRoomStatusEvent;
+    /**
+     * 本次变更的版本号
+     */
+    time: number;
+    /**
+     * 用户变更的资源，event 为人员加入或资源变动时有值
+     * key 包含 uris、cdn_uris、mcu_uris
+     * value 为字符串数组
+     */
+    userData: {
+        key: string;
+        value: string;
+    }[];
+    /**
+     * 切换角色，0 代表非切换身份发生的加入、退出房间行为
+     */
+    switchRoleType: RCRTCLiveRole | 0;
+    /**
+     * 额外的信息
+     */
+    extra: string;
+}
+/**
+ * 通知拉取到的房间全量数据
+ */
+interface IPullRTCRoomUsersData {
+    /**
+     * 用户 id
+     */
+    userId: string;
+    /**
+     * 房间内所有资源数据
+     * key 包含 uris、cdn_uris、mcu_uris
+     * value 为字符串数组
+     */
+    userData: {
+        key: string;
+        value: string;
+    }[];
+}
 
 /**
  * 自定义合流布局时，背景图片填充方式
@@ -3775,6 +4310,19 @@ declare class RCLivingRoom extends RCAbstractRoom {
      * 跨房间连麦管理器
      */
     private _roomPKHandler;
+    /**
+     * 一个构造函数。
+     * @param {RTCContext} context - RTC上下文，
+     * @param {IRuntime} runtime - 运行时
+     * @param {string} roomId - 房间号
+     * @param {RCMediaService} service - RCMediaService
+     * @param {IRCRTCInitOptions} initOptions - IRCRTCInitOptions
+     * @param {RCLivingType} _livingType - RCLivingType.LIVE_ROOM,
+     * @param {boolean} [isUpgrade] - 是否升级房间，如果为真，则表示房间从会议室升级到直播间，会议室关闭。
+     * @param {boolean} [isMainRoom] - 无论是主房间，主房间都是发起呼叫的房间，子房间是接收呼叫的房间。
+     * @param {boolean} [useMutilPeerC] - 是否使用多个 peerConnections
+     * @param {string} [_clientSessionId] - 当前用户的会话 ID。
+     */
     constructor(context: RTCContext, runtime: IRuntime, roomId: string, service: RCMediaService, initOptions: IRCRTCInitOptions, _livingType: RCLivingType, isUpgrade?: boolean, isMainRoom?: boolean, 
     /**
      * 是否使用多 peerConnection
@@ -3784,11 +4332,11 @@ declare class RCLivingRoom extends RCAbstractRoom {
     /**
      * @override
      */
-    __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): Promise<{
+    __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData, traceId?: string): Promise<{
         code: RCRTCCode | ErrorCode;
         data?: IJoinRTCRoomData;
     }>;
-    __innerInitByIdentityChange(): Promise<ErrorCode>;
+    __innerInitByIdentityChange(traceId: string): Promise<ErrorCode>;
     /**
      * 增量发布资源，若发布的资源 tag 及媒体类型重复，后者将覆盖前者进行发布。
      * @param tracks 待发布的 RCLocalTrack 实例
@@ -3820,11 +4368,11 @@ declare class RCLivingRoom extends RCAbstractRoom {
      */
     protected _resourceHandle(content: ResourceMsgContent & {
         cdn_uris?: ICDNUris[];
-    }, messageType: RCRTCMessageType.PUBLISH | RCRTCMessageType.UNPUBLISH | RCRTCMessageType.MODIFY | RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId: string): Promise<void>;
+    }, messageType: RCRTCMessageType.PUBLISH | RCRTCMessageType.UNPUBLISH | RCRTCMessageType.MODIFY | RCRTCMessageType.TOTAL_CONTENT_RESOURCE, userId: string, traceId: string): Promise<void>;
     /**
      * 观众切换为主播后直接处理人员变更及资源变更
      */
-    protected _afterChangedRole(data: IJoinRTCRoomData): void;
+    protected _afterChangedRole(data: IJoinRTCRoomData, traceId: string): void;
     /**
      * 返回 CDN 是否可用
      * @returns boolean
@@ -3865,11 +4413,25 @@ declare class RCLivingRoom extends RCAbstractRoom {
  * 普通音视频房间
  */
 declare class RCRTCRoom extends RCAbstractRoom {
+    /**
+     * 类的构造函数。
+     * @param {RTCContext} context - RTC上下文
+     * @param {IRuntime} runtime - 运行时
+     * @param {string} roomId - 房间号
+     * @param {RCMediaService} service - RCMediaService
+     * @param {IRCRTCInitOptions} initOptions - IRCRTCInitOptions
+     * @param {boolean} [isUpgrade] - 是否升级房间，默认为false
+     * @param {boolean} [isMainRoom] - 无论是主房间，主房间是用户进入的房间，子房间是用户进入主房间后进入的房间。
+     * @param {boolean} [useMutilPeerC] - 是否使用多个 peerConnections
+     * @param {string} [_clientSessionId] - 当前房间的clientSessionId，用于区分当前房间和其他房间。
+     * @param {RTCMode} roomType - RTCMode = RTCMode.RTC,
+     * @param {number} signalRetryTime - 重新连接信令服务器的时间间隔。
+     */
     constructor(context: RTCContext, runtime: IRuntime, roomId: string, service: RCMediaService, initOptions: IRCRTCInitOptions, isUpgrade?: boolean, isMainRoom?: boolean, 
     /**
      * 是否使用多 peerConnection
      */
-    useMutilPeerC?: boolean, _clientSessionId?: string, roomType?: RTCMode);
+    useMutilPeerC?: boolean, _clientSessionId?: string, roomType?: RTCMode, signalRetryTime?: number);
 }
 
 /**
@@ -3960,6 +4522,7 @@ declare class RCMediaStreamCapture {
     constructor(_context: RTCContext);
     private _isElectron;
     private _getMediaStream;
+    private _getMediaStreamErrorReason;
     /**
      * 如果用户设置了音频约束为true，那么我们将音频约束设置为一个空对象，
      * 然后我们将检查浏览器是否支持noiseSuppression、autoGainControl和echoCancellation约束，
@@ -4082,7 +4645,7 @@ declare class RCMediaStreamCapture {
 declare class RCRTCClient extends RCMediaStreamCapture {
     protected readonly _context: RTCContext;
     private readonly _runtime;
-    private readonly _options;
+    private _options;
     private readonly _service;
     constructor(_context: RTCContext, _runtime: IRuntime, _options: IRCRTCInitOptions);
     private _handleMessage;
@@ -4101,14 +4664,15 @@ declare class RCRTCClient extends RCMediaStreamCapture {
     getCurrentId(): string;
     private _crtRoom;
     /**
-     * 加入普通音视频房间
-     * @param roomId
-     * @param joinType 多端处理方式
-     * @param outerUserDatas 业务层设置人员属性
-     * @param useMutilPeerC 是否使用多 peerConnection 发布资源
-     * @param roomType 加入房间的类型 默认参数 RTCMode.RTC
+     * > 加入普通音视频房间，返回房间对象、code、userIds、tracks
+     * @param {string} roomId - 房间号
+     * @param {RTCJoinType} [joinType] - 要加入的房间类型。
+     * @param {IRTCUserData} [outerUserDatas] - 加入房间的用户的用户数据。
+     * @param {boolean} [useMutilPeerC] - 是否使用多点连接，默认为false，即使用单点连接。
+     * @param {RTCMode} roomType - RTCMode = RTCMode.RTC,
+     * @param {number} signalRetryTime - 重新连接信令服务器的时间间隔。
      */
-    joinRTCRoom(roomId: string, joinType?: RTCJoinType, outerUserDatas?: IRTCUserData, useMutilPeerC?: boolean, roomType?: RTCMode): Promise<{
+    joinRTCRoom(roomId: string, joinType?: RTCJoinType, outerUserDatas?: IRTCUserData, useMutilPeerC?: boolean, roomType?: RTCMode, signalRetryTime?: number): Promise<{
         room?: RCRTCRoom;
         code: RCRTCCode;
         userIds?: string[];
@@ -4148,7 +4712,13 @@ declare class RCRTCClient extends RCMediaStreamCapture {
      */
     getAudienceClient(useMutilPeerC?: boolean): RCAudienceClient;
     private _onIMStatusChange;
+    /**
+     * 用户主动断开 IM 连接
+     */
     private _onIMDisconnect;
+    /**
+     * 用户销毁 IM 客户端，IM 客户端需重新初始化
+     */
     private _onIMUninit;
     /**
      * 退出并销毁当前房间实例，退出后该房间的所有方法将不可用
@@ -4206,6 +4776,7 @@ declare class RCRTCClient extends RCMediaStreamCapture {
         code: RCRTCCode | ErrorCode;
         data?: IRTCJoinedInfo[];
     }>;
+    reportSDKInfo(): void;
 }
 
 /**