@flow-player/test-streams 0.14.2 → 0.15.1

package/dist/fixtures/window.d.ts

@@ -0,0 +1,110 @@
+import type { CodecId } from "../config.js";
+/** drawtext 不可用时的兜底字体占位（仅用于离线单测断言子串，真实生成时按需替换）。 */
+export declare const DEFAULT_DRAWTEXT_FONT = "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
+/** 生成期按序探测的本机字体候选（macOS 优先，Linux 次之）。 */
+export declare const DRAWTEXT_FONT_CANDIDATES: ReadonlyArray<string>;
+/** GOP 形态：short（1s）/ long（≥4s）/ single（整段单个 GOP）。 */
+export type GopMode = "short" | "long" | "single";
+/** 双段关系：gap（两段之间留空洞）/ overlap（两段时间重叠）/ sizeSwitch（同起点不同尺寸）。 */
+export type WindowPairKind = "gap" | "overlap" | "sizeSwitch";
+/** 单条烧录窗 fixture 的静态规格（纯数据，可序列化进文档与 manifest）。 */
+export type WindowFixtureSpec = {
+    /** 短横线 id，同时是输出文件名（window/<id>.mp4）与 manifest 主键。 */
+    id: string;
+    /** 视频编码。 */
+    codec: CodecId;
+    /** 画面宽高。 */
+    width: number;
+    /** 画面宽高。 */
+    height: number;
+    /** 输入源帧率；sparse 为 true 时输出侧再经 fps=1 抽稀。 */
+    fps: number;
+    /** 单段时长（秒）。 */
+    durationSeconds: number;
+    /** GOP 长度（帧数），single 模式下等于 durationSeconds × fps。 */
+    gopFrames: number;
+    /** GOP 形态。 */
+    gopMode: GopMode;
+    /** B 帧数；0 表示无 B 帧（-bf 0）。 */
+    bframes: number;
+    /** 首 PTS 偏移（秒），经 -output_ts_offset 实现；非零值覆盖窗口偏移场景。 */
+    startPtsSeconds: number;
+    /** 是否 1fps 稀疏输出。 */
+    sparse: boolean;
+    /** 恒为 true：关闭 faststart，moov 落尾部。 */
+    moovTrailing: true;
+    /** 是否考察尾部 delayed 帧（B 帧编码器回吐延迟）。 */
+    delayedTail: boolean;
+    /** 所属双段组；单段 fixture 为 undefined。 */
+    pairKind?: WindowPairKind;
+    /** 双段组内角色：a（首段）/ b（次段）。 */
+    pairRole?: "a" | "b";
+    /** P3 窗口测试中的用途（中文）。 */
+    usageP3: string;
+    /** P5 容量测试中的用途（中文）。 */
+    usageP5: string;
+};
+/** manifest.windowFixtures 条目携带的编码参数（随 size/sha256 一起落盘）。 */
+export type WindowEncodeParams = {
+    /** 视频编码。 */
+    codec: CodecId;
+    /** GOP 长度（帧数）。 */
+    gopFrames: number;
+    /** GOP 形态。 */
+    gopMode: GopMode;
+    /** B 帧数；0 表示无 B 帧。 */
+    bframes: number;
+    /** 首 PTS 偏移（秒）。 */
+    startPtsSeconds: number;
+    /** 是否 1fps 稀疏。 */
+    sparse: boolean;
+    /** moov 位置；恒为 trailing（关闭 faststart）。 */
+    moov: "trailing";
+    /** 是否考察尾部 delayed 帧。 */
+    delayedTail: boolean;
+    /** 画面宽度。 */
+    width: number;
+    /** 画面高度。 */
+    height: number;
+    /** 输出帧率（稀疏段为 1）。 */
+    fps: number;
+};
+/** 单条烧录窗的生成计划：目标路径 + 一次 ffmpeg 调用的全部输出侧参数。 */
+export type WindowFixturePlan = {
+    /** 与 spec.id 一致。 */
+    id: string;
+    /** 源规格。 */
+    spec: WindowFixtureSpec;
+    /** 相对 fixtureDir 的主文件路径（window/<id>.mp4）。 */
+    mainFile: string;
+    /** 预期输出文件（单文件，仅主文件）。 */
+    files: ReadonlyArray<string>;
+    /** 传给 ffmpeg 的输出侧参数（不含最后的输出文件名）。 */
+    ffmpegOutputArgs: ReadonlyArray<string>;
+    /** 写入 manifest 的编码参数。 */
+    encode: WindowEncodeParams;
+};
+/** 烧录窗输出目录（相对 fixtureDir）。 */
+export declare const WINDOW_CONTAINER_DIR = "window";
+/** P3-H 烧录窗全量规格（16 段，全部 MP4 单文件）。 */
+export declare const WINDOW_SPECS: ReadonlyArray<WindowFixtureSpec>;
+/**
+ * 拼 drawtext 烧录滤镜：画面左上烧录帧号与媒体时间
+ *（`n=<frame_num> t=<hms>`，白字黑底），供视觉核对。
+ */
+export declare function drawtextFilter(fontfile: string): string;
+/**
+ * 为单条烧录窗规格构建 ffmpeg 生成计划。视频源为 testsrc2（自带运动测试图），
+ * 音频源为正弦波；输出 MP4 关闭 faststart（moov 落尾）。
+ * @param useDrawtext 是否追加 drawtext 烧录（本机 ffmpeg 缺滤镜时传 false 降级）。
+ * @param fontfile drawtext 字体路径；useDrawtext 为 false 时忽略。
+ */
+export declare function buildWindowPlan(spec: WindowFixtureSpec, opts?: {
+    useDrawtext?: boolean;
+    fontfile?: string;
+}): WindowFixturePlan;
+/** 展开烧录窗全量计划（WINDOW_SPECS 顺序，供 generateFixtures 顺序执行）。 */
+export declare function expandWindowMatrix(opts?: {
+    useDrawtext?: boolean;
+    fontfile?: string;
+}): ReadonlyArray<WindowFixturePlan>;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { buildPlan, expandMatrix, VOD_SAMPLE_RELATIVE, type FixturePlan, } from "./fixtures/matrix.js";
-export { loadManifest, lookupFixture, summarizeCatalog, verifyEntryOnDisk, type CatalogSummary, type FixtureLookup, type Manifest, type ManifestEntry, type ManifestItem, } from "./fixtures/catalog.js";
+export { loadManifest, lookupFixture, summarizeCatalog, verifyEntryOnDisk, type CatalogSummary, type FixtureLookup, type Manifest, type ManifestEntry, type ManifestItem, type WindowManifestItem, } from "./fixtures/catalog.js";
+export { buildWindowPlan, drawtextFilter, expandWindowMatrix, DRAWTEXT_FONT_CANDIDATES, DEFAULT_DRAWTEXT_FONT, WINDOW_CONTAINER_DIR, WINDOW_SPECS, type GopMode, type WindowEncodeParams, type WindowFixturePlan, type WindowFixtureSpec, type WindowPairKind, } from "./fixtures/window.js";
 export { CODEC_SPEC, type CodecSpec } from "./fixtures/codec.js";
 export { layoutFor, containerRelativeDir, containerRelativePath, type FormatLayout, } from "./fixtures/format.js";
 export { ALL_CODECS, ALL_FORMATS, DEFAULT_DURATION_SECONDS, DEFAULT_FIXTURE_DIR, DEFAULT_HLS_SEGMENT_SECONDS, DEFAULT_HOST, DEFAULT_PORT, type CodecId, type FormatId, type GenerateOptions, type ServeOptions, } from "./config.js";