Übersicht
Dieser Skill fügt einem vorhandenen Video mittels einer HyperFrames-Overlay-Komposition fest eingebrannte Untertitel hinzu. Verwende ihn, wenn dein Quellmaterial barrierefreie, gestaltete Untertitel ohne separaten Untertitel-Track benötigt. Er rendert das untertitelte MP4 deterministisch aus dem HTML-Overlay.
HyperFrames — Eingebettete Untertitel
Füge Untertiteln zu Videos mit Sprecher:innen oder Launch-Videos hinzu. Das Untertitel-Modell (Drop/Rail/Embed) und das Overlay-Gesetz (Untertitel sind KEIN reservierter Bereich).
Wann zu verwenden
- Der/die Nutzer:in wünscht Untertitel auf einem Video mit Sprecher:in
- Der/die Nutzer:in wünscht eine wortgetreue Untertitel-Zeile (Standard-Drittel-unten)
- Der/die Nutzer:in wünscht filmischen eingebetteten Text hinter dem Motiv (der Höhepunkt-Beat)
- Der/die Nutzer:in möchte ein Video barrierefreier machen
- Der/die Nutzer:in möchte Untertitel für soziale Medien einbrennen (kein Untertitel-Track)
Wann NICHT zu verwenden
- Der/die Nutzer:in wünscht einen vollständigen Video-Workflow (verwende
hyperframes-product-launch-video) - Der/die Nutzer:in wünscht einen vollständigen Erklärfilm (verwende
hyperframes-faceless-explainer) - Der/die Nutzer:in wünscht Untertitel als separate Datei (SRT/VTT) – dieser Skill brennt sie ein
Das Untertitel-Modell — Drop / Rail / Embed
| Was | Wie es dargestellt wird | |
|---|---|---|
| Drop | Füllwörter — ähm, Stottern | nicht angezeigt |
| Rail | der Standard — normaler Sprechtext | saubere untere Drittel-Untertitel, vorne |
| Embed | ein hervorgehobener Höhepunkt — der Schlagzeilen-Beat | ein großes Wort hinter dem Motiv (Matten-Okklusion) |
Die Rail trägt den Großteil des Textes; Embed ist der seltene, verdiente Höhepunkt — ≤1 pro Beat, niemals zwei benachbarte, mindestens einen Beat Abstand.
Das Overlay-Gesetz
Eine Untertitel-Zeile wird ALS OVERLAY über dem Film zusammengesetzt; sie ist KEINE reservierte Zone.
- Zentriere die Komposition auf die WAAGERECHTE MITTE (y = H/2). Verschiebe den Inhalt NICHT nach oben, um „Platz für Untertitel zu schaffen“.
- Der Inhalt kann bis zum unteren Rand der Leinwand reichen.
- Vermeide es, kritischen, kleinen lesbaren Text (URL, rechtlicher Hinweis) im Bereich der unteren ~80px der zentralen Spanne zu platzieren, wo die Untertitel-Zeile liegt.
- Keine maschinelle Sperrzone – beurteile die Lesbarkeit visuell.
Workflow
1 · Sprachausgabe + Wort-Zeitstempel generieren
# Mit TTS mit Wort-Zeitstempeln
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
2 · Untertitel an Anzeige-Tokens ausrichten
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
captions.json ist die Eingabe für die Untertitel-Zeile (Anzeige-Schreibweise, gesprochene Zeit).
3 · Die Untertitel-Zeile erstellen
const LINES = /* Inhalt von captions.json */ [
{ id: 0, end: 2.74, w: [["Dies", 0.0], ["ist,", 0.30], ...] },
...
];
4 · Vorhandensein von Untertiteln überprüfen
Teste 3–4 Frames über das gesprochene Fenster der VO und bestätige, dass die Untertitel-Zeile auf jedem Frame sichtbaren Text rendert. Wenn ein Frame in einem gesprochenen Intervall keine Untertitel hat, wird der Build ohne Untertitel ausgeliefert – behandle dies als eine rote Sperre.
Anti-Rationalisierungstabelle
| Rationalisierung | Realität |
|---|---|
| „Ich zentriere bei 42 %, um Platz für Untertitel zu lassen” | Echte Mitte (y = H/2) – Untertitel sind Overlay |
| „Ich bette jedes Wort ein” | Embed ist selten – die Rail trägt den meisten Text |
| „Ich lasse Wort-Zeitstempel weg” | Audio ist die Uhr – alle Beat-Zeiten kommen von Wort-Zeitstempeln |
| „Ich verwende phonetische Schreibweise in Untertiteln” | Untertitel rendern immer die Anzeige-Ebene |
| „Ich rate die Aussprache” | Frage den/die Nutzer:in und erweitere dann das Lexikon |
Überprüfung
- Untertitel-Zeile auf 3+ getesteten Frames vorhanden
- Anzeige-Schreibweise stimmt mit Skript überein (nicht phonetisch)
- Wort-Zeitstempel sind mit Audio synchron
- Komposition auf waagerechter Mitte zentriert (y = H/2)
- Kein kritischer Text in der Untertitel-Overlay-Zone