whepts 1.1.8 → 1.1.10

package/dist/core/connection.d.ts

@@ -6,17 +6,65 @@ export interface ConnectionManagerOptions {
     emitter: EventEmitter;
     getNonAdvertisedCodecs: () => string[];
 }
+/**
+ * WebRTC 连接管理器
+ *
+ * 负责管理 RTCPeerConnection 的生命周期和事件处理。
+ */
 export declare class ConnectionManager {
     private options;
     private pc?;
     private offerData?;
     constructor(options: ConnectionManagerOptions);
+    /**
+     * 创建并配置 PeerConnection
+     */
     setupPeerConnection(iceServers: RTCIceServer[]): Promise<string>;
+    /**
+     * 设置远程 SDP Answer
+     */
     setAnswer(answer: string): Promise<void>;
     getPeerConnection(): RTCPeerConnection | undefined;
     getOfferData(): ParsedOffer | undefined;
     close(): void;
-    private onLocalCandidate;
-    private onConnectionState;
-    private onIceConnectionState;
+    /**
+     * 处理本地 ICE 候选事件
+     */
+    private handleIceCandidate;
+    /**
+     * 处理连接状态变化
+     *
+     * connectionState 可能的值：
+     * - 'new': 刚创建，还未连接
+     * 'connecting': 正在连接中
+     * 'connected': 已连接
+     * - 'disconnected': 已断开（可能短暂）
+     * - 'failed': 连接失败
+     * - 'closed': 已关闭
+     *
+     * 连接失败或关闭属于流断开，触发 flow:stalled 事件进行恢复。
+     */
+    private handleConnectionState;
+    /**
+     * 处理 ICE 连接状态变化
+     *
+     * iceConnectionState 可能的值：
+     * - 'new': 刚创建，还未检查
+     * - 'checking': 正在检查
+     * 'connected': ICE 连接成功
+     * 'completed': ICE 连接完成
+     * 'failed': ICE 连接失败
+     * 'disconnected': ICE 连接断开（可能短暂）
+     */
+    private handleIceConnectionState;
+    /**
+     * 处理媒体轨道事件
+     */
+    private handleTrack;
+    /**
+     * 重启 ICE 连接
+     *
+     * 当 ICE 连接失败时，尝试重启 ICE 以恢复连接
+     */
+    private restartIceConnection;
 }

package/dist/core/track.d.ts

@@ -1,16 +1,22 @@
 import type { EventEmitter } from 'eventemitter3';
+import type { MonitorScheduler } from '~/monitors/scheduler';
 export declare class TrackManager {
     private container;
+    private eventEmitter;
     private lazyLoad;
     private stream?;
     private observer?;
     private showStore;
     private playMonitor;
     private flowMonitor;
-    constructor(container: HTMLMediaElement, eventEmitter: EventEmitter, lazyLoad?: boolean);
+    constructor(container: HTMLMediaElement, eventEmitter: EventEmitter, lazyLoad: boolean | undefined, scheduler: MonitorScheduler);
     onTrack(evt: RTCTrackEvent, pc?: RTCPeerConnection): void;
     get paused(): boolean;
     pause(): void;
     resume(): void;
     stop(): void;
+    /**
+     * 永久销毁（仅在 WebRTCWhep.close() 时调用）
+     */
+    destroy(): void;
 }

package/dist/errors.d.ts

@@ -4,14 +4,20 @@
 export type ErrorType = string;
 /**
  * 错误类型常量
+ *
+ * 错误分类：
+ * - SIGNAL_ERROR: 信令异常（SDP、ICE 服务器）
+ * - STATE_ERROR: 状态异常（播放器已关闭等）
+ * - REQUEST_ERROR: 请求异常（400、406 等错误状态码）
+ * - NOT_FOUND_ERROR: 资源未找到（404）
+ *
+ * 注意：流连接断开已由 `flow:stalled` 事件独立处理，不作为错误类型。
  */
 export declare const ErrorTypes: {
     SIGNAL_ERROR: string;
     STATE_ERROR: string;
     REQUEST_ERROR: string;
     NOT_FOUND_ERROR: string;
-    CONNECT_ERROR: string;
-    MEDIA_ERROR: string;
     OTHER_ERROR: string;
 };
 /**