@flow-player/test-streams 0.14.1 → 0.15.0

package/dist/index.js

@@ -224,6 +224,7 @@ function summarizeCatalog(fixtureDir) {
   }
   let total = 0;
   for (const item of manifest.fixtures) total += item.entries.length;
+  for (const item of manifest.windowFixtures ?? []) total += item.entries.length;
   return {
     codecs: ALL_CODECS,
     formats: ALL_FORMATS,
@@ -247,6 +248,375 @@ function verifyEntryOnDisk(fixtureDir, entry) {
   return { ok: true, size };
 }
 
+// src/fixtures/window.ts
+import { join as join3 } from "node:path";
+var DEFAULT_DRAWTEXT_FONT = "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
+var DRAWTEXT_FONT_CANDIDATES = [
+  "/System/Library/Fonts/Supplemental/Verdana.ttf",
+  "/System/Library/Fonts/Hiragino Sans GB.ttc",
+  "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+  "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf"
+];
+var WINDOW_CONTAINER_DIR = "window";
+var WINDOW_SPECS = [
+  {
+    id: "h264-shortgop-bframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 3,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u77ED GOP \u6709 B \u5E27\u57FA\u7EBF\uFF1A\u7A97\u53E3\u9010 GOP \u524D\u8FDB\u65F6\u7684\u89E3\u7801\u8D77\u70B9\u5BF9\u9F50",
+    usageP5: "\u591A\u8DEF\u5E76\u53D1\u4E0B\u7684\u5E38\u89C4\u89E3\u7801\u8D1F\u8F7D\u57FA\u7EBF"
+  },
+  {
+    id: "h264-shortgop-nobframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "\u65E0 B \u5E27\u5BF9\u7167\uFF1A\u5E27\u8F93\u51FA\u65E0\u91CD\u6392\u5EF6\u8FDF\uFF0C\u6821\u9A8C PTS \u5355\u8C03\u6027",
+    usageP5: "\u4F4E\u5EF6\u8FDF\u94FE\u8DEF\u7684\u5BB9\u91CF\u5BF9\u7167\u7EC4"
+  },
+  {
+    id: "hevc-shortgop-bframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 3,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u77ED GOP \u6709 B \u5E27\u57FA\u7EBF\uFF1Ahvc1 \u5C01\u88C5\u4E0B\u7A97\u53E3\u63A8\u8FDB",
+    usageP5: "HEVC \u8F6F\u89E3 / \u786C\u89E3\u5BB9\u91CF\u57FA\u7EBF"
+  },
+  {
+    id: "hevc-shortgop-nobframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "HEVC \u65E0 B \u5E27\u5BF9\u7167\uFF1A\u91CD\u6392\u5173\u95ED\u65F6\u7684\u7A97\u53E3\u884C\u4E3A",
+    usageP5: "HEVC \u4F4E\u5EF6\u8FDF\u5BB9\u91CF\u5BF9\u7167\u7EC4"
+  },
+  {
+    id: "h264-longgop-bframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 10,
+    gopFrames: 125,
+    gopMode: "long",
+    bframes: 3,
+    startPtsSeconds: 10,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u957F GOP\uFF085s\uFF09\u8DE8\u7A97 seek\uFF1A\u7A97\u53E3\u843D\u5728 GOP \u4E2D\u90E8\u65F6\u7684\u56DE\u8DF3\u8DDD\u79BB",
+    usageP5: "\u957F GOP \u4F4E\u7801\u7387\u6863\u7684\u89E3\u7801\u5BB9\u91CF"
+  },
+  {
+    id: "hevc-longgop-bframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 10,
+    gopFrames: 125,
+    gopMode: "long",
+    bframes: 3,
+    startPtsSeconds: 10,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u957F GOP \u8DE8\u7A97 seek \u5BF9\u7167",
+    usageP5: "HEVC \u957F GOP \u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-singlegop",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 8,
+    gopFrames: 200,
+    gopMode: "single",
+    bframes: 3,
+    startPtsSeconds: 20,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u5355 GOP \u6781\u9650\uFF1A\u7A97\u53E3\u4EFB\u610F\u70B9 seek \u5FC5\u987B\u56DE\u8DF3\u5230\u6BB5\u9996 IDR",
+    usageP5: "\u5355 GOP \u6781\u4F4E\u7801\u7387\u6863\u5BB9\u91CF"
+  },
+  {
+    id: "hevc-singlegop",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 8,
+    gopFrames: 200,
+    gopMode: "single",
+    bframes: 3,
+    startPtsSeconds: 20,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u5355 GOP \u6781\u9650\u5BF9\u7167",
+    usageP5: "HEVC \u5355 GOP \u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-sparse-1fps",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 1,
+    durationSeconds: 8,
+    gopFrames: 4,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 30,
+    sparse: true,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "1fps \u7A00\u758F\u6D41\uFF1A\u7A97\u53E3\u6309\u79D2\u6B65\u8FDB\u65F6\u7684\u5E27\u53F7 / \u5A92\u4F53\u65F6\u95F4\u5BF9\u5E94",
+    usageP5: "\u7A00\u758F\u6D41\u6781\u4F4E\u5E27\u7387\u5BB9\u91CF\uFF08\u7F29\u7565\u56FE\u5F0F\u62C9\u6D41\uFF09"
+  },
+  {
+    id: "hevc-sparse-1fps",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 1,
+    durationSeconds: 8,
+    gopFrames: 4,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 30,
+    sparse: true,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "HEVC 1fps \u7A00\u758F\u5BF9\u7167",
+    usageP5: "HEVC \u7A00\u758F\u6D41\u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-gap-a",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 100,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "gap",
+    pairRole: "a",
+    usageP3: "gap \u53CC\u6BB5\u9996\u6BB5\uFF1A\u4E0E gap-b \u4E4B\u95F4\u7559 2s \u7A7A\u6D1E\uFF0C\u6D4B\u7A97\u53E3\u7A7A\u6D1E\u5C55\u793A",
+    usageP5: "\u65AD\u6D41\u7A7A\u6D1E\u573A\u666F\u7684\u5BB9\u91CF\u5360\u6BD4\u6A21\u578B\u8F93\u5165"
+  },
+  {
+    id: "h264-gap-b",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 108,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "gap",
+    pairRole: "b",
+    usageP3: "gap \u53CC\u6BB5\u6B21\u6BB5\uFF1A\u9996 PTS \u665A\u4E8E\u9996\u6BB5\u5C3E 2s\uFF0C\u7A97\u53E3\u5E94\u5448\u73B0\u7A7A\u6D1E",
+    usageP5: "\u540C gap-a \u914D\u5BF9\u4F7F\u7528"
+  },
+  {
+    id: "h264-overlap-a",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 200,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "overlap",
+    pairRole: "a",
+    usageP3: "overlap \u53CC\u6BB5\u9996\u6BB5\uFF1A\u4E0E overlap-b \u91CD\u53E0 2s\uFF0C\u6D4B\u7A97\u53E3\u53BB\u91CD",
+    usageP5: "\u91CD\u53E0\u5F55\u50CF\u573A\u666F\u7684\u5BB9\u91CF\u5360\u6BD4\u6A21\u578B\u8F93\u5165"
+  },
+  {
+    id: "h264-overlap-b",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 204,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "overlap",
+    pairRole: "b",
+    usageP3: "overlap \u53CC\u6BB5\u6B21\u6BB5\uFF1A\u9996 PTS \u65E9\u4E8E\u9996\u6BB5\u5C3E 2s\uFF0C\u7A97\u53E3\u5E94\u53BB\u91CD\u5408\u5E76",
+    usageP5: "\u540C overlap-a \u914D\u5BF9\u4F7F\u7528"
+  },
+  {
+    id: "h264-size-720p",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 300,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "sizeSwitch",
+    pairRole: "a",
+    usageP3: "\u5C3A\u5BF8\u5207\u6362\u9996\u6BB5\uFF08720p high\uFF09\uFF1A\u4E0E 360p \u6BB5\u540C\u8D77\u70B9\uFF0C\u6D4B\u7A97\u53E3\u5185\u5206\u8FA8\u7387\u5207\u6362",
+    usageP5: "\u6E05\u6670\u5EA6\u5207\u6362\u65F6\u7684\u77AC\u65F6\u89E3\u7801\u5CF0\u503C"
+  },
+  {
+    id: "h264-size-360p",
+    codec: "h264",
+    width: 640,
+    height: 360,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 300,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "sizeSwitch",
+    pairRole: "b",
+    usageP3: "\u5C3A\u5BF8\u5207\u6362\u6B21\u6BB5\uFF08360p baseline\uFF09\uFF1A\u7F16\u7801\u914D\u7F6E\u4E0E\u5206\u8FA8\u7387\u540C\u65F6\u53D8\u5316",
+    usageP5: "\u540C size-720p \u914D\u5BF9\u4F7F\u7528"
+  }
+];
+function drawtextFilter(fontfile) {
+  return `drawtext=fontfile=${fontfile}:text='n=%{frame_num} t=%{pts\\:hms}':fontsize=28:fontcolor=white:box=1:boxcolor=black@0.6:x=16:y=16`;
+}
+function buildWindowPlan(spec, opts) {
+  const useDrawtext = opts?.useDrawtext ?? true;
+  const fontfile = opts?.fontfile ?? DEFAULT_DRAWTEXT_FONT;
+  const specCodec = CODEC_SPEC[spec.codec];
+  const videoInput = `testsrc2=size=${spec.width}x${spec.height}:rate=${spec.fps}`;
+  const audioInput = `sine=frequency=1000:sample_rate=44100`;
+  const videoFilter = useDrawtext ? `format=yuv420p,${drawtextFilter(fontfile)}` : "format=yuv420p";
+  const outputFps = spec.sparse ? 1 : spec.fps;
+  const sizeSwitchBaseline = spec.pairKind === "sizeSwitch" && spec.pairRole === "b" ? ["-profile:v", "baseline"] : specCodec.videoArgs;
+  const ffmpegOutputArgs = [
+    "-y",
+    "-f",
+    "lavfi",
+    "-i",
+    videoInput,
+    "-f",
+    "lavfi",
+    "-i",
+    audioInput,
+    "-t",
+    String(spec.durationSeconds),
+    "-vf",
+    videoFilter,
+    "-r",
+    String(outputFps),
+    "-c:v",
+    specCodec.encoder,
+    ...sizeSwitchBaseline,
+    "-pix_fmt",
+    specCodec.pixelFormat,
+    "-bf",
+    String(spec.bframes),
+    "-g",
+    String(spec.gopFrames),
+    "-keyint_min",
+    String(spec.gopFrames),
+    "-sc_threshold",
+    "0",
+    ...containerExtraArgs("mp4", spec.codec),
+    "-c:a",
+    "aac",
+    "-b:a",
+    "128k",
+    "-output_ts_offset",
+    String(spec.startPtsSeconds),
+    "-f",
+    "mp4",
+    "-movflags",
+    "-faststart"
+  ];
+  const mainFile = join3(WINDOW_CONTAINER_DIR, `${spec.id}.mp4`);
+  const encode = {
+    codec: spec.codec,
+    gopFrames: spec.gopFrames,
+    gopMode: spec.gopMode,
+    bframes: spec.bframes,
+    startPtsSeconds: spec.startPtsSeconds,
+    sparse: spec.sparse,
+    moov: "trailing",
+    delayedTail: spec.delayedTail,
+    width: spec.width,
+    height: spec.height,
+    fps: outputFps
+  };
+  return { id: spec.id, spec, mainFile, files: [mainFile], ffmpegOutputArgs, encode };
+}
+function expandWindowMatrix(opts) {
+  return WINDOW_SPECS.map((spec) => buildWindowPlan(spec, opts));
+}
+
 // src/server/server.ts
 import { createReadStream, readFileSync as readFileSync3 } from "node:fs";
 import {
@@ -321,7 +691,7 @@ function setRangeHeaders(req, res, fullPath, mime) {
 
 // src/server/routes.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 var FORMAT_SET = Object.fromEntries(ALL_FORMATS.map((f) => [f, true]));
 var CODEC_SET = Object.fromEntries(ALL_CODECS.map((c) => [c, true]));
 var HLS_FMP4 = { hls: true, fmp4: true };
@@ -337,23 +707,23 @@ function resolveRoute(path) {
     if (HLS_FMP4[formatRaw]) return null;
     const format = formatRaw;
     const codec = codecRaw;
-    return join3(format, `${codec}.${format}`);
+    return join4(format, `${codec}.${format}`);
   }
   const playlist = PLAYLIST.exec(path);
   if (playlist) {
     const [, formatRaw, codecRaw, rest] = playlist;
     if (!FORMAT_SET[formatRaw] || !CODEC_SET[codecRaw]) return null;
-    return join3(formatRaw, codecRaw, rest);
+    return join4(formatRaw, codecRaw, rest);
   }
   const vod = VOD.exec(path);
   if (vod) {
     const [, name] = vod;
-    return join3("vod", name);
+    return join4("vod", name);
   }
   const vodHevc = VOD_HEVC.exec(path);
   if (vodHevc) {
     const [, name] = vodHevc;
-    return join3("vod-hevc", name);
+    return join4("vod-hevc", name);
   }
   return null;
 }
@@ -376,7 +746,7 @@ function handleList(res, manifest) {
   writeJson(res, 200, manifest);
 }
 function handleVodList(res, manifest, fixtureDir, codec = "h264") {
-  const vodListPath = codec === "hevc" ? join3(fixtureDir, "vod-hevc", "vod-list.json") : join3(fixtureDir, "vod", "vod-list.json");
+  const vodListPath = codec === "hevc" ? join4(fixtureDir, "vod-hevc", "vod-list.json") : join4(fixtureDir, "vod", "vod-list.json");
   if (existsSync2(vodListPath)) {
     try {
       const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
@@ -448,9 +818,15 @@ function parseChannelCount(raw) {
   if (!Number.isFinite(value) || value < 1) return MULTI_VOD_DEFAULT_CHANNELS;
   return Math.min(MULTI_VOD_MAX_CHANNELS, Math.floor(value));
 }
+function parseBoundedQueryInt(raw, min, max) {
+  if (raw == null || raw === "") return null;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < min || value > max) return null;
+  return value;
+}
 function handleVodListMulti(res, manifest, fixtureDir, channels) {
   const entriesSource = (() => {
-    const vodListPath = join3(fixtureDir, "vod", "vod-list.json");
+    const vodListPath = join4(fixtureDir, "vod", "vod-list.json");
     if (existsSync2(vodListPath)) {
       try {
         const raw = JSON.parse(readFileSync2(vodListPath, "utf8"));
@@ -745,7 +1121,13 @@ function createStreamsServer(options) {
       }
       const liveMatch = matchLivePath(path);
       if (liveMatch) {
-        handleLiveStream(req, res, liveMatch.format, liveMatch.codec);
+        const liveQuery = (req.url ?? "").split("?", 2)[1] ?? "";
+        const liveParams = new URLSearchParams(liveQuery);
+        handleLiveStream(req, res, liveMatch.format, liveMatch.codec, {
+          width: parseBoundedQueryInt(liveParams.get("width"), 160, 3840) ?? void 0,
+          height: parseBoundedQueryInt(liveParams.get("height"), 160, 3840) ?? void 0,
+          fps: parseBoundedQueryInt(liveParams.get("fps"), 1, 60) ?? void 0
+        });
         return;
       }
       writeNotFound(res);
@@ -832,7 +1214,7 @@ import {
   writeFileSync
 } from "node:fs";
 import { spawn as spawn2 } from "node:child_process";
-import { join as join4, resolve as resolve3 } from "node:path";
+import { join as join5, resolve as resolve3 } from "node:path";
 var FFMPEG_PROBE_ARGS = ["-version"];
 async function generateFixtures(opts = {}) {
   const ffmpegPath = opts.ffmpegPath ?? await findFfmpeg();
@@ -873,26 +1255,39 @@ async function generateFixtures(opts = {}) {
     }
   }
   copyVodSamples(fixtureDir);
+  let windowFixtures = [];
+  if (opts.includeWindow !== false) {
+    const windowResult = await generateWindowSet(
+      fixtureDir,
+      ffmpegPath,
+      opts.quiet ?? false,
+      opts.overwrite ?? false
+    );
+    windowFixtures = windowResult.items;
+    generated += windowResult.generated;
+    skipped += windowResult.skipped;
+  }
   const manifest = {
     version: 1,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     durationSeconds: duration,
-    fixtures: manifestItems
+    fixtures: manifestItems,
+    windowFixtures
   };
-  writeFileSync(join4(fixtureDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+  writeFileSync(join5(fixtureDir, "manifest.json"), JSON.stringify(manifest, null, 2));
   return { fixtureDir, manifest, generated, skipped, ffmpegPath, ffmpegMissing: false };
 }
 async function generateOne(plan, fixtureDir, ffmpegPath, quiet, overwrite) {
-  const outDir = join4(fixtureDir, plan.containerDir);
+  const outDir = join5(fixtureDir, plan.containerDir);
   mkdirSync(outDir, { recursive: true });
-  const outFile = join4(fixtureDir, plan.mainFile);
+  const outFile = join5(fixtureDir, plan.mainFile);
   if (!overwrite && existsSync3(outFile)) {
     return collectExisting(plan, fixtureDir);
   }
   if (plan.layout.isContainerDirectory) {
     for (const f of readdirSync(outDir)) {
       if (f === plan.layout.mainFileName) continue;
-      rmIfExists(join4(outDir, f));
+      rmIfExists(join5(outDir, f));
     }
   }
   const args = plan.ffmpegOutputArgs.concat([outFile]);
@@ -906,21 +1301,89 @@ async function generateOne(plan, fixtureDir, ffmpegPath, quiet, overwrite) {
   }
   return collectExisting(plan, fixtureDir);
 }
+async function generateWindowSet(fixtureDir, ffmpegPath, quiet, overwrite) {
+  const outDir = join5(fixtureDir, WINDOW_CONTAINER_DIR);
+  mkdirSync(outDir, { recursive: true });
+  const useDrawtext = await supportsDrawtext(ffmpegPath);
+  const fontfile = useDrawtext ? pickFontfile() : void 0;
+  if (!useDrawtext && !quiet) {
+    process.stdout.write(
+      "[generate] drawtext \u6EE4\u955C\u7F3A\u5931\uFF0C\u70E7\u5F55\u7A97\u964D\u7EA7\u4E3A\u88F8 testsrc2\uFF08\u65E0\u70E7\u5F55\u6587\u5B57\uFF0C\u7F16\u7801\u53C2\u6570\u4E0D\u53D8\uFF1B\u5B8C\u6574\u547D\u4EE4\u89C1 README P3-H \u4E00\u8282\uFF09\n"
+    );
+  }
+  const items = [];
+  let generated = 0;
+  let skipped = 0;
+  for (const spec of WINDOW_SPECS) {
+    const plan = buildWindowPlan(spec, { useDrawtext, fontfile });
+    const outFile = join5(fixtureDir, plan.mainFile);
+    if (!overwrite && existsSync3(outFile)) {
+      items.push(collectWindowExisting(plan, fixtureDir));
+      skipped += 1;
+      continue;
+    }
+    if (!quiet) {
+      process.stdout.write(`[generate] window/${plan.id} -> ${plan.mainFile}
+`);
+    }
+    const code = await runFfmpeg(ffmpegPath, plan.ffmpegOutputArgs.concat([outFile]), quiet);
+    if (code !== 0) {
+      throw new Error(`ffmpeg exited with code ${code} for window/${plan.id}`);
+    }
+    items.push(collectWindowExisting(plan, fixtureDir));
+    generated += 1;
+  }
+  return { items, generated, skipped };
+}
+function collectWindowExisting(plan, fixtureDir) {
+  const entries = [];
+  for (const rel of plan.files) {
+    const abs = join5(fixtureDir, rel);
+    if (!existsSync3(abs)) continue;
+    entries.push({ path: rel, size: statSync3(abs).size, sha256: hashFile(abs) });
+  }
+  return { id: plan.id, codec: plan.spec.codec, entries, encode: plan.encode };
+}
+async function supportsDrawtext(ffmpegPath) {
+  const { promise, resolve: resolve4 } = Promise.withResolvers();
+  const proc = spawn2(ffmpegPath, ["-hide_banner", "-filters"], {
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  let out = "";
+  proc.stdout?.on("data", (chunk) => {
+    out += chunk.toString("utf8");
+  });
+  proc.once("error", () => resolve4(false));
+  proc.once("exit", (code) => {
+    if (code !== 0) {
+      resolve4(false);
+      return;
+    }
+    resolve4(/^\s*\S{2,3}\s+drawtext\s/m.test(out));
+  });
+  return promise;
+}
+function pickFontfile() {
+  for (const candidate of DRAWTEXT_FONT_CANDIDATES) {
+    if (existsSync3(candidate)) return candidate;
+  }
+  return DRAWTEXT_FONT_CANDIDATES[0] ?? "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
+}
 function collectExisting(plan, fixtureDir) {
   const entries = [];
   for (const rel of plan.files) {
-    const abs = join4(fixtureDir, rel);
+    const abs = join5(fixtureDir, rel);
     if (!existsSync3(abs)) continue;
     entries.push({ path: rel, size: statSync3(abs).size, sha256: hashFile(abs) });
   }
   if (plan.layout.isContainerDirectory) {
-    const absDir = join4(fixtureDir, plan.containerDir);
+    const absDir = join5(fixtureDir, plan.containerDir);
     if (existsSync3(absDir)) {
       for (const name of readdirSync(absDir).sort()) {
         if (name === plan.layout.mainFileName) continue;
-        const rel = join4(plan.containerDir, name);
+        const rel = join5(plan.containerDir, name);
         if (entries.find((e) => e.path === rel)) continue;
-        const abs = join4(absDir, name);
+        const abs = join5(absDir, name);
         if (!statSync3(abs).isFile()) continue;
         entries.push({ path: rel, size: statSync3(abs).size, sha256: hashFile(abs) });
       }
@@ -929,12 +1392,12 @@ function collectExisting(plan, fixtureDir) {
   return { codec: plan.codec, format: plan.format, entries };
 }
 function copyVodSamples(fixtureDir) {
-  const src = join4(fixtureDir, VOD_SAMPLE_RELATIVE);
+  const src = join5(fixtureDir, VOD_SAMPLE_RELATIVE);
   if (!existsSync3(src)) return;
-  const vodDir = join4(fixtureDir, "vod");
+  const vodDir = join5(fixtureDir, "vod");
   mkdirSync(vodDir, { recursive: true });
   for (const name of ["sample-1.mp4", "sample-2.mp4"]) {
-    const dst = join4(vodDir, name);
+    const dst = join5(vodDir, name);
     writeFileSync(dst, readFileSync4(src));
   }
 }
@@ -983,7 +1446,8 @@ function emptyManifest(duration) {
     version: 1,
     generatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
     durationSeconds: duration,
-    fixtures: []
+    fixtures: [],
+    windowFixtures: []
   };
 }
 
@@ -1004,17 +1468,24 @@ export {
   ALL_CODECS,
   ALL_FORMATS,
   CODEC_SPEC,
+  DEFAULT_DRAWTEXT_FONT,
   DEFAULT_DURATION_SECONDS,
   DEFAULT_FIXTURE_DIR,
   DEFAULT_HLS_SEGMENT_SECONDS,
   DEFAULT_HOST,
   DEFAULT_PORT,
+  DRAWTEXT_FONT_CANDIDATES,
   VOD_SAMPLE_RELATIVE,
+  WINDOW_CONTAINER_DIR,
+  WINDOW_SPECS,
   buildPlan,
+  buildWindowPlan,
   containerRelativeDir,
   containerRelativePath,
   createStreamsServer,
+  drawtextFilter,
   expandMatrix,
+  expandWindowMatrix,
   generateFixtures,
   handleLiveStream,
   layoutFor,

package/dist/server/routes.d.ts

@@ -22,6 +22,11 @@ export type MultiVodListResponse = VodListResponse & {
 export declare const MULTI_VOD_MAX_CHANNELS = 9;
 export declare const MULTI_VOD_DEFAULT_CHANNELS = 4;
 export declare function parseChannelCount(raw: string | null): number;
+/**
+ * live 流分辨率/帧率 query 解析：整数且落在 [min, max] 才采纳，否则返回 null
+ * （调用方回退默认值）。供 /streams/live/* 的 ?width/?height/?fps 使用。
+ */
+export declare function parseBoundedQueryInt(raw: string | null, min: number, max: number): number | null;
 /**
  * /streams/vod-list-multi?channels=N:返回 N 个通道的录像段列表。
  * 时间基准对齐当天上海时区 00:00(与 demo 时间轴的 24h 视野对齐);

package/dist/server/server.js

@@ -38,6 +38,7 @@ function summarizeCatalog(fixtureDir) {
   }
   let total = 0;
   for (const item of manifest.fixtures) total += item.entries.length;
+  for (const item of manifest.windowFixtures ?? []) total += item.entries.length;
   return {
     codecs: ALL_CODECS,
     formats: ALL_FORMATS,
@@ -239,6 +240,12 @@ function parseChannelCount(raw) {
   if (!Number.isFinite(value) || value < 1) return MULTI_VOD_DEFAULT_CHANNELS;
   return Math.min(MULTI_VOD_MAX_CHANNELS, Math.floor(value));
 }
+function parseBoundedQueryInt(raw, min, max) {
+  if (raw == null || raw === "") return null;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < min || value > max) return null;
+  return value;
+}
 function handleVodListMulti(res, manifest, fixtureDir, channels) {
   const entriesSource = (() => {
     const vodListPath = join(fixtureDir, "vod", "vod-list.json");
@@ -558,7 +565,13 @@ function createStreamsServer(options) {
       }
       const liveMatch = matchLivePath(path);
       if (liveMatch) {
-        handleLiveStream(req, res, liveMatch.format, liveMatch.codec);
+        const liveQuery = (req.url ?? "").split("?", 2)[1] ?? "";
+        const liveParams = new URLSearchParams(liveQuery);
+        handleLiveStream(req, res, liveMatch.format, liveMatch.codec, {
+          width: parseBoundedQueryInt(liveParams.get("width"), 160, 3840) ?? void 0,
+          height: parseBoundedQueryInt(liveParams.get("height"), 160, 3840) ?? void 0,
+          fps: parseBoundedQueryInt(liveParams.get("fps"), 1, 60) ?? void 0
+        });
         return;
       }
       writeNotFound(res);