@rongcloud/plugin-rtc 5.5.4 → 5.5.5-beem-alpha.2

package/dist/index.d.ts

@@ -1,11 +1,10 @@
 /*
- * RCRTC - v5.5.4
- * CommitId - 80b0c1d49cb6cbe32c4b66a016063568d6893014
- * Sun Oct 09 2022 17:26:05 GMT+0800 (China Standard Time)
+ * RCRTC - v5.5.5-beem-alpha.2
+ * CommitId - 53292a559174278ff032c3811be232015e47f007
+ * Fri Oct 14 2022 11:08:06 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,7 @@ declare abstract class RCTrack extends EventEmitter {
     protected readonly _streamId: string;
     protected _msTrack?: MediaStreamTrack;
     private _msStream;
+    protected _logger: BasicLogger | null;
     constructor(_tag: string, _userId: string, _kind: 'audio' | 'video', _isLocalTrack: boolean, _roomId?: string | undefined);
     /**
      * 获取音视轨所属的 streamId，streamId 相同的音轨和视轨可认为属于统一道流
@@ -538,11 +540,11 @@ declare enum RCRTCPingResult {
  */
 declare enum RCRTCLiveRole {
     /**
-     * 主播
+     * 主播降级
      */
     ANCHOR = 1,
     /**
-     * 观众
+     * 观众升级
      */
     AUDIENCE = 2
 }
@@ -646,7 +648,19 @@ declare enum RTCMode {
     /**
     * 跨应用直播
     */
-    CROSS_LIVE = 8
+    CROSS_LIVE = 8,
+    /**
+     * sip呼叫
+     */
+    SIP = 4,
+    /**
+     * 呼叫模式.包括单呼和群呼
+     */
+    CALL = 5,
+    /**
+     * 会议
+     */
+    MEETING = 6
 }
 
 /**
@@ -1241,8 +1255,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 +1281,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 +1356,10 @@ interface IJoinRTCRoomData extends IRTCUsers {
     }[];
     kvEntries: IServerRTCRoomEntry[];
     offlineKickTime: number;
+    codeFormat?: string;
+    roomCreateTime?: number;
+    userJoinTime?: number;
+    version: number;
 }
 interface IReqRoomPKOptions {
     /**
@@ -1436,11 +1465,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 +1532,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 +1549,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: any;
+        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 +1592,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 +1638,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, 
     /**
@@ -1672,6 +1764,7 @@ declare class RCRTCPeerCManager {
      * 存储创建的所有 peerC，key 为 pcName，/exchange 请求中 request header 中的 Peer-Connection-Id 值
      */
     private _mutilPeerC;
+    onTrackTrouble?: Function;
     constructor(
     /**
      * 是否使用多 peerConnection
@@ -1692,7 +1785,7 @@ declare class RCRTCPeerCManager {
     /**
      * 北极星上报模块
      */
-    _polarisReport?: PolarisReporter | undefined);
+    _polarisReport?: PolarisHttpReporter | undefined);
     get useMutilPeerC(): boolean;
     /**
      * 根据 track 判断是否为上行
@@ -1812,7 +1905,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 +1937,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,6 +1958,7 @@ declare abstract class ReadableStore {
     getTrackState(trackId: string): 0 | 1;
     getCDNEnable(): boolean;
     getCDNUris(): ICDNUris | null;
+    getRoomStatusVersion(): number;
 }
 declare class Store extends ReadableStore {
     private _initRemoteTracks;
@@ -1878,6 +1973,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 +2040,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 定义中修改内存
      */
@@ -2149,7 +2245,7 @@ declare abstract class RCAbstractRoom extends EventEmitter {
     /**
      * 北极星上报实例
      */
-    protected _polarisReport: PolarisReporter | null;
+    protected _polarisReport: PolarisHttpReporter | null;
     /**
      * 音量上报实例
      */
@@ -2165,6 +2261,11 @@ declare abstract class RCAbstractRoom extends EventEmitter {
      * 是否使用多 peerConnection
      */
     _useMutilPeerC?: boolean | undefined, _clientSessionId?: string);
+    /**
+     * 拉取房间数据
+     * @param roomId 房间 id
+     */
+    private _startPullRTCRoomStatus;
     __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData): Promise<{
         code: RCRTCCode | ErrorCode;
         data?: IJoinRTCRoomData;
@@ -2573,7 +2674,7 @@ declare class RCAudienceLivingRoom {
     /**
      * 北极星上报实例
      */
-    protected _polarisReport: PolarisReporter | null;
+    protected _polarisReport: PolarisHttpReporter | null;
     /**
      * 音量上报实例
      */
@@ -2821,7 +2922,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 +2934,49 @@ 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;
+    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 +2997,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 +3007,9 @@ declare class RCRTCPeerConnection extends EventEmitter {
     private _reportStatsTimer;
     private _reportR3R4ToPolarisTimer;
     private _isDestroyed;
+    private _reportStatsData?;
+    private _originReportStatsData?;
+    private _logger;
     constructor(
     /**
      * peerConnection 对应名称
@@ -2878,10 +3026,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;
     /**
@@ -2916,7 +3066,7 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @returns 返回格式化后的数据
      */
     private _getStatsData;
-    getAudioLevelReportData(): Promise<{
+    getAudioLevelReportData(gap?: number): Promise<{
         trackId: string;
         audioLevel: number | null;
     }[] | undefined>;
@@ -2925,6 +3075,10 @@ declare class RCRTCPeerConnection extends EventEmitter {
      * @todo
      */
     private _reportHandle;
+    /**
+     * 获取缓存的本地质量数据
+     */
+    _getCacheStatsData(): IInnerRCRTCStateReport | null | undefined;
     /**
      * 北极星上报 R3、R4 数据
      */
@@ -2934,9 +3088,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 +3166,8 @@ interface IResource {
     uri: string;
     /**
      * 资源特征，simulcast 代表这道流支持大小流
-     * @description 此参数存疑，MediaServer 似乎并未下发此字段，Web 端暂不启用
-     * @deprecated
      */
-    features?: ['simulcast'] | [];
+    simulcast: number;
 }
 /**
  * 向房间内发布的媒体数据
@@ -3238,6 +3428,220 @@ 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;
+}
+/**
+ * http3 北极星上报 R2 数据
+*/
+interface IR2Info {
+    /**
+     * 用户加入房间的时间
+    */
+    joinTime: number;
+    /**
+     * 客户端 发布/取消发布 订阅/取消订阅 资源的时间
+    */
+    sendTime: number;
+    /**
+     * 发布类型  subscribe : 订阅   publish : 发布
+    */
+    rtcActionType: string;
+    /**
+     * 发布状态  begin : 开始   tend : 结束
+    */
+    rtcActionStatus: string;
+    trackId: string[];
+}
+/**
+ * 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 +3745,11 @@ interface IRoomEventListener extends IRCRTCTrackEventListener {
      * @param failedList 订阅失败的列表
      */
     onTaskCompleted?(code: RCRTCCode, subscribe: ISubscribeAttr[], unsubscribe: ISubscribeAttr[], failedList: ISubscribeAttr[]): void;
+    /**
+     * 当房间内资源（音频视频）异常时给出处理
+     *
+     */
+    onTrackTrouble?(tracks: RCLocalTrack[]): void;
 }
 /**
  * RTCClient 初始化配置
@@ -3357,16 +3766,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`。
      * 优先级：用户配置 > 导航配置 > 默认时间。
@@ -3388,6 +3797,7 @@ interface IRCRTCInitOptions {
      * 观众拉内置 CDN 资源时是否使用 https，默认为 RCInnerCDNPullIsHttps.HTTPS
      */
     pullInnerCDNUseHttps?: RCInnerCDNPullIsHttps;
+    signalRetryTime?: number;
     /**
      * 音频降噪处理
      * - workletModule 默认值为 https://cdn.ronghub.com/plugin-rtc/wasm/5.0.0-alpha.1/process-worklet.js
@@ -3547,6 +3957,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;
+    }[];
+}
 
 /**
  * 自定义合流布局时，背景图片填充方式
@@ -4082,7 +4565,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 +4584,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[];
@@ -4206,6 +4690,7 @@ declare class RCRTCClient extends RCMediaStreamCapture {
         code: RCRTCCode | ErrorCode;
         data?: IRTCJoinedInfo[];
     }>;
+    reportSDKInfo(): void;
 }
 
 /**