@give-tech/ec-player 0.0.1-beta.0

package/dist/parser/NALParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NALParser.d.ts","sourceRoot":"","sources":["../../src/parser/NALParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAGvC,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAE9D,qBAAa,SAAS;IACpB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE;CAkDnC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,2 @@
+export { NALParser, NAL_TYPES, type NALType } from './NALParser';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAA"}

package/dist/player/BasePlayer.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 播放器基类
+ *
+ * 提供播放器的公共功能：
+ * - 解码器初始化
+ * - 渲染循环
+ * - 状态管理
+ * - 工具方法
+ */
+import { WASMLoader } from '../decoder/WASMLoader';
+import { H264Decoder } from '../decoder/H264Decoder';
+import { Canvas2DRenderer } from '../renderer/Canvas2DRenderer';
+import type { PlayerState, PlayerCallbacks, VideoFrame } from '../types';
+export interface PlayerConfig {
+    /** WASM 文件路径 */
+    wasmPath?: string;
+    /** 帧缓冲区目标大小 - 控制缓冲的最大帧数 */
+    targetBufferSize?: number;
+    /** 每批解码帧数 - 批量解码后再让出主线程 */
+    decodeBatchSize?: number;
+    /** NAL/Sample 队列上限 - 超过则暂停下载 */
+    maxQueueSize?: number;
+    /** 是否为直播流 - 直播流会持续下载数据 */
+    isLive?: boolean;
+}
+export declare const DEFAULT_PLAYER_CONFIG: Required<PlayerConfig>;
+export declare abstract class BasePlayer<Config extends PlayerConfig = PlayerConfig> {
+    protected config: Required<Config>;
+    protected callbacks: PlayerCallbacks;
+    protected wasmLoader: WASMLoader;
+    protected decoder: H264Decoder | null;
+    protected renderer: Canvas2DRenderer | null;
+    protected decoderInitialized: boolean;
+    protected isPlaying: boolean;
+    protected frameTimer: number | null;
+    protected frameBuffer: VideoFrame[];
+    protected droppedFrames: number;
+    protected decodeLoopAbort: boolean;
+    protected _currentTime: number;
+    protected _duration: number;
+    protected state: PlayerState;
+    constructor(config: Config, callbacks: PlayerCallbacks, defaults: Required<Config>);
+    /**
+     * 加载视频源
+     */
+    abstract load(url: string): Promise<void>;
+    /**
+     * 解码循环
+     */
+    protected abstract decodeLoop(): Promise<void>;
+    /**
+     * 跳转到指定时间
+     * @param time 目标时间（毫秒）
+     */
+    abstract seek(time: number): Promise<void>;
+    /**
+     * 设置渲染器
+     */
+    setRenderer(renderer: Canvas2DRenderer): void;
+    /**
+     * 初始化解码器
+     */
+    initDecoder(): Promise<void>;
+    /**
+     * 开始播放
+     */
+    play(): Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 销毁播放器，释放资源
+     */
+    destroy(): void;
+    /**
+     * 获取播放状态
+     */
+    getState(): PlayerState;
+    /**
+     * 获取当前播放时间（毫秒）
+     */
+    getCurrentTime(): number;
+    /**
+     * 获取总时长（毫秒）
+     */
+    getDuration(): number;
+    /**
+     * 设置当前时间（供子类调用）
+     */
+    protected setCurrentTime(time: number): void;
+    /**
+     * 设置总时长（供子类调用）
+     */
+    protected setDuration(duration: number): void;
+    /**
+     * 更新状态
+     */
+    protected updateState(partial: Partial<PlayerState>): void;
+    /**
+     * 快速让出主线程
+     */
+    protected yieldFast(): Promise<void>;
+    /**
+     * 休眠
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * 重置播放器状态
+     */
+    protected resetState(): void;
+    /**
+     * 渲染循环
+     * 子类可以覆盖此方法以实现自定义渲染逻辑
+     */
+    protected renderLoop: () => void;
+}
+//# sourceMappingURL=BasePlayer.d.ts.map

package/dist/player/BasePlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlayer.d.ts","sourceRoot":"","sources":["../../src/player/BasePlayer.ts"],"names":[],"mappings":"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"}

package/dist/player/EcPlayerCore.d.ts

@@ -0,0 +1,77 @@
+/**
+ * EcPlayerCore 统一播放器入口
+ *
+ * 自动检测视频格式（HLS/FLV/MP4），创建对应的播放器实例
+ * 提供统一的 API，简化使用
+ */
+import { BasePlayer, type PlayerConfig } from './BasePlayer';
+import { type StreamFormat } from '../demuxer/FormatDetector';
+import type { PlayerState, PlayerCallbacks } from '../types';
+export interface EcPlayerCoreConfig extends PlayerConfig {
+    /** Canvas 元素，用于渲染视频 */
+    canvas?: HTMLCanvasElement;
+}
+export interface PlayOptions {
+    /** 视频 URL（不传则继续播放当前视频） */
+    url?: string;
+    /** 是否为直播流 */
+    isLive?: boolean;
+}
+export declare class EcPlayerCore {
+    private player;
+    private config;
+    private callbacks;
+    private detectedFormat;
+    private pendingRenderer;
+    private renderer;
+    constructor(config?: EcPlayerCoreConfig, callbacks?: PlayerCallbacks);
+    /**
+     * 加载视频（自动检测格式、初始化解码器）
+     * @param url 视频 URL
+     * @param isLive 是否为直播流（直播流会持续下载数据）
+     */
+    load(url: string, isLive?: boolean): Promise<void>;
+    /**
+     * 根据格式创建播放器
+     */
+    private createPlayer;
+    /**
+     * 播放视频
+     * @param options 播放参数
+     */
+    play(options?: PlayOptions): Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 跳转到指定时间
+     */
+    seek(time: number): Promise<void>;
+    /**
+     * 获取当前播放时间（毫秒）
+     */
+    getCurrentTime(): number;
+    /**
+     * 获取总时长（毫秒）
+     */
+    getDuration(): number;
+    /**
+     * 获取播放状态
+     */
+    getState(): PlayerState;
+    /**
+     * 获取检测到的格式
+     */
+    getDetectedFormat(): StreamFormat;
+    /**
+     * 销毁播放器，释放资源
+     */
+    destroy(): void;
+    /**
+     * 获取内部播放器实例
+     * 用于需要访问特定播放器功能的场景
+     */
+    getPlayer(): BasePlayer | null;
+}
+//# sourceMappingURL=EcPlayerCore.d.ts.map

package/dist/player/EcPlayerCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EcPlayerCore.d.ts","sourceRoot":"","sources":["../../src/player/EcPlayerCore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAyB,MAAM,cAAc,CAAA;AAGnF,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG5D,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,uBAAuB;IACvB,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAGD,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,MAAM,GAAE,kBAAuB,EAAE,SAAS,GAAE,eAAoB;IAW5E;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCxD;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,QAAQ,IAAI,WAAW;IAsBvB;;OAEG;IACH,iBAAiB,IAAI,YAAY;IAIjC;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf;;;OAGG;IACH,SAAS,IAAI,UAAU,GAAG,IAAI;CAG/B"}

package/dist/player/FLVPlayer.d.ts

@@ -0,0 +1,134 @@
+/**
+ * FLV 播放器
+ *
+ * 支持 FLV 文件播放，基于时间戳控制播放速度
+ * 支持 H.264 (AVC) 和 H.265 (HEVC) 编码
+ *
+ * 使用 StreamPrefetcher 预取抽象层
+ */
+import { BasePlayer } from './BasePlayer';
+import type { FLVPlayerConfig, FLVVideoTag } from '../types';
+interface QueuedVideoTag {
+    tag: FLVVideoTag;
+    annexBData: Uint8Array;
+}
+export declare class FLVPlayer extends BasePlayer<FLVPlayerConfig> {
+    private flvDemuxer;
+    private h264Decoder;
+    private hevcDecoder;
+    private isPrefetching;
+    private currentUrl;
+    private _currentCodecId;
+    private _timedFrameBuffer;
+    private _videoTagQueue;
+    private playStartTime;
+    private firstFrameDts;
+    private lastRenderTime;
+    private decodeFailCount;
+    private dynamicMinBufferSize;
+    private dynamicTargetBufferSize;
+    private videoWidth;
+    private videoHeight;
+    private prefetcher;
+    private liveReader;
+    private liveDownloadAbort;
+    private _lastQueuedTimestamp;
+    private _currentDownloadSpeed;
+    get videoTagQueue(): QueuedVideoTag[];
+    get currentCodecId(): number;
+    get lastQueuedTimestamp(): number;
+    constructor(config?: FLVPlayerConfig, callbacks?: import('../types').PlayerCallbacks);
+    /**
+     * 加载 FLV 文件
+     */
+    load(url: string): Promise<void>;
+    /**
+     * 初始化解码器（覆盖基类方法，支持 AVC 和 HEVC）
+     */
+    initDecoder(): Promise<void>;
+    /**
+     * 根据视频分辨率动态调整缓冲参数
+     */
+    private adjustBufferForResolution;
+    /**
+     * 开始播放（覆盖基类方法）
+     */
+    play(): Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 处理预取缓冲区数据（供预取器调用）
+     */
+    processPrefetchBuffer(data: Uint8Array): {
+        hasNewData: boolean;
+        processedBytes: number;
+    };
+    /**
+     * 跳转到指定时间
+     */
+    seek(time: number): Promise<void>;
+    /**
+     * 解码循环
+     */
+    protected decodeLoop(): Promise<void>;
+    /**
+     * 流式加载 FLV 文件
+     */
+    private loadFLV;
+    /**
+     * 初始化预取器
+     */
+    private initPrefetcher;
+    /**
+     * 停止直播流下载
+     */
+    private stopLiveDownload;
+    /**
+     * 解析 FLV 数据并入队
+     */
+    private parseAndQueueFLV;
+    /**
+     * 从 AVC 配置初始化解码器
+     */
+    private initDecoderFromAVCConfig;
+    /**
+     * 从 HEVC 配置初始化解码器
+     */
+    private initDecoderFromHEVCConfig;
+    /**
+     * 解码 Video Tag
+     */
+    private decodeVideoTag;
+    /**
+     * 尝试从 Annex B 数据中初始化解码器
+     */
+    private tryInitFromData;
+    /**
+     * 从数据中初始化 AVC 解码器
+     */
+    private tryInitAVCFromData;
+    /**
+     * 从数据中初始化 HEVC 解码器
+     */
+    private tryInitHEVCFromData;
+    private renderedFrames;
+    private lastRenderLogTime;
+    private consecutiveEmptyBuffer;
+    private lastRenderedDts;
+    private pausedTime;
+    private bufferEmptyStartTime;
+    private playStartTimeOffset;
+    private resyncCount;
+    /**
+     * 渲染循环
+     */
+    protected renderLoop: () => void;
+    /**
+     * 渲染一帧
+     */
+    private renderFrame;
+}
+export {};
+//# sourceMappingURL=FLVPlayer.d.ts.map

package/dist/player/FLVPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FLVPlayer.d.ts","sourceRoot":"","sources":["../../src/player/FLVPlayer.ts"],"names":[],"mappings":"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"}

package/dist/player/HLSPlayer.d.ts

@@ -0,0 +1,99 @@
+/**
+ * HLS 播放器
+ *
+ * 支持 HLS TS 和 fMP4 格式
+ */
+import { type VideoSample } from '../demuxer/fMP4Demuxer';
+import { BasePlayer } from './BasePlayer';
+import type { HLSPlayerConfig, NALUnit } from '../types';
+interface QueuedNAL {
+    nalUnit: NALUnit;
+    pts: number;
+}
+interface QueuedSample {
+    sample: VideoSample;
+}
+export declare class HLSPlayer extends BasePlayer<HLSPlayerConfig> {
+    private tsDemuxer;
+    private pesExtractor;
+    private nalParser;
+    private fmp4Demuxer;
+    private isPrefetching;
+    private currentSegmentIndex;
+    private segments;
+    private fmp4Segments;
+    private initSegment;
+    private _isFMP4;
+    private currentPlaylistUrl;
+    private _nalQueue;
+    private _sampleQueue;
+    private prefetcher;
+    get isFMP4(): boolean;
+    get nalQueue(): QueuedNAL[];
+    get sampleQueue(): QueuedSample[];
+    constructor(config?: HLSPlayerConfig, callbacks?: import('../types').PlayerCallbacks);
+    /**
+     * 加载 HLS 播放列表
+     */
+    load(url: string): Promise<void>;
+    /**
+     * 初始化解码器（覆盖基类方法，添加 fMP4 支持）
+     */
+    initDecoder(): Promise<void>;
+    /**
+     * 开始播放（覆盖基类方法，使用自定义渲染循环）
+     */
+    play(): Promise<void>;
+    /**
+     * 跳转到指定时间
+     */
+    seek(time: number): Promise<void>;
+    /**
+     * 解码循环
+     */
+    protected decodeLoop(): Promise<void>;
+    /**
+     * 初始化预取器
+     */
+    private initPrefetcher;
+    /**
+     * 解析 fMP4 数据
+     */
+    parseFMP4Data(data: Uint8Array): number;
+    /**
+     * 解析 TS 数据
+     */
+    parseTSData(tsData: Uint8Array): number;
+    /**
+     * 加载 fMP4 初始化段
+     */
+    private loadInitSegment;
+    /**
+     * 从 avcC 初始化解码器
+     */
+    private initDecoderFromAvcC;
+    /**
+     * 解析 HLS 播放列表
+     */
+    private parsePlaylist;
+    /**
+     * 同步初始化解码器参数（SPS/PPS）- TS 流
+     */
+    private initDecoderParamsSync;
+    private readBoxSize;
+    private readBoxType;
+    /**
+     * 解码 fMP4 sample
+     */
+    private decodeSample;
+    /**
+     * 解码单个 NAL 单元
+     */
+    private decodeNAL;
+    /**
+     * 渲染循环
+     */
+    protected renderLoop: () => void;
+}
+export {};
+//# sourceMappingURL=HLSPlayer.d.ts.map

package/dist/player/HLSPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HLSPlayer.d.ts","sourceRoot":"","sources":["../../src/player/HLSPlayer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEtE,OAAO,EAAE,UAAU,EAAyB,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAc,OAAO,EAAE,MAAM,UAAU,CAAA;AAkCpE,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAGD,UAAU,YAAY;IACpB,MAAM,EAAE,WAAW,CAAA;CACpB;AAoFD,qBAAa,SAAU,SAAQ,UAAU,CAAC,eAAe,CAAC;IAExD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAoB;IAGvC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,kBAAkB,CAAK;IAG/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,UAAU,CAAoC;IAGtD,IAAI,MAAM,IAAI,OAAO,CAAwB;IAC7C,IAAI,QAAQ,IAAI,SAAS,EAAE,CAA0B;IACrD,IAAI,WAAW,IAAI,YAAY,EAAE,CAA6B;gBAElD,MAAM,GAAE,eAAoB,EAAE,SAAS,GAAE,OAAO,UAAU,EAAE,eAAoB;IAI5F;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDtC;;OAEG;IACY,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C;;OAEG;IACY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBpC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvC;;OAEG;cACsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmEpD;;OAEG;IACH,OAAO,CAAC,cAAc;IAqCtB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAqCvC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAyBvC;;OAEG;YACW,eAAe;IAmC7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;YACW,aAAa;IA0F3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgFpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACH,UAAmB,UAAU,QAAO,IAAI,CA+BvC;CACF"}

package/dist/player/index.d.ts

@@ -0,0 +1,3 @@
+export { EcPlayerCore, type EcPlayerCoreConfig, type PlayOptions } from './EcPlayerCore';
+export { BasePlayer, type PlayerConfig, DEFAULT_PLAYER_CONFIG } from './BasePlayer';
+//# sourceMappingURL=index.d.ts.map

package/dist/player/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGxF,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

package/dist/prefetch/BasePrefetcher.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 预取器抽象基类
+ *
+ * 提供通用的预取循环控制、水位检查、动态间隔、速度监控和状态管理
+ */
+import type { PrefetcherConfig, PrefetcherStatus, PrefetcherCallbacks } from './types';
+/**
+ * 预取器抽象基类
+ *
+ * 子类需要实现：
+ * - getQueueSize(): 获取当前队列大小
+ * - shouldPrefetch(): 判断是否需要预取
+ * - doPrefetch(): 执行实际的预取操作
+ * - doReset(): 重置状态
+ */
+export declare abstract class BasePrefetcher<TConfig extends PrefetcherConfig = PrefetcherConfig, TStatus extends PrefetcherStatus = PrefetcherStatus> {
+    protected config: TConfig;
+    protected callbacks: PrefetcherCallbacks;
+    protected status: TStatus;
+    protected isRunning: boolean;
+    protected abortFlag: boolean;
+    protected prefetchPromise: Promise<void> | null;
+    protected downloadStartTime: number;
+    protected downloadStartBytes: number;
+    protected lastSpeedLogTime: number;
+    protected lastSpeedLogBytes: number;
+    protected currentSpeed: number;
+    protected loopCount: number;
+    constructor(config: TConfig, callbacks?: PrefetcherCallbacks);
+    /**
+     * 创建初始状态（子类可覆盖）
+     */
+    protected createInitialState(): TStatus;
+    /**
+     * 启动预取循环
+     */
+    start(): Promise<void>;
+    /**
+     * 停止预取循环
+     */
+    stop(): void;
+    /**
+     * 获取当前状态
+     */
+    getStatus(): TStatus;
+    /**
+     * 获取下载速度 (KB/s)
+     */
+    getDownloadSpeed(): number;
+    /**
+     * 预取循环
+     */
+    protected prefetchLoop(): Promise<void>;
+    /**
+     * 计算动态等待间隔
+     */
+    protected calculateInterval(queueSize: number): number;
+    /**
+     * 更新下载速度
+     */
+    protected updateDownloadSpeed(totalBytes: number): void;
+    /**
+     * 初始化速度监控
+     */
+    protected initSpeedMonitor(initialBytes: number): void;
+    /**
+     * 更新状态（子类可覆盖以支持扩展属性）
+     */
+    protected updateStatus(partial: Record<string, unknown>): void;
+    /**
+     * 辅助方法：休眠
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * 辅助方法：快速让出（用于不阻塞事件循环）
+     */
+    protected yieldFast(): Promise<void>;
+    /**
+     * 重置预取器状态
+     */
+    reset(): void;
+    /**
+     * 获取当前队列大小
+     */
+    abstract getQueueSize(): number;
+    /**
+     * 判断是否应该预取
+     */
+    abstract shouldPrefetch(): boolean;
+    /**
+     * 执行预取操作
+     */
+    abstract doPrefetch(): Promise<void>;
+    /**
+     * 重置状态（子类实现）
+     */
+    abstract doReset(): void;
+}
+//# sourceMappingURL=BasePrefetcher.d.ts.map

package/dist/prefetch/BasePrefetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePrefetcher.d.ts","sourceRoot":"","sources":["../../src/prefetch/BasePrefetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EAEpB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AACH,8BAAsB,cAAc,CAClC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAA;IACxC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,SAAS,UAAQ;IAC3B,SAAS,CAAC,SAAS,UAAQ;IAC3B,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAO;IAGtD,SAAS,CAAC,iBAAiB,SAAI;IAC/B,SAAS,CAAC,kBAAkB,SAAI;IAChC,SAAS,CAAC,gBAAgB,SAAI;IAC9B,SAAS,CAAC,iBAAiB,SAAI;IAC/B,SAAS,CAAC,YAAY,SAAI;IAG1B,SAAS,CAAC,SAAS,SAAI;gBAGrB,MAAM,EAAE,OAAO,EACf,SAAS,GAAE,mBAAwB;IAOrC;;OAEG;IACH,SAAS,CAAC,kBAAkB,IAAI,OAAO;IASvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC7C;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAkBtD;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAoBvD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAOtD;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK9D;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C;;OAEG;cACa,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,QAAQ,CAAC,YAAY,IAAI,MAAM;IAE/B;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,OAAO;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;CACzB"}