import type { M3u8ContainerType, M3u8DLOptions, M3u8Info, TsItemInfo } from '../types/m3u8'; /** 合并上下文 */ export interface MergeContext { /** 下载选项 */ options: M3u8DLOptions; /** m3u8 解析结果 */ m3u8Info: M3u8Info; /** 已下载且存在的本地分片文件列表,按播放顺序排列 */ files: string[]; /** 最终输出文件路径 */ filepath: string; /** ffmpeg 可执行文件路径 */ ffmpegBin: string; /** ffmpeg 是否可用 */ ffmpegSupport: boolean; /** 分片缓存目录,可用于存放中间产物 */ cacheDir: string; /** 语言环境(由 m3u8Convert 统一解析),用于合并器内的 i18n 文案 */ lang: string; } /** * 合并器(策略)接口。 * * 不同容器类型的分片,其合并方式完全不同: * - MPEG-TS:可由 ffmpeg `concat` 解复用器直接拼接 * - fMP4(m4s):必须先拼接 `EXT-X-MAP` 初始化段(ftyp+moov),否则无法解码 * * 新增一种容器类型的支持时,只需实现并注册一个新的 `Merger`,无需改动主流程。 */ export interface Merger { /** 合并器名称,唯一标识 */ name: string; /** 适用的容器类型。`*` 表示适用于所有类型(一般用于兜底) */ container: M3u8ContainerType | '*'; /** 优先级,数值越大越优先。默认 0 */ priority?: number; /** 当前场景是否可由该合并器处理 */ support(ctx: MergeContext): boolean; /** 执行合并。成功返回生成的文件路径,失败返回空字符串 */ merge(ctx: MergeContext): Promise; } /** 执行 ffmpeg 命令(异步,避免阻塞事件循环导致服务端并发任务的进度推送停滞) */ export declare function execFfmpeg(cmd: string, ffmpegBin: string): Promise<{ error: Error; stdout: string; stderr: string; }>; /** * fMP4(m4s) 合并器。 * * fMP4 分片的 `ftyp` + `moov` 位于 `EXT-X-MAP` 初始化段中, * 因此必须先将初始化段与全部分片顺序拼接,得到一个 fragmented MP4, * 再使用 ffmpeg 重新封装(remux)为标准的、支持边下边播(faststart)的 mp4。 * 无 ffmpeg 时,拼接产物本身即为可播放的 mp4。 */ export declare const fmp4Merger: Merger; /** MPEG-TS 合并器。依赖 ffmpeg 的 `concat` 解复用器 */ export declare const tsMerger: Merger; /** 兜底合并器:纯二进制拼接,不依赖 ffmpeg */ export declare const binaryMerger: Merger; /** * 注册(或替换)一个合并器,用于扩展对新容器类型的支持。 * 按 `priority` 降序排列,高优先级优先尝试 */ export declare function registerMerger(merger: Merger): Merger[]; /** 获取已注册的合并器列表 */ export declare function getMergers(): Merger[]; /** * 将已下载的分片合并转换为可播放的视频文件。 * * 依据分片容器类型自动选择合并策略: * - `fmp4`:初始化段 + 分片拼接后重新封装为 mp4(无 ffmpeg 时直接输出拼接产物) * - `ts`:ffmpeg concat 解复用器封装为 mp4(无 ffmpeg 时二进制拼接为 ts) */ export declare function m3u8Convert(options: M3u8DLOptions, m3u8Info: M3u8Info | TsItemInfo[]): Promise;