quickvo-sdk-js 1.6.63 → 1.6.71

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

@@ -0,0 +1,119 @@
+import { K_notifyName } from '../../enums/notifyName';
+import { K_roomState } from '../../enums/roomState';
+import { CwsNotifyPayloadFor } from '../../protos/protoEvent';
+import { RoomUser } from '../../types';
+/**
+ * SDK 内部派发的通知名（不经由 CWS OnMessageDataMap）
+ */
+export type SdkOnlyNotifyName = 'onLog' | 'onRoomUsers' | 'onRoomNetwork' | 'onDevicechange' | 'onPeerState' | 'onRoomState';
+/** QuickVO.addNotify / Notifys 支持的完整事件名 */
+export type K_quickvoNotifyName = K_notifyName | SdkOnlyNotifyName;
+type WithSn<T> = T & {
+    sn?: string;
+};
+type CwsNotifyPayloadWithSn<K extends K_notifyName> = WithSn<CwsNotifyPayloadFor<K>>;
+/** 与 Config.network / ActionSFU 网络汇总一致 */
+export type RoomNetworkNotifyData = {
+    sfu: {
+        inboundBytes: number;
+        outboundBytes: number;
+        lostRate: number;
+        roundTripTime: number;
+        jitter: number;
+        quality: number;
+        averageQuality: number;
+        velocityPush: number;
+        velocityPull: number;
+    };
+    p2p: {
+        inboundBytes: number;
+        outboundBytes: number;
+        lostRate: number;
+        roundTripTime: number;
+        jitter: number;
+        quality: number;
+        averageQuality: number;
+        velocityPush: number;
+        velocityPull: number;
+    };
+};
+/** 与 Base._reportLog 的 type 参数一致 */
+export type ReportLogNotifyType = 'ws_c_timeout' | 'webrtc_c_timeout' | 'join_room_error' | 'publish_error' | 'subscribe_error' | 'close_track_error' | 'heartbeat_e_timeout' | 'heartbeat_i_timeout' | 'quit_room_error';
+/**
+ * 各通知事件 emit 第二参 / callback 第一参的精确类型
+ */
+export type NotifyPayloadMap = {
+    [K in K_notifyName]: CwsNotifyPayloadWithSn<K>;
+} & {
+    onLog: WithSn<{
+        code: number;
+        desc: string;
+        data: {
+            message: unknown;
+        } | {
+            type: ReportLogNotifyType;
+        };
+    }>;
+    onRoomUsers: WithSn<{
+        code: number;
+        desc: string;
+        data: RoomUser[];
+    }>;
+    onRoomNetwork: WithSn<{
+        code: number;
+        desc: string;
+        data: RoomNetworkNotifyData;
+    }>;
+    onDevicechange: WithSn<{
+        code: number;
+        desc: string;
+        data: Record<string, never>;
+    }>;
+    onPeerState: WithSn<{
+        code: number;
+        desc: string;
+        data: {
+            state: RTCPeerConnectionState;
+        };
+    }>;
+    onRoomState: WithSn<{
+        code: number;
+        desc: string;
+        data: {
+            state: K_roomState;
+        };
+    }>;
+};
+export type NotifyEmitPayloadFor<E extends K_quickvoNotifyName> = NotifyPayloadMap[E];
+/** 所有通知 payload 的联合（需按 event 收窄时请用 NotifyEmitPayloadFor<E>） */
+export type NotifyEmitPayloadUnion = NotifyPayloadMap[K_quickvoNotifyName];
+/**
+ * addNotify 注册的 discriminated union：event 与 callback 参数类型联动
+ */
+export type QuickvoNotify = {
+    [E in K_quickvoNotifyName]: {
+        sn?: string;
+        event: E;
+        callback?: (e: NotifyPayloadMap[E]) => void;
+    };
+}[K_quickvoNotifyName];
+/**
+ * 辅助推断：注册通知时无需手写 payload 泛型
+ * @example
+ * ```ts
+ * quickvo.addNotify(defineQuickvoNotify({
+ *   event: 'onJoinRoom',
+ *   callback: (e) => e.data.user,
+ * }))
+ * ```
+ */
+export declare function defineQuickvoNotify<const E extends K_quickvoNotifyName>(notify: {
+    sn?: string;
+    event: E;
+    callback?: (e: NotifyPayloadMap[E]) => void;
+}): {
+    sn?: string;
+    event: E;
+    callback?: (e: NotifyPayloadMap[E]) => void;
+};
+export {};

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

@@ -1,5 +1,6 @@
 import { K_mediaType } from '../../../enums/mediaType';
-import { RoomUser, UserMediaTypes } from '../../../types';
+import { UserMediaTypes, UserTrack } from '../../../types';
+import { User as ProtoUser } from '../../../protos/gen/modules/Room_pb';
 import { Config } from '../Config';
 import { LocalMedias } from '../LocalMedias';
 import { Notifys } from '../Notifys';
@@ -12,6 +13,7 @@ export declare class Users {
     notifys: Notifys;
     localUser: LocalUser;
     remoteUsers: Map<string, RemoteUser>;
+    _emitUsersChangeTimer: number;
     constructor({ config, localMedias, notifys }: {
         config: Config;
         localMedias: LocalMedias;
@@ -132,12 +134,31 @@ export declare class Users {
      */
     setBgmGain: (userId: string, mediaType: K_mediaType, gain: number) => Promise<void>;
     getrP2PConnectedCount: () => number;
-    addRemoteUsersSubscribes: (usersMediaTypes?: UserMediaTypes[]) => void;
-    executeRemoteUsersSubscribes: () => {
+    addRemoteUsersSubscribed: (usersMediaTypes?: UserMediaTypes[]) => void;
+    removeRemoteUsersSubscribed: (usersMediaTypes?: UserMediaTypes[]) => void;
+    createRemoteUsersSubscribeData: (lastRetry?: boolean) => {
         id: string;
-        tracks: import('../../..').UserTrack[];
+        tracks: {
+            type: number;
+            lastRetry: boolean;
+        }[];
+    }[];
+    createRemoteUsersCloseData: () => {
+        userId: string;
+        sfu_tracks: {
+            userId: string;
+            mediaType: K_mediaType;
+            trackName: string;
+            origin: "phoney" | "local" | "sfu" | "p2p";
+            simulcast: "f" | "h" | "q";
+            location: string;
+            mid: string;
+            msid: string;
+            type: number;
+            enabled: boolean;
+        }[];
+        p2p_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
     }[];
-    completedRemoteUsersSubscribes: (users: RoomUser[]) => void;
     emitUsersChange: () => void;
     /**
      * getMaxVolumeUser
@@ -149,47 +170,26 @@ export declare class Users {
     getUserStream: (userId: string, mediaType: K_mediaType) => MediaStream | undefined;
     getUsersInfo: () => {
         id: string;
-        callAction: number;
-        callActionStr: string;
-        callActionMap: {
-            mc_audio?: boolean | undefined;
-            mc_video?: boolean | undefined;
-            ss_video?: boolean | undefined;
-            ss_audio?: boolean | undefined;
-        };
-        permissions: number;
-        permissionsStr: string;
-        permissionsMap: {
-            subscribe: boolean;
-            publish: boolean;
-        };
-        banBehavior: number;
-        banBehaviorStr: string;
-        banBehaviorMap: {
-            mc_audio?: boolean | undefined;
-            mc_video?: boolean | undefined;
-            ss_video?: boolean | undefined;
-            ss_audio?: boolean | undefined;
-        };
         isOwner: boolean;
         isAdmin: boolean;
         isSelf: boolean;
+        callAction: number;
+        permissions: number;
+        behavior: number;
         network: {
             egress: number;
             ingress: number;
         };
         tracks: {
-            location?: string | undefined;
-            mid?: string | null | undefined;
-            msid?: string | undefined;
-            trackName?: string | undefined;
-            userId?: string;
-            type?: number | undefined;
-            mediaType?: "mc_audio" | "mc_video" | "ss_video" | "ss_audio" | undefined;
-            enabled?: boolean;
-            origin?: "unknown" | "phoney" | "local" | "sfu" | "p2p" | undefined;
-            simulcast?: "f" | "h" | "q";
-            lastRetry?: boolean;
+            mediaType: K_mediaType;
+            trackName: string;
+            origin: "phoney" | "local" | "sfu" | "p2p";
+            simulcast: "f" | "h" | "q";
+            location: string;
+            mid: string;
+            msid: string;
+            type: number;
+            enabled: boolean;
         }[];
     }[];
     getP2PState: () => {
@@ -205,9 +205,27 @@ 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 与轨道
+     */
+    detachRemoteUsersForQuit: (userIds: string[]) => {
+        removeUserIds: string[];
+        removeMids: string[];
+        removeTracks: UserTrack[];
+    };
+    /**
+     * syncRoomInfo：本地远端用户若不在服务端返回的 id 集合中则移除；返回每位被移除用户对应的 SFU recv mid（供 Peer.stopReceivers 分批调用，行为与原先一致）
+     */
+    pruneRemoteUsersNotInServerList: (serverUserIds: readonly string[]) => {
+        mids: string[];
+    }[];
     updateUsersIsAdmin: (adminIds?: string[]) => void;
-    initUsers: (users: any[]) => void;
-    clearUsers: () => void;
+    initUsers: (users: ProtoUser[], clear: boolean) => void;
+    clearRemoteUsers: () => void;
     createRemoteUserP2P: (userId: string) => RemoteUserP2P;
     syncRemoteUserP2PSenderStreamTrack: (mediaTypes: K_mediaType[]) => Promise<void>;
 }

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

@@ -1,4 +1,4 @@
-import { TrackReport } from '../../../../types';
+import { ReportInfo, TrackReport } from '../../../../types';
 export declare class LocalTrackAnalysis {
     types: string[];
     trackReport: TrackReport;
@@ -10,7 +10,11 @@ export declare class LocalTrackAnalysis {
     availableScore: number[];
     constructor();
     /**
-     * 生成网络信息
+     * 使用已筛选的 stats 子集更新网络信息（由上层对整连接 `getStats()` 分轨后传入）
+     */
+    applyFromReports: (reports: ReportInfo[]) => TrackReport;
+    /**
+     * 生成网络信息（单轨 getStats，兼容旧调用；推荐上层使用整连接 getStats + applyFromReports）
      */
     generate: (pc: RTCPeerConnection, track: MediaStreamTrack | undefined | null) => Promise<TrackReport>;
     /**

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

@@ -12,13 +12,20 @@ interface LocalUserTracksAnalysis {
     };
 }
 export declare class LocalUser extends UserBase {
+    /**
+     * 应发布的轨道
+     */
+    published: {
+        [key in K_mediaType]: Boolean;
+    };
     tracksAnalysis: LocalUserTracksAnalysis;
     constructor({ config, localMedias }: {
         config: Config;
         localMedias: LocalMedias;
     });
     getTrackReports: (mediaType: K_mediaType) => import('../../../..').TrackReport;
-    generateTrackAnalysis: (peer: Peer) => Promise<void>;
+    generateTrackAnalysis: (peer: Peer, sfuStats: RTCStatsReport) => Promise<void>;
+    setPublished: (mediaTypes: K_mediaType[], published: boolean) => void;
     /**
      * setActiveNoise
      * @param mediaType K_mediaType

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

@@ -10,7 +10,11 @@ export declare class RemotePeerTrackAnalysis {
     availableScore: number[];
     constructor();
     /**
-     * 生成网络信息
+     * 使用已筛选的 stats 子集更新网络信息
+     */
+    applyFromReports: (reports: ReportInfo[]) => TrackReport;
+    /**
+     * 生成网络信息（单轨 getStats，兼容旧调用）
      */
     generate: (pc: RTCPeerConnection, track: MediaStreamTrack | undefined | null) => Promise<TrackReport>;
     /**

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

@@ -6,7 +6,6 @@ import { Config } from '../../Config';
 import { Peer } from '../../Peer';
 import { LocalTrackAnalysis } from './LocalTrackAnalysis';
 import { RemotePeerTrackAnalysis } from './RemotePeerTrackAnalysis';
-import { UserTrack } from '../../../../types';
 interface RemoteUserTracksAnalysis {
     sfu: {
         recvs: {
@@ -23,16 +22,13 @@ interface RemoteUserTracksAnalysis {
     };
 }
 export declare class RemoteUser extends UserBase {
-    tracksAnalysis: RemoteUserTracksAnalysis;
     /**
-     * 订阅状态 剩余订阅次数
+     * 应订阅的轨道 可尝试订阅次数
      */
-    subscribeState: {
-        [key in K_mediaType]?: number;
-    };
-    publishWaiting: {
-        [key in K_mediaType]?: number;
+    subscribed: {
+        [key in K_mediaType]: boolean;
     };
+    tracksAnalysis: RemoteUserTracksAnalysis;
     /**
      * 数据接收器
      */
@@ -44,19 +40,13 @@ export declare class RemoteUser extends UserBase {
         config: Config;
         localMedias: LocalMedias;
     });
-    getTrackReports: (origin: "sfu" | "p2p", direction: "sends" | "recvs", mediaType: K_mediaType) => import('../../../..').TrackReport | undefined;
-    generateTrackAnalysis: (peer: Peer) => Promise<void>;
-    addSubscribe: (mediaTypes: K_mediaType[], count?: number) => void;
-    executeSubscribe: () => {
-        id: string;
-        tracks: UserTrack[];
-    };
-    completedSubscribe: (mediaTypes: K_mediaType[]) => void;
-    setPublishWaiting: (mediaTypes: K_mediaType[]) => void;
-    checkSubscribed: (mediaTypes: K_mediaType[], origin?: "sfu" | "p2p" | "all") => {
-        subscribed_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
+    checkSubscribed: (mediaTypes: K_mediaType[]) => {
         prohibited_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
+        subscribed_mediaTypes: ("mc_audio" | "mc_video" | "ss_video" | "ss_audio")[];
     };
+    setSubscribed: (mediaTypes: K_mediaType[], subscribed: boolean) => void;
+    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;
     useRemoteP2PStream: (mediaTypes: K_mediaType[]) => void;
     clear: () => void;

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

@@ -1,4 +1,8 @@
 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 { K_mediaType } from '../../../../enums/mediaType';
 import { Config } from '../../Config';
 export interface MediaTypeTransceiver {
@@ -15,8 +19,8 @@ export declare class RemoteUserP2P {
     config: Config;
     prResolves: PrResolves<string>;
     remoteUserId: string;
-    peer?: RTCPeerConnection;
-    timer?: NodeJS.Timeout;
+    pc?: RTCPeerConnection;
+    timer?: number;
     channelLocal?: RTCDataChannel;
     channelRemote?: RTCDataChannel;
     channelRemoteList: RTCDataChannel[];
@@ -41,7 +45,7 @@ export declare class RemoteUserP2P {
         config: Config;
         remoteUserId: string;
     });
-    remoteChannelSend: (message: any) => Promise<void>;
+    remoteChannelSend: <T extends K_eventName>(message: Pick<SendMessageFormat<T>, "event" | "data"> & Partial<Omit<SendMessageFormat<T>, "event" | "data">>) => Promise<void>;
     init: () => void;
     getSenderTrack: (mediaType: K_mediaType) => MediaStreamTrack | null | undefined;
     getRecvierTrack: (mediaType: K_mediaType) => MediaStreamTrack | undefined;
@@ -68,6 +72,7 @@ export declare class RemoteUserP2P {
         mid: string | null;
         mediaType: string;
     }[];
+    /** 供 CWS offer 等使用，形状贴近 Room.Track 初始化（非 RtcTrack） */
     getRecvUserTracks: (mediaTypes?: K_mediaType[]) => {
         type: number;
         enabled: boolean;
@@ -76,11 +81,18 @@ export declare class RemoteUserP2P {
         mediaType: string;
         isActive: number | undefined;
     }[];
+    /** CWS offer/answer 的 repeated Track，需 @bufbuild create(Room.Track) */
+    getRecvUserTracksAsRoomTrack: (mediaTypes?: K_mediaType[]) => Track[];
+    getSenderUserTracksAsRoomTrack: (mediaTypes?: K_mediaType[]) => Track[];
+    /** DataChannel 事件 UpdateTrackActive 需 protobuf RtcTrack（@bufbuild create） */
+    getRecvUserTracksAsRtc: (mediaTypes?: K_mediaType[]) => RtcTrack[];
     checkReceActive: (mediaType: K_mediaType) => number | false;
     getTrack: (mediaType: K_mediaType) => MediaStreamTrack | undefined;
     checkPeer: () => RTCPeerConnection;
     close: () => void;
     destroy: () => Promise<void>;
+    /** ICE 收集结束：`onicecandidate` 的 null，或 `iceGatheringState === 'complete'` */
+    private _markIceGatheringComplete;
     private _clear;
     private _filterSdp;
 }

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

@@ -10,31 +10,6 @@ export declare class UserBase {
      * 用户ID
      */
     id: string;
-    /**
-     * 通话行为
-     */
-    callAction: number;
-    callActionStr: string;
-    callActionMap: {
-        [key in K_mediaType]?: boolean;
-    };
-    /**
-     * 用户权限
-     */
-    permissions: number;
-    permissionsStr: string;
-    permissionsMap: {
-        subscribe: boolean;
-        publish: boolean;
-    };
-    /**
-     * 禁用行为
-     */
-    banBehavior: number;
-    banBehaviorStr: string;
-    banBehaviorMap: {
-        [key in K_mediaType]?: boolean;
-    };
     /**
      * 是否为自己
      */
@@ -47,6 +22,12 @@ export declare class UserBase {
      * 是否为管理员
      */
     isAdmin: boolean;
+    /**
+     * 用户轨道
+     */
+    tracks: {
+        [key in K_mediaType]?: UserTrack;
+    };
     /**
      * 网络情况
      */
@@ -63,11 +44,17 @@ export declare class UserBase {
         ingress: number;
     };
     /**
-     * 用户轨道
+     * 通话行为
      */
-    tracks: {
-        [key in K_mediaType]?: UserTrack;
-    };
+    callAction: number;
+    /**
+     * 用户权限
+     */
+    permissions: number;
+    /**
+     * 禁用行为
+     */
+    behavior: number;
     /**
      * 用户流控制器
      */
@@ -83,47 +70,23 @@ export declare class UserBase {
     streams: {
         [key in K_mediaType]: MediaStream;
     };
-    /**
-     * 是否已发布 (本地用户有效 远端用户均为true)
-     */
-    published: {
-        [key in K_mediaType]?: Boolean;
-    };
-    /**
-     * 是否已订阅 (远端用户有效 本地用户均为true)
-     */
-    subscribed: {
-        [key in K_mediaType]?: Boolean;
-    };
     constructor({ config, localMedias }: {
         config: Config;
         localMedias: LocalMedias;
     });
     setMute: (mediaTypes: K_mediaType[], mute: boolean) => void;
-    setTracksPublished: (mediaTypes: K_mediaType[], published: boolean) => void;
-    setTracksSubscribed: (mediaTypes: K_mediaType[], subscribed: boolean) => void;
-    /**
-     * updateCallAction
-     */
     updateCallAction: (callAction: number) => void;
-    /**
-     * updatePermissions
-     */
     updatePermissions: (permissions: number) => void;
-    /**
-     * updateBanBehavior
-     */
-    updateBanBehavior: (banBehavior: number) => void;
+    updateBehavior: (behavior: number) => void;
     updateNetwork: (network: {
         egress: number;
         ingress: number;
     }) => boolean;
-    /**
-     * updateBanBehavior
-     * @param tracks
-     * @param clear
-     */
-    updateTracks: (tracks: Omit<UserTrack, "location" | "mediaType" | "origin">[], clear?: boolean) => void;
+    updateTracks: (tracks: Array<{
+        type?: number;
+        trackName?: string;
+        mid?: string;
+    }>, clear?: boolean) => void;
     getTrack: (mediaType: K_mediaType) => UserTrack | undefined;
     getTracks: (mediaTypes: K_mediaType[]) => UserTrack[];
     removeTracks: (mediaTypes: K_mediaType[]) => UserTrack[];
@@ -136,37 +99,15 @@ export declare class UserBase {
         ss_audio: MediaStream;
     };
     getUserMediaStreamContext: (mediaType: K_mediaType) => PrAudioStream | undefined;
-    /**
-     * 使用假流数据
-     */
-    usePhoneyStream: (mediaTypes: K_mediaType[]) => void;
+    usePhoneyStream: (mediaTypes: K_mediaType[], replaceMediaStreamTrack?: boolean) => void;
     getInfo: () => {
         id: string;
-        callAction: number;
-        callActionStr: string;
-        callActionMap: {
-            mc_audio?: boolean | undefined;
-            mc_video?: boolean | undefined;
-            ss_video?: boolean | undefined;
-            ss_audio?: boolean | undefined;
-        };
-        permissions: number;
-        permissionsStr: string;
-        permissionsMap: {
-            subscribe: boolean;
-            publish: boolean;
-        };
-        banBehavior: number;
-        banBehaviorStr: string;
-        banBehaviorMap: {
-            mc_audio?: boolean | undefined;
-            mc_video?: boolean | undefined;
-            ss_video?: boolean | undefined;
-            ss_audio?: boolean | undefined;
-        };
         isOwner: boolean;
         isAdmin: boolean;
         isSelf: boolean;
+        callAction: number;
+        permissions: number;
+        behavior: number;
         network: {
             /**
              * 上行网络质量  quality 的值 0 - 5
@@ -180,17 +121,15 @@ export declare class UserBase {
             ingress: number;
         };
         tracks: {
-            location?: string | undefined;
-            mid?: string | null | undefined;
-            msid?: string | undefined;
-            trackName?: string | undefined;
-            userId?: string;
-            type?: number | undefined;
-            mediaType?: "mc_audio" | "mc_video" | "ss_video" | "ss_audio" | undefined;
-            enabled?: boolean;
-            origin?: "unknown" | "phoney" | "local" | "sfu" | "p2p" | undefined;
-            simulcast?: "f" | "h" | "q";
-            lastRetry?: boolean;
+            mediaType: K_mediaType;
+            trackName: string;
+            origin: "phoney" | "local" | "sfu" | "p2p";
+            simulcast: "f" | "h" | "q";
+            location: string;
+            mid: string;
+            msid: string;
+            type: number;
+            enabled: boolean;
         }[];
     };
 }

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

@@ -0,0 +1,9 @@
+import { ReportInfo } from '../../../types';
+/**
+ * 从整连接 `getStats()` 结果中筛出与某条发送轨道相关的报告（对齐原 `getStats(track)` 子集）
+ */
+export declare function filterOutboundTrackReports(report: RTCStatsReport, track: MediaStreamTrack | null | undefined): ReportInfo[];
+/**
+ * 从整连接 `getStats()` 结果中筛出与某条接收轨道相关的报告
+ */
+export declare function filterInboundTrackReports(report: RTCStatsReport, track: MediaStreamTrack | null | undefined, mid?: string | null): ReportInfo[];

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

@@ -0,0 +1,6 @@
+/**
+ * 在 Worker 内执行 webm-duration-fix；`buffer` 在 postMessage 时 transfer，调用后勿再读。
+ */
+export declare function fixWebmDurationInWorker(buffer: ArrayBuffer, mimeType: string): Promise<Blob>;
+/** 终止 WebM 修复 Worker；`QuickVO.destroy` 时应调用。 */
+export declare function destroyWebmFixWorker(): void;

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

@@ -4,6 +4,8 @@ export declare const enum_eventName: {
     readonly ackMsg: "确认收到消息";
     readonly reportNetwork: "上报网络类型";
     readonly connectCF: "连接CF";
+    /** 获取 TURN/STUN 等 ICE 服务配置（SFU 主连接前） */
+    readonly genTurnAddress: "获取TURN地址";
     readonly publish: "发布流";
     readonly joinRoom: "加入房间";
     readonly joinRoomEx: "加入房间(提前建连)";
@@ -36,4 +38,4 @@ export declare const eventName_options: {
     label: any;
 }[];
 export declare const eventName_keys: (keyof typeof enum_eventName)[];
-export declare const eventName_vals: ("关闭轨道" | "心跳" | "慢心跳" | "确认收到消息" | "上报网络类型" | "连接CF" | "发布流" | "加入房间" | "加入房间(提前建连)" | "广播已发布的轨道" | "订阅流" | "协商流" | "阻止用户行为" | "更新网络状态" | "更新通话状态" | "切换大小流" | "切换房间语音识别" | "同步房间" | "更新房间SDKTOKEN" | "发送P2P-offer" | "回应P2P-answer" | "发送P2P候选信息-candidate" | "上报P2P连接结果" | "退出房间" | "退出房间不断开连接" | "调试" | "WorkerAi调试" | "p2p轨道状态")[];
+export declare const eventName_vals: ("关闭轨道" | "心跳" | "慢心跳" | "确认收到消息" | "上报网络类型" | "连接CF" | "获取TURN地址" | "发布流" | "加入房间" | "加入房间(提前建连)" | "广播已发布的轨道" | "订阅流" | "协商流" | "阻止用户行为" | "更新网络状态" | "更新通话状态" | "切换大小流" | "切换房间语音识别" | "同步房间" | "更新房间SDKTOKEN" | "发送P2P-offer" | "回应P2P-answer" | "发送P2P候选信息-candidate" | "上报P2P连接结果" | "退出房间" | "退出房间不断开连接" | "调试" | "WorkerAi调试" | "p2p轨道状态")[];

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

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

package/dist/src/index.d.ts

@@ -1,3 +1,8 @@
 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';