quickvo-sdk-js 1.6.71 → 1.6.73

package/dist/src/action/ActionSFU.d.ts

@@ -9,6 +9,8 @@ export declare class ActionSFU {
     private _networkCalculating;
     /** 上次打印 generateTrackAnalysis 超时告警的时间，用于限流（每 30 秒最多一次） */
     private _lastTrackAnalysisWarnTime;
+    /** `genTurnAddress.expiresAt` 到期前 1 分钟：`_fetchGenTurnAddress` + `peer.setTurnConfiguration`（不 init PC） */
+    private _turnRefreshTimerId?;
     /** 避免 Math.max(...arr) 在极大数组上触达引擎参数长度限制 */
     private static _maxInNumberArray;
     private static _minInNumberArray;
@@ -22,10 +24,7 @@ export declare class ActionSFU {
     private _syncRoomInfoTask;
     private _restorePeerTask;
     private _quitRoomTask;
-    /** 串行化 joinRoom，避免并发进房互相覆盖 config / 用户列表 / 连接状态 */
-    private _joinRoomSerial;
-    /** 合并同一宏任务内多次 _autoCheckSubscribe 触发 */
-    private _autoCheckSubscribeCoalesce;
+    private _lastUpdateNetworkTime;
     constructor({ base }: {
         base: Base;
     });
@@ -76,14 +75,14 @@ export declare class ActionSFU {
      * @param usersMediaTypes: UserMediaTypes[] = [] 不传入订阅所有
      * @example quickvo.subscribe([{ userId: '123', mediaTypes: ['mc_audio', 'mc_video'] }])
      */
-    subscribe: (usersMediaTypes?: UserMediaTypes[]) => Promise<true>;
+    subscribe: (usersMediaTypes?: UserMediaTypes[]) => Promise<true | undefined>;
     /**
      * stopSubscribe
      * @param usersMediaTypes: UserMediaTypes[] = [] 不传入取消订阅所有
      * @example quickvo.stopSubscribe([{ userId: '123', mediaTypes: ['mc_audio', 'mc_video'] }])
      * @returns Promise<boolean>
      */
-    stopSubscribe: (usersMediaTypes?: UserMediaTypes[]) => Promise<true>;
+    stopSubscribe: (usersMediaTypes?: UserMediaTypes[]) => Promise<true | undefined>;
     /**
      * quitRoom
      * @example quickvo.quitRoom()
@@ -103,7 +102,7 @@ export declare class ActionSFU {
     setBehaviors: (usersBehaviors: Array<{
         id: string;
         behaviors: { [key in K_mediaType]?: boolean; };
-    }>) => Promise<import('../protos/protoEvent').MessageRspCore<"preventUsersBehavior">>;
+    }>) => Promise<import('../protos/protoEvent').MessageRsp<"preventUsersBehavior">>;
     /**
      * toggleRoomSpeechLang
      * @param data { input: string; output: string; translateEnable?: boolean }
@@ -126,35 +125,21 @@ export declare class ActionSFU {
      * destroy
      */
     destroy: () => Promise<void>;
-    private _scheduleAutoCheckSubscribe;
-    private _waitPeerThenSubscribeTask;
     private _clearTask;
     private _clear;
     private _connectCws;
-    /** joinRoom 专用：已 OPEN 则跳过；否则最多 3 次建连，单次超时 10s，均失败则 throw */
-    private static _JOIN_ROOM_WS_ATTEMPTS;
-    private static _JOIN_ROOM_WS_TIMEOUT_MS;
-    private _ensureWebSocketBeforeJoinRoom;
-    /**
-     * SFU Peer 建连：最多 3 次 `_connectCF`；单次信令（genTurnAddress / publish）超时 10s；ICE 等待 10s（见 `_connectCF` 内 `peerConnected`）。
-     * 用于进房与 disconnected→closed 后的 `_restorePeer`。
-     */
-    private static _RTC_RECOVERY_ATTEMPTS;
-    private static _RTC_RECOVERY_CWS_TIMEOUT_MS;
-    private _connectCFWithRecoveryRetries;
-    private _ensureWebRtcForJoinRoom;
     private _initHeartbeat;
     /** 向服务端拉取 TURN/STUN 配置；失败或未返回有效 iceServers 时返回 undefined，由 Peer 回退默认 STUN */
     private _fetchGenTurnAddress;
+    private _refreshTurnViaSetConfiguration;
     private _connectCF;
     private _reportNetwork;
     private _createTracks;
     private _closeTrack;
     private _pubNotify;
+    private _submitRtcStats;
     private _renegotiate;
     private _ackMsg;
-    private _acquireJoinRoomSerial;
-    private _joinRoomExecute;
     private _autoCheckSubscribe;
     private _onRemoteUsersQuitRoom;
     private _notifySelfCallAction;
@@ -163,5 +148,9 @@ export declare class ActionSFU {
     private _hasAsyncTask;
     private _syncRoomInfo;
     private _restorePeer;
+    private _pubChannel;
+    private _closeChannel;
+    private _checkAndSubChannel;
+    private _emitSelfNetworkQualityChange;
     _restoreRoom: () => Promise<void>;
 }

package/dist/src/action/Task.d.ts

@@ -1,40 +1,16 @@
-export type TaskExeOptions = {
-    /**
-     * 默认 true：防抖结束后执行 fn，用其返回值 resolve，异常则 reject。
-     * false：仅调用 fn，由 fn 内部通过 task.resolve / task.reject 结束（如订阅队列回调）。
-     */
-    settle?: boolean;
-};
-/**
- * 异步任务与防抖：constructor(debounceMs) 防抖毫秒数，默认 0。
- * 多次 exe 会重置防抖；若需放弃上一轮可先判断 state === 'waiting' 再 clear()。
- */
 export declare class Task<R = true> {
     private readonly debounceMs;
     private timer?;
-    /** 每次调度 / 清理 / 手动 settle 递增，用于丢弃过期的 setTimeout / microtask */
-    private scheduleGen;
     state: 'ready' | 'waiting';
     promise?: Promise<R>;
     private _resolve?;
     private _reject?;
     private pendingFn?;
-    private pendingSettle;
     constructor(debounceMs?: number);
-    /** 从 ready 进入 waiting 并创建 promise（不启动防抖）；用于 debounce 前仍需 await 其它逻辑的场景 */
-    begin(): Promise<R>;
-    /**
-     * 注册待执行函数：在防抖时间结束后执行。
-     * 若当前为 ready，会先 begin；若已在 waiting，会复用同一 promise 并重置防抖（尾触发）。
-     */
-    exe(fn: () => unknown | Promise<unknown>, options?: TaskExeOptions): Promise<R>;
-    /**
-     * 典型用于 publish：先 begin 占位，再 await prepare（如补本地流），最后对 fn 做防抖调度。
-     */
-    beginPrepareThenExe(prepare: () => void | Promise<void>, fn: () => unknown | Promise<unknown>): Promise<R>;
+    begin: () => void;
+    exe: (fn: () => unknown | Promise<unknown>) => Promise<R>;
     private _runFlush;
-    resolve: (value: R) => void;
+    resolve: (value: any) => void;
     reject: (error: unknown) => void;
-    /** SDK 内部清理：取消待执行的防抖，并以 resolve 结束，避免对外 Promise rejection */
     clear: () => void;
 }

package/dist/src/base/Base.d.ts

@@ -57,7 +57,7 @@ export declare class Base {
         mediaTypes: K_mediaType[];
         desc?: string;
         connectedTime?: string;
-    }) => Promise<import('../protos/protoEvent').MessageRspCore<"reportP2PConnectEx">> | undefined;
+    }) => Promise<import('../protos/protoEvent').MessageRsp<"reportP2PConnectEx">> | undefined;
     _reportLog: (_type: Report_Log_Type, describe?: string) => void;
 }
 export {};

package/dist/src/base/modules/Notifys.d.ts

@@ -1,12 +1,21 @@
-import { K_quickvoNotifyName, NotifyPayloadMap, QuickvoNotify } from './notifyPayloadMap';
-export type { K_quickvoNotifyName, NotifyPayloadMap, QuickvoNotify, NotifyEmitPayloadFor, NotifyEmitPayloadUnion } from './notifyPayloadMap';
-export { defineQuickvoNotify } from './notifyPayloadMap';
+import { K_notifyName as _K_notifyName } from '../../enums';
+type K_notifyName = _K_notifyName | 'onRoomState' | 'onPeerState' | 'onLog' | 'onDevicechange' | 'onRoomUsers' | 'onRoomNetwork';
+export interface MessageNotifys {
+    code: number;
+    desc: string;
+    data: any;
+}
+interface QuickvoNotify {
+    event: K_notifyName;
+    callback: Function;
+    sn?: string;
+}
 export declare class Notifys {
-    queue: Map<K_quickvoNotifyName, QuickvoNotify[]>;
+    queue: Map<K_notifyName, QuickvoNotify[]>;
     /**
      * 派发广播事件（第二参类型随 event 变化）
      */
-    emit: <E extends K_quickvoNotifyName>(event: E, result: NotifyPayloadMap[E]) => void;
+    emit: <E extends K_notifyName>(event: E, result: MessageNotifys) => void;
     /**
      * 添加广播
      * @param notify
@@ -14,3 +23,4 @@ export declare class Notifys {
      */
     add: (notify: QuickvoNotify) => string;
 }
+export {};

package/dist/src/base/modules/Peer.d.ts

@@ -1,5 +1,5 @@
 import { K_mediaType } from '../../enums/mediaType';
-import { TurnUrlsResponse } from '../../protos/gen/modules/Room_pb';
+import { TurnUrlsResponse } from '../../protos/gen/Room_pb';
 import { Config } from './Config';
 import { Users } from './users/Users';
 import { PrResolves } from './PrResolves';
@@ -23,6 +23,8 @@ export declare class Peer {
     simulcast: 'f' | 'h' | 'q';
     /** 当前 SFU 连接使用的 TURN 配置过期时间（毫秒，来自 genTurnAddress.expiresAt） */
     turnExpiresAtMs?: number;
+    channels: Map<string, RTCDataChannel>;
+    _channelDebug: boolean;
     on: On;
     waitings: {
         peerConnected: () => Promise<unknown>;
@@ -42,6 +44,20 @@ export declare class Peer {
      */
     setRTCRtpSenderParameters: (parameters: Partial<RTCRtpSendParameters>, mediaTypes?: K_mediaType[]) => Promise<void>;
     init: (turnRsp?: TurnUrlsResponse) => Promise<void>;
+    /**
+     * TURN 凭证将过期时：不销毁 PC，仅 `setConfiguration` 更新 ICE（与 init 同源），并尽量 `restartIce` 以用新 relay。
+     */
+    setTurnConfiguration: (turnRsp?: TurnUrlsResponse) => void;
+    localChannelSend: (data: any) => Promise<void>;
+    addLocalUserChannel: (id?: number) => void;
+    addRemoteUserChannel: (userId: string, id?: number) => void;
+    clearChannels: (ids?: string[]) => {
+        userId: string;
+        channels: {
+            id?: number;
+            dataChannelName: string;
+        }[];
+    }[];
     close: () => void;
     addSenders: (mediaTypes: K_mediaType[]) => Promise<("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[]>;
     syncSenderStreamTrack: (mediaTypes: K_mediaType[]) => Promise<void>;

package/dist/src/base/modules/cws/CallsWebSocket.d.ts

@@ -1,35 +1,47 @@
 import { K_eventName } from '../../../enums/eventName';
-import { CallsWebSocketOn } from '../../../protos/protoEvent';
 import { Options, CallsWebSocketEvent } from './CallsWebSocketEvent';
 import { Config } from '../Config';
 import { PrWebSocket } from './PrWebSocket';
-export type { CallsWebSocketOn };
-/**
- * 从 IndexedDB 读取 `#quickvo.logs` 并触发浏览器下载 JSON 文件（控制台可执行 `getQVLogs()`）。
- */
-export declare function getQVLogs(): Promise<void>;
-export interface CallsWebSocketOptions {
-    /**
-     * websocket服务地址
-     */
-    url?: string;
-    /**
-     * 超时时间
-     */
-    timeout?: number;
-    /**
-     * 开启后会在控制台显示相关操作日志 默认为false
-     */
-    debug?: boolean;
-}
+import { WorkerProtos } from '../../../workers/protos';
+import { MessageNotifys } from '../../../protos/protoEvent';
 type EventsItems = Map<number, CallsWebSocketEvent<any>>;
 type Events = Map<K_eventName, EventsItems>;
+interface On {
+    state?: (state: 'connecting' | 'connected' | 'reconnecting' | 'closed') => void;
+    log?: (e: unknown) => void;
+    onJoinRoom?: (e: MessageNotifys<'onJoinRoom'>) => void;
+    onJoinRoomBatch?: (e: MessageNotifys<'onJoinRoomBatch'>) => void;
+    onQuitRoom?: (e: MessageNotifys<'onQuitRoom'>) => void;
+    onQuitRoomBatch?: (e: MessageNotifys<'onQuitRoomBatch'>) => void;
+    onPublish?: (e: MessageNotifys<'onPublish'>) => void;
+    onDataChannelPublish?: (e: MessageNotifys<'onDataChannelPublish'>) => void;
+    onCloseTrack?: (e: MessageNotifys<'onCloseTrack'>) => void;
+    onTrackInactive?: (e: MessageNotifys<'onTrackInactive'>) => void;
+    onUpdatePermissions?: (e: MessageNotifys<'onUpdatePermissions'>) => void;
+    onUpdatePermissionsBatch?: (e: MessageNotifys<'onUpdatePermissionsBatch'>) => void;
+    onUpdateBehavior?: (e: MessageNotifys<'onUpdateBehavior'>) => void;
+    onRoomActionChange?: (e: MessageNotifys<'onRoomActionChange'>) => void;
+    onMeetSpecialRolesChange?: (e: MessageNotifys<'onMeetSpecialRolesChange'>) => void;
+    onUpdateCall?: (e: MessageNotifys<'onUpdateCall'>) => void;
+    onRoomUserSpeech?: (e: MessageNotifys<'onRoomUserSpeech'>) => void;
+    onBeforeTokenExpire?: (e: MessageNotifys<'onBeforeTokenExpire'>) => void;
+    onTokenExpired?: (e: MessageNotifys<'onTokenExpired'>) => void;
+    onCDNPlayUrlAdd?: (e: MessageNotifys<'onCDNPlayUrlAdd'>) => void;
+    onNetQuality?: (e: MessageNotifys<'onNetQuality'>) => void;
+    onOffer?: (e: MessageNotifys<'onOffer'>) => void;
+    onAnswer?: (e: MessageNotifys<'onAnswer'>) => void;
+    onCandidate?: (e: MessageNotifys<'onCandidate'>) => void;
+    onAttemptP2PEx?: (e: MessageNotifys<'onAttemptP2PEx'>) => void;
+    onRtcStats?: (e: MessageNotifys<'onRtcStats'>) => void;
+    onDisconnectedP2P?: (e: MessageNotifys<'onDisconnectedP2P'>) => void;
+}
 export declare class CallsWebSocket {
     config: Config;
     timeout: number;
     prws: PrWebSocket;
+    workerProtos: WorkerProtos;
     events: Events;
-    on: CallsWebSocketOn;
+    on: On;
     /** 日志写入节流：先入内存缓冲，定时批量写 IndexedDB（structured clone 可保留 BigInt） */
     private _logBuffer;
     private _logFlushTimer;
@@ -45,8 +57,8 @@ export declare class CallsWebSocket {
     createRequest: <T extends K_eventName>(eventName: T, options?: Options) => CallsWebSocketEvent<T>;
     hasEvent: (eventName: K_eventName) => boolean;
     clearEvents: () => void;
-    private _dispatchCwsDecodedMessage;
     retryEvents: () => Promise<void>;
     private _updateLogs;
     private _flushLogs;
 }
+export {};

package/dist/src/base/modules/cws/CallsWebSocketEvent.d.ts

@@ -1,9 +1,9 @@
 import { K_eventName } from '../../../enums/eventName';
-import { MessageReq, MessageRsp, MessageRspCore } from '../../../protos/protoEvent';
+import { MessageReq, MessageRsp } from '../../../protos/protoEvent';
 import { PrWebSocket } from './PrWebSocket';
 export interface Options {
     /**
-     * 超时时间 默认10s
+     * 超时时间 默认30s
      */
     timeout?: number;
     /**
@@ -14,23 +14,22 @@ export interface Options {
 export declare class CallsWebSocketEvent<T extends K_eventName> {
     eventName: K_eventName;
     prws: PrWebSocket;
-    message?: MessageReq<T>;
+    message?: any;
     needRetry: boolean;
     sn: number;
-    _resolve: (_value: MessageRspCore<T>) => void;
+    _resolve: (_value: MessageRsp<T>) => void;
     _reject: (_reason?: unknown) => void;
-    sendBefore?: (_message: MessageReq<T>) => void;
-    sendAfter?: () => void;
+    sender?: (_message: any) => void;
     options: {
         timeout: number;
         onBack: boolean;
     };
     timer: number;
     constructor(eventName: T, prws: PrWebSocket, options?: Options);
-    resolve: (_value: MessageRspCore<T> & Partial<Pick<MessageRsp<T>, "time">>) => void;
+    resolve: (_value: MessageRsp<T>) => void;
     reject: (_reason?: unknown) => void;
     retry: () => void;
-    send: (req_message: Pick<MessageReq<T>, "data" | "compress" | "version">) => Promise<MessageRspCore<T>>;
+    send: (req_message: Partial<MessageReq<T>> & Pick<MessageReq<T>, "data">) => Promise<MessageRsp<T>>;
     private sendMsg;
     private _createTimer;
     destroy: () => void;

package/dist/src/base/modules/cws/PrWebSocket.d.ts

@@ -20,6 +20,8 @@ export declare class PrWebSocket {
     activeTimeStamp: number;
     on: On;
     getUrl: () => string;
+    /** 递增后可使尚未触发的 connect 超时回调不再对当前 socket 调用 close（避免误关下一次建连） */
+    private _connectGen;
     constructor();
     connect: () => Promise<number>;
     /**

package/dist/src/base/modules/users/Users.d.ts

@@ -1,6 +1,6 @@
 import { K_mediaType } from '../../../enums/mediaType';
 import { UserMediaTypes, UserTrack } from '../../../types';
-import { User as ProtoUser } from '../../../protos/gen/modules/Room_pb';
+import { User as ProtoUser } from '../../../protos/gen/Room_pb';
 import { Config } from '../Config';
 import { LocalMedias } from '../LocalMedias';
 import { Notifys } from '../Notifys';
@@ -159,7 +159,7 @@ export declare class Users {
         }[];
         p2p_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
     }[];
-    emitUsersChange: () => void;
+    emitUsersChange: (force?: boolean) => void;
     /**
      * getMaxVolumeUser
      */
@@ -205,10 +205,6 @@ export declare class Users {
     createRemoteUser: (userId: string) => RemoteUser;
     checkRemoteUser: (userId: string) => boolean;
     removeRemoteUser: (userId: string) => void;
-    /**
-     * onPublish：更新已存在的远端用户轨道与通话状态（列表外用户返回 false，由上层忽略）
-     */
-    applyRemoteUserPublishNotify: (user: Pick<ProtoUser, "id"> & Partial<Pick<ProtoUser, "callAction" | "tracks">>) => boolean;
     /**
      * 远端退出房间：剥离用户并汇总需 SFU 侧 stopReceivers / closeTrack 的 mid 与轨道
      */
@@ -224,7 +220,7 @@ export declare class Users {
         mids: string[];
     }[];
     updateUsersIsAdmin: (adminIds?: string[]) => void;
-    initUsers: (users: ProtoUser[], clear: boolean) => void;
+    initUsers: (users: ProtoUser[]) => void;
     clearRemoteUsers: () => void;
     createRemoteUserP2P: (userId: string) => RemoteUserP2P;
     syncRemoteUserP2PSenderStreamTrack: (mediaTypes: K_mediaType[]) => Promise<void>;

package/dist/src/base/modules/users/modules/RemotePeerTrackAnalysis.d.ts

@@ -13,6 +13,11 @@ export declare class RemotePeerTrackAnalysis {
      * 使用已筛选的 stats 子集更新网络信息
      */
     applyFromReports: (reports: ReportInfo[]) => TrackReport;
+    /**
+     * 本端 SFU inbound 丢包与对端 DataChannel 上报的上行丢包（RtcStatsData）取较小值，再重算 quality，
+     * 用于弱化「他端→SFU」问题对本端下行判定的影响。
+     */
+    blendDownlinkLostWithPeerUplink: (peerPacketsLostRate: number | undefined) => void;
     /**
      * 生成网络信息（单轨 getStats，兼容旧调用）
      */

package/dist/src/base/modules/users/modules/RemoteUser.d.ts

@@ -1,5 +1,6 @@
 import { UserBase } from './UserBase';
 import { K_mediaType } from '../../../../enums/mediaType';
+import { RtcStatsData } from '../../../../protos/gen/Rtc_pb';
 import { LocalMedias } from '../../LocalMedias';
 import { RemoteUserP2P } from './RemoteUserP2P';
 import { Config } from '../../Config';
@@ -36,6 +37,8 @@ export declare class RemoteUser extends UserBase {
         [key in K_mediaType]?: HTMLAudioElement;
     };
     p2p?: RemoteUserP2P;
+    /** 对端经 SFU DataChannel 广播的 RtcStatsData（上行轨统计），用于本端计算其 SFU 下行时与 inbound 丢包取 min */
+    peerRtcStats?: RtcStatsData;
     constructor({ config, localMedias }: {
         config: Config;
         localMedias: LocalMedias;
@@ -45,6 +48,9 @@ export declare class RemoteUser extends UserBase {
         subscribed_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
     };
     setSubscribed: (mediaTypes: K_mediaType[], subscribed: boolean) => void;
+    /** 缓存对端 `localChannelSend(RtcStatsData)` 载荷；`userId` 须与本 RemoteUser.id 一致 */
+    setPeerRtcStats: (data: RtcStatsData) => void;
+    private getPeerUplinkLostRateForMediaType;
     getTrackReports: (origin: "sfu" | "p2p", direction: "sends" | "recvs", mediaType: K_mediaType) => import('../../../..').TrackReport | undefined;
     generateTrackAnalysis: (peer: Peer, sfuStats: RTCStatsReport, p2pStats: RTCStatsReport | null) => Promise<void>;
     useRemoteStream: (mediaTypes: K_mediaType[], peer: Peer) => void;

package/dist/src/base/modules/users/modules/RemoteUserP2P.d.ts

@@ -1,8 +1,6 @@
 import { PrResolves } from '../../PrResolves';
-import { SendMessageFormat } from '../../../../protos/protoEvent';
-import { RtcTrack } from '../../../../protos/gen/modules/Rtc_pb';
-import { Track } from '../../../../protos/gen/modules/Room_pb';
-import { K_eventName } from '../../../../enums/eventName';
+import { RtcTrack } from '../../../../protos/gen/Rtc_pb';
+import { Track } from '../../../../protos/gen/Room_pb';
 import { K_mediaType } from '../../../../enums/mediaType';
 import { Config } from '../../Config';
 export interface MediaTypeTransceiver {
@@ -45,7 +43,7 @@ export declare class RemoteUserP2P {
         config: Config;
         remoteUserId: string;
     });
-    remoteChannelSend: <T extends K_eventName>(message: Pick<SendMessageFormat<T>, "event" | "data"> & Partial<Omit<SendMessageFormat<T>, "event" | "data">>) => Promise<void>;
+    remoteChannelSend: (tracks: RtcTrack[]) => Promise<void>;
     init: () => void;
     getSenderTrack: (mediaType: K_mediaType) => MediaStreamTrack | null | undefined;
     getRecvierTrack: (mediaType: K_mediaType) => MediaStreamTrack | undefined;

package/dist/src/base/modules/users/modules/UserBase.d.ts

@@ -28,6 +28,13 @@ export declare class UserBase {
     tracks: {
         [key in K_mediaType]?: UserTrack;
     };
+    /**
+     * 数据通道
+     */
+    channels: Array<{
+        id?: number;
+        dataChannelName: string;
+    }>;
     /**
      * 网络情况
      */
@@ -70,9 +77,10 @@ export declare class UserBase {
     streams: {
         [key in K_mediaType]: MediaStream;
     };
-    constructor({ config, localMedias }: {
+    constructor({ config, localMedias, notEmpty }: {
         config: Config;
         localMedias: LocalMedias;
+        notEmpty: boolean;
     });
     setMute: (mediaTypes: K_mediaType[], mute: boolean) => void;
     updateCallAction: (callAction: number) => void;
@@ -86,7 +94,11 @@ export declare class UserBase {
         type?: number;
         trackName?: string;
         mid?: string;
-    }>, clear?: boolean) => void;
+    }>) => void;
+    updateChannels: (channels: Array<{
+        id?: number;
+        dataChannelName: string;
+    }>) => void;
     getTrack: (mediaType: K_mediaType) => UserTrack | undefined;
     getTracks: (mediaTypes: K_mediaType[]) => UserTrack[];
     removeTracks: (mediaTypes: K_mediaType[]) => UserTrack[];

package/dist/src/base/modules/webmDurationFixWorkerMain.d.ts

@@ -4,3 +4,5 @@
 export declare function fixWebmDurationInWorker(buffer: ArrayBuffer, mimeType: string): Promise<Blob>;
 /** 终止 WebM 修复 Worker；`QuickVO.destroy` 时应调用。 */
 export declare function destroyWebmFixWorker(): void;
+/** 新 SDK 实例允许再次使用 WebM Worker（与模块级单例对齐）。 */
+export declare function resetWebmFixWorkerAfterNewClient(): void;

package/dist/src/enums/eventName.d.ts

@@ -11,6 +11,9 @@ export declare const enum_eventName: {
     readonly joinRoomEx: "加入房间(提前建连)";
     readonly pubNotify: "广播已发布的轨道";
     readonly subscribe: "订阅流";
+    readonly pubChannel: "发布DataChannel";
+    readonly subChannel: "订阅DataChannel";
+    readonly closeChannel: "关闭DataChannel";
     readonly renegotiate: "协商流";
     readonly closeTrack: "关闭轨道";
     readonly preventUsersBehavior: "阻止用户行为";
@@ -29,6 +32,8 @@ export declare const enum_eventName: {
     readonly debugger: "调试";
     readonly ai: "WorkerAi调试";
     readonly UpdateTrackActive: "p2p轨道状态";
+    readonly rtcStats: "客户端rtc网络质量";
+    readonly RtcStats: "客户端rtc网络质量";
 };
 export type T_eventName = typeof enum_eventName;
 export type K_eventName = keyof T_eventName;
@@ -38,4 +43,4 @@ export declare const eventName_options: {
     label: any;
 }[];
 export declare const eventName_keys: (keyof typeof enum_eventName)[];
-export declare const eventName_vals: ("关闭轨道" | "心跳" | "慢心跳" | "确认收到消息" | "上报网络类型" | "连接CF" | "获取TURN地址" | "发布流" | "加入房间" | "加入房间(提前建连)" | "广播已发布的轨道" | "订阅流" | "协商流" | "阻止用户行为" | "更新网络状态" | "更新通话状态" | "切换大小流" | "切换房间语音识别" | "同步房间" | "更新房间SDKTOKEN" | "发送P2P-offer" | "回应P2P-answer" | "发送P2P候选信息-candidate" | "上报P2P连接结果" | "退出房间" | "退出房间不断开连接" | "调试" | "WorkerAi调试" | "p2p轨道状态")[];
+export declare const eventName_vals: ("心跳" | "慢心跳" | "确认收到消息" | "上报网络类型" | "连接CF" | "获取TURN地址" | "发布流" | "加入房间" | "加入房间(提前建连)" | "广播已发布的轨道" | "订阅流" | "发布DataChannel" | "订阅DataChannel" | "关闭DataChannel" | "协商流" | "关闭轨道" | "阻止用户行为" | "更新网络状态" | "更新通话状态" | "切换大小流" | "切换房间语音识别" | "同步房间" | "更新房间SDKTOKEN" | "发送P2P-offer" | "回应P2P-answer" | "发送P2P候选信息-candidate" | "上报P2P连接结果" | "退出房间" | "退出房间不断开连接" | "调试" | "WorkerAi调试" | "p2p轨道状态" | "客户端rtc网络质量")[];

package/dist/src/enums/mediaType.d.ts

@@ -1,3 +1,4 @@
+import { TrackType } from '../protos/gen/Room_pb';
 export declare const enum_mediaType: {
     readonly mc_audio: "麦克风-默认轨道";
     readonly mc_video: "摄像头-默认轨道";
@@ -13,3 +14,5 @@ export declare const mediaType_options: {
 }[];
 export declare const mediaType_keys: (keyof typeof enum_mediaType)[];
 export declare const mediaType_vals: ("麦克风-默认轨道" | "摄像头-默认轨道" | "屏幕共享-视频轨道" | "屏幕共享-音频轨道")[];
+/** 与 Room.proto `TrackType` 一致，供 RtcStatsData / protobuf 使用 */
+export declare function mediaTypeToProtoTrackType(mediaType: K_mediaType): TrackType;

package/dist/src/enums/notifyName.d.ts

@@ -1,6 +1,8 @@
 export declare const enum_notifyName: {
     readonly onNetQuality: "网络质量回调";
+    readonly onRtcStats: "远端用户网络信息广播";
     readonly updateSeverTime: "服务端时间更新";
+    readonly onDataChannelPublish: "用户房间DataChannel发布或变更";
     readonly onJoinRoom: "加入房间回调";
     readonly onJoinRoomBatch: "加入房间批量回调";
     readonly onQuitRoom: "退出房间回调";
@@ -33,4 +35,4 @@ export declare const notifyName_options: {
     label: any;
 }[];
 export declare const notifyName_keys: (keyof typeof enum_notifyName)[];
-export declare const notifyName_vals: ("网络质量回调" | "服务端时间更新" | "加入房间回调" | "加入房间批量回调" | "退出房间回调" | "退出房间批量回调" | "监听到流发布" | "关闭轨道" | "更新通讯状态" | "通知轨道失效" | "房间内的全体禁言状态发生变化" | "房间内的管理员发生变化" | "建立P2P连接" | "收到P2P-offer" | "收到P2P-answer" | "收到P2P候选信息-candidate" | "断开P2P" | "更新推流权限通知" | "批量更新推流权限通知" | "Token即将过期" | "Token已过期" | "销毁房间" | "行为允许权限变更" | "cdn播放地址变化" | "用户讲话")[];
+export declare const notifyName_vals: ("关闭轨道" | "网络质量回调" | "远端用户网络信息广播" | "服务端时间更新" | "用户房间DataChannel发布或变更" | "加入房间回调" | "加入房间批量回调" | "退出房间回调" | "退出房间批量回调" | "监听到流发布" | "更新通讯状态" | "通知轨道失效" | "房间内的全体禁言状态发生变化" | "房间内的管理员发生变化" | "建立P2P连接" | "收到P2P-offer" | "收到P2P-answer" | "收到P2P候选信息-candidate" | "断开P2P" | "更新推流权限通知" | "批量更新推流权限通知" | "Token即将过期" | "Token已过期" | "销毁房间" | "行为允许权限变更" | "cdn播放地址变化" | "用户讲话")[];

package/dist/src/index.d.ts

@@ -1,8 +1,4 @@
 export * from './QuickVO';
 export * from './types';
 export * from './enums/index';
-/** 与 Room.proto IceConnectType 一致，由 buf 自 Room_pb 生成 */
-export { IceConnectType } from './protos/gen/modules/Room_pb';
 export * as tools from './tools';
-/** cws 广播 on 回调：按事件名推断 payload */
-export { defineCwsOn, type CallsWebSocketOn, type CwsNotifyPayloadFor, type CwsNotifyPayloadUnion, } from './protos/protoEvent';

package/dist/src/protos/gen/{modules/BaseData_pb.d.ts → BaseData_pb.d.ts}

@@ -1,9 +1,9 @@
 import { GenFile, GenMessage } from '@bufbuild/protobuf/codegenv2';
 import { Message } from '@bufbuild/protobuf';
 /**
- * Describes the file modules/BaseData.proto.
+ * Describes the file BaseData.proto.
  */
-export declare const file_modules_BaseData: GenFile;
+export declare const file_BaseData: GenFile;
 /**
  * 请求
  *