SPB Git

Repository Public

hls.ts 7.4 KB 107 lines typescript

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
Files main
Menu

Theme