Repository Public
1import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";2import path from "node:path";3import type { Lang } from "../lib/contracts";4import { ff, probe } from "./ffmpeg";56/**7 * Empaquetage HLS multi-débit, dérivé du MASTER déjà filigrané (jamais de la source) : le filigrane est donc dans chaque variante.8 *9 * Échelle : paliers 1080 / 720 / 480 / 360 définis sur le PETIT côté de l'image (16:9 → hauteur ; 9:16 → largeur ; 1:1 → les deux),10 * sans sur-échantillonnage ; le palier le plus haut est la taille exacte du master. `sourceHeight` plafonne la hauteur des variantes.11 * Segments fMP4 (CMAF) de 4 s, GOP fixe de 2 s (segments alignés sur les images clés, identiques d'une variante à l'autre),12 * audio AAC multiplexé. Sous-titres : `captions.vtt` + playlist à un seul segment, groupe SUBTITLES du master.13 * Lisible par Safari (natif) et hls.js.14 */15const LADDER = [16 { p: 1080, maxrate: 5000, crf: 21, audio: 128 },17 { p: 720, maxrate: 2800, crf: 22, audio: 128 },18 { p: 480, maxrate: 1400, crf: 23, audio: 96 },19 { p: 360, maxrate: 800, crf: 24, audio: 96 },20];21const SEGMENT_SECONDS = 4;22const even = (n: number) => Math.max(2, Math.round(n / 2) * 2);2324export function hlsLadder(width: number, height: number, sourceHeight = height): { p: number; width: number; height: number; maxrate: number; crf: number; audio: number }[] {25 const short = Math.min(width, height);26 const capH = Math.min(height, sourceHeight || height);27 const size = (p: number) => (p >= short ? { width, height } : { width: even((width * p) / short), height: even((height * p) / short) });28 let rungs = LADDER.filter((r) => r.p <= short);29 if (!rungs.length) rungs = [LADDER[LADDER.length - 1]];30 // le palier du haut est toujours le master lui-même (ex. master 480p → 480 + 360 ; master 600p → 600 + 480 + 360)31 if (rungs[0].p < short) rungs = [{ ...(LADDER.find((r) => r.p >= short) ?? LADDER[0]), p: short }, ...rungs];32 const out = rungs.map((r) => ({ ...r, ...size(r.p) })).filter((r) => r.height <= capH);33 return out.length ? out : [{ ...rungs[rungs.length - 1], ...size(rungs[rungs.length - 1].p) }];34}3536function avcCodecString(profile: string | undefined, level: number): string {37 const idc = /high/i.test(profile ?? "") ? "64" : /main/i.test(profile ?? "") ? "4d" : "42";38 return `avc1.${idc}00${level.toString(16).padStart(2, "0")}`;39}40/** Niveau H.264 minimal (tableau A-1 : macroblocs par image et par seconde). */41function h264Level(width: number, height: number, fps: number): number {42 const fs = Math.ceil(width / 16) * Math.ceil(height / 16), mbps = fs * fps;43 const table: [number, number, number][] = [[30, 1620, 40500], [31, 3600, 108000], [32, 5120, 216000], [40, 8192, 245760], [42, 8704, 522240], [50, 22080, 589824], [51, 36864, 983040]];44 return table.find(([, maxFs, maxMbps]) => fs <= maxFs && mbps <= maxMbps)?.[0] ?? 52;45}4647export async function packageHls(o: { input: string; outDir: string; sourceHeight: number; captionsVtt?: string; language: Lang }): Promise<{ master: string; renditions: { height: number; bitrate: number; width?: number; uri?: string }[] }> {48 const src = await probe(o.input);49 if (!src.hasVideo || !(src.duration > 0)) throw new Error("packageHls : entrée illisible");50 const fps = Math.round(src.fps) || 30;51 const ladder = hlsLadder(src.width, src.height, o.sourceHeight);52 await mkdir(o.outDir, { recursive: true });53 const gop = fps * 2;5455 const split = ladder.map((_, i) => `[s${i}]`).join("");56 const graph = [`[0:v:0]split=${ladder.length}${split}`, ...ladder.map((r, i) => (r.width === src.width && r.height === src.height ? `[s${i}]null[v${i}]` : `[s${i}]scale=${r.width}:${r.height}:flags=lanczos,setsar=1[v${i}]`))].join(";");57 const args: string[] = ["-i", o.input, "-filter_complex", graph];58 for (const [i, r] of ladder.entries()) {59 const dir = path.join(o.outDir, `v${r.p}`);60 await mkdir(dir, { recursive: true });61 const level = h264Level(r.width, r.height, fps);62 args.push("-map", `[v${i}]`, ...(src.hasAudio ? ["-map", "0:a:0"] : []), "-map_metadata", "-1",63 "-c:v", "libx264", "-preset", "medium", "-profile:v", "high", "-level:v", (level / 10).toFixed(1), "-pix_fmt", "yuv420p",64 "-crf", String(r.crf), "-maxrate", `${r.maxrate}k`, "-bufsize", `${r.maxrate * 2}k`,65 "-g", String(gop), "-keyint_min", String(gop), "-sc_threshold", "0", "-r", String(fps),66 ...(src.hasAudio ? ["-c:a", "aac", "-b:a", `${r.audio}k`, "-ar", "48000", "-ac", "2"] : []),67 "-f", "hls", "-hls_time", String(SEGMENT_SECONDS), "-hls_playlist_type", "vod", "-hls_flags", "independent_segments",68 "-hls_segment_type", "fmp4", "-hls_fmp4_init_filename", "init.mp4", "-hls_segment_filename", path.join(dir, "seg-%04d.m4s"), path.join(dir, "index.m3u8"));69 }70 await ff(args, 3_600_000);7172 // débits réels mesurés sur les segments (BANDWIDTH = pointe, AVERAGE-BANDWIDTH = moyenne)73 const renditions: { height: number; bitrate: number; width: number; uri: string; average: number; codecs: string }[] = [];74 for (const r of ladder) {75 const dir = path.join(o.outDir, `v${r.p}`);76 const playlist = await readFile(path.join(dir, "index.m3u8"), "utf8");77 const durations = [...playlist.matchAll(/#EXTINF:([\d.]+)/g)].map((m) => Number(m[1]));78 const segs = (await readdir(dir)).filter((f) => f.endsWith(".m4s")).sort();79 if (!segs.length || segs.length !== durations.length) throw new Error(`packageHls : segments manquants (${r.p}p)`);80 const sizes = await Promise.all(segs.map(async (f) => (await stat(path.join(dir, f))).size));81 const peak = Math.max(...sizes.map((s, i) => (s * 8) / Math.max(durations[i], 0.5)));82 const average = (sizes.reduce((a, b) => a + b, 0) * 8) / durations.reduce((a, b) => a + b, 0);83 renditions.push({ height: r.height, width: r.width, bitrate: Math.round(peak), average: Math.round(average), uri: `v${r.p}/index.m3u8`,84 codecs: [avcCodecString("High", h264Level(r.width, r.height, fps)), ...(src.hasAudio ? ["mp4a.40.2"] : [])].join(",") });85 }8687 const lines = ["#EXTM3U", "#EXT-X-VERSION:7", "#EXT-X-INDEPENDENT-SEGMENTS"];88 let subs = "";89 if (o.captionsVtt?.trim()) {90 const dir = path.join(o.outDir, "subs");91 await mkdir(dir, { recursive: true });92 const body = o.captionsVtt.replace(/^?WEBVTT[^\n]*\n/, "").replace(/^X-TIMESTAMP-MAP[^\n]*\n/m, "");93 // fMP4 : la ligne de temps des segments commence à 0 → MPEGTS:094 await writeFile(path.join(dir, "captions.vtt"), `WEBVTT\nX-TIMESTAMP-MAP=MPEGTS:0,LOCAL:00:00:00.000\n${body.startsWith("\n") ? "" : "\n"}${body}`);95 const d = src.duration;96 await writeFile(path.join(dir, "index.m3u8"), ["#EXTM3U", "#EXT-X-VERSION:3", `#EXT-X-TARGETDURATION:${Math.ceil(d)}`, "#EXT-X-MEDIA-SEQUENCE:0", "#EXT-X-PLAYLIST-TYPE:VOD", `#EXTINF:${d.toFixed(3)},`, "captions.vtt", "#EXT-X-ENDLIST", ""].join("\n"));97 lines.push(`#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="${o.language === "fr" ? "Français" : "English"}",LANGUAGE="${o.language}",DEFAULT=NO,AUTOSELECT=YES,FORCED=NO,URI="subs/index.m3u8"`);98 subs = ',SUBTITLES="subs"';99 }100 for (const r of renditions) {101 lines.push(`#EXT-X-STREAM-INF:BANDWIDTH=${r.bitrate},AVERAGE-BANDWIDTH=${r.average},RESOLUTION=${r.width}x${r.height},FRAME-RATE=${fps.toFixed(3)},CODECS="${r.codecs}"${subs}`, r.uri);102 }103 const master = path.join(o.outDir, "master.m3u8");104 await writeFile(master, `${lines.join("\n")}\n`);105 return { master, renditions: renditions.map((r) => ({ height: r.height, bitrate: r.bitrate, width: r.width, uri: r.uri })) };106}107