Resumen
Esta habilidad añade subtítulos incrustados a un video existente mediante una composición de superposición de HyperFrames. Úsala cuando tu metraje de origen necesite subtítulos accesibles y estilizados sin una pista de subtítulos separada. Renderiza el MP4 subtitulado de forma determinista a partir de la superposición HTML.
HyperFrames — Subtítulos Incrustados
Añade subtítulos a videos de cabezas parlantes o lanzamientos. El modelo de subtítulos (drop/rail/embed) y la ley de superposición (los subtítulos NO son una banda reservada).
Cuándo Usarlo
- El usuario quiere subtítulos en un video de cabeza parlante
- El usuario quiere un riel de subtítulos literales (tercio inferior estándar)
- El usuario quiere texto incrustado cinematográfico detrás del sujeto (el clímax)
- El usuario quiere añadir accesibilidad a un video
- El usuario quiere quemar subtítulos para redes sociales (sin pista de subtítulos)
Cuándo NO Usarlo
- El usuario quiere un flujo de trabajo de video completo (usa
hyperframes-product-launch-video) - El usuario quiere un video explicativo completo (usa
hyperframes-faceless-explainer) - El usuario quiere subtítulos como archivo externo (SRT/VTT) — esta habilidad los quema
El Modelo de Subtítulos — Drop / Rail / Embed
| Qué | Cómo se muestra | |
|---|---|---|
| drop | relleno — muletillas, tartamudeos | no se muestra |
| rail | el predeterminado — contenido hablado normal | subtítulo limpio en tercio inferior, al frente |
| embed | un pico promovido — el momento clave | una palabra grande detrás del sujeto (oclusión mate) |
El rail lleva la mayor parte del texto; embed es el pico escaso y ganado — ≤1 por beat, nunca dos adyacentes, espaciados ≥ un beat de diferencia.
La Ley de Superposición
Una línea de subtítulos se compone SOBRE la película como una superposición; NO es una zona reservada.
- Centra la composición en el centro vertical VERDADERO (y = H/2). No desplaces el contenido hacia arriba para "hacer espacio" para los subtítulos.
- El contenido puede extenderse hasta el borde inferior del lienzo.
- Evita colocar texto crítico pequeño legible (URL, línea legal) en el centro de los ~80px inferiores donde se asienta la línea de subtítulos.
- Sin barrera de exclusión automática: juzga la legibilidad visualmente.
Flujo de Trabajo
1 · Generar voz en off + marcas de tiempo de palabras
# Usando TTS con marcas de tiempo a nivel de palabra
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
2 · Alinear subtítulos con tokens mostrados
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
captions.json es la entrada del riel de subtítulos (ortografía mostrada, temporización hablada).
3 · Construir el riel de subtítulos
const LINES = /* contenido de captions.json */ [
{ id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], ...] },
...
];
4 · Verificar la presencia de subtítulos
Toma 3-4 fotogramas de muestra a lo largo de la ventana hablada de la VO y confirma que el riel de subtítulos renderice texto visible en cada uno. Si algún fotograma en un intervalo hablado carece de subtítulos, la compilación se envía sin subtitular — trátalo como una barrera roja.
Tabla de Anti-Racionalización
| Racionalización | Realidad |
|---|---|
| "Centraré al 42% para dejar espacio para los subtítulos" | Centro verdadero (y = H/2) — los subtítulos son superposición |
| "Incrustaré cada palabra" | Embed es escaso — el rail lleva la mayor parte del texto |
| "Omitiré las marcas de tiempo de palabras" | El audio es el reloj — todos los tiempos de los beats provienen de las marcas de tiempo de palabras |
| "Usaré ortografía fonética en los subtítulos" | Los subtítulos siempre renderizan la capa mostrada |
| "Adivinaré la pronunciación" | Pregunta al usuario, luego amplía el léxico |
Verificación
- Riel de subtítulos presente en 3+ fotogramas muestreados
- Ortografía mostrada coincide con el guion (no fonética)
- Marcas de tiempo de palabras alineadas con el audio
- Composición centrada en el centro verdadero (y = H/2)
- Sin texto crítico en la zona de superposición de subtítulos