Product Launch Motion
Una disciplina de producción para crear videos de lanzamiento que parecen hechos por un diseñador de movimiento, no una presentación con voz en off superpuesta.
El resultado es un MP4 renderizado. El medio es HTML, CSS y GSAP, renderizado cuadro por cuadro por un renderizador determinista basado en búsqueda (HyperFrames por defecto). Todo aquí es transferible a cualquier renderizador que pueda buscar en una línea de tiempo; las leyes son neutrales al renderizador, los ejemplos de tubería son de HyperFrames.
Este skill existe porque una herramienta verde no es lo mismo que una buena película. Una composición puede pasar todos los lint, renderizar sin errores, y seguir siendo una presentación. El valor a continuación es el oficio que separa ambas cosas, más las trampas que cuestan horas reales de encontrar, cada una registrada con la medición que la prueba, no la vibra que la sugirió.
Es una disciplina, no una plantilla. Las leyes a continuación son fijas; el aspecto no lo es, y decidirlo es tu trabajo como director. Dos películas construidas con este skill deben ser inconfundiblemente diferentes entre sí — diferente paleta, suelo, personalidad de cámara, tipo, textura, sonido y estructura — porque defienden afirmaciones diferentes para audiencias diferentes. Antes de construir nada, escribe tres direcciones visuales genuinamente diferentes y elimina dos: references/11-creative-direction.md. Alcanzar el aspecto de la película de referencia porque está documentado aquí es el único modo de fallo que hace que todo lo demás no valga nada.
Cuándo usarlo
Úsalo para: un video de lanzamiento de producto o anuncio de funcionalidad (20–90s), un video hero de página de inicio, un demo reel, un sizzle de conferencia, un video de actualización para inversores, o un rescate de un video que "se ve básico".
No lo uses para: edición de cabezas parlantes, grabaciones de pantalla con subtítulos pegados, o cualquier cosa donde el entregable sea una página web viva en lugar de un archivo de video.
Las diez leyes
Rompe una y la película se ve amateur, por buenos que sean los cuadros individuales. Nota lo que no cubren: ninguna te dice cómo debería verse la película.
1 · Verdad primero. Cada número, logo, rostro, captura de pantalla y testimonio en pantalla es real y tiene fuente. Antes de animar cualquier cosa, anota las cifras aprobadas — la lista exacta de numerales que se permite mostrar — y rechaza cualquier otro número. Las métricas inventadas y las caras de stock son la forma más rápida de hacer que un producto real parezca falso. → references/02-story-and-truth.md
2 · Sincronización bloqueada por palabra. Cada revelación está sincronizada con el tiempo de inicio medido de la palabra que ilustra. No a una cuadrícula de ritmo, no a una estimación — a una transcripción a nivel de palabra del archivo de voz en off real. Un cuadro en t=0 muestra solo lo que la voz dice en t=0. → references/03-word-locked-sync.md
3 · Determinismo. No Math.random, no Date.now, no transiciones CSS, no repeat/yoyo. Cualquier valor disperso o ruidoso se deriva de un índice o del cabezal de reproducción. Una búsqueda al tiempo T debe reproducir una salida idéntica byte por byte, o tu renderizado es una lotería. → references/01-renderer-contract.md
4 · Una cámara, dos nodos. Una rotación de plano general y una escala de plano medio deben vivir en elementos diferentes. En el mismo elemento, compiten por una matriz de transformación y el movimiento se sacude. Nodo exterior = dolly (escala), nodo interior = giro 3D (rotación + perspectiva). → references/05-camera-3d-cursor.md
5 · El cursor es un atrezzo de escenario. Un puntero de tamaño real (~32px a 1920) desaparece en cualquier control saturado. Dibújalo a ~44×54 con un trazo grueso y una sombra profunda, colócalo dentro del nodo que mueve la cámara, y pon el origen de zoom exactamente en el control que hace clic — ese punto se convierte en un punto fijo de la transformación y la puntería sobrevive al empuje sin matemáticas compensatorias. → references/05-camera-3d-cursor.md
6 · El sonido es aritmética, no gusto. El volumen de una pista no puede rescatar un archivo fuente silencioso. Si el activo está 20 dB por debajo del lecho de narración, subir su volumen mueve la mezcla en décimas de dB — medido, no adivinado. Nivela el activo, luego verifica que la pista aterrice en el archivo entregado. → references/07-sound-and-master.md
7 · Nada termina moviéndose. Cada plano se resuelve. El movimiento se sincroniza con el significado; un plano que aún está derivando cuando se corta se lee como un salvapantallas, y un plano donde todo deriva independientemente también se lee como uno. Alcance: esto gobierna la resolución, no la inmovilidad. Una toma de un solo plano cuya cámara nunca se detiene lo satisface al desacelerar hasta detenerse antes del final; un plano que mantiene un movimiento lento deliberado mientras su contenido está asentado también lo satisface. Lo que prohíbe es un corte de plano mientras lo que estaba diciendo aún está llegando. → references/04-motion-grammar.md
8 · Raciona el acento. Dos suelos (uno para el argumento, uno para el producto), un color o degradado de acento, y un presupuesto escrito de dónde puede aparecer — típicamente: una palabra de énfasis por titular, números de estadísticas, el paso activo, cambios de estado, el CTA. Un tercer tono casi siempre es un error. → references/06-look-and-grade.md
9 · Los pases de verificación son necesarios, no suficientes. Los pases de lint, diseño y contraste no detectan ninguna de las cosas que hacen que una película sea mala. Después de cada renderizado, extrae cuadros del archivo entregado en los tiempos que cambiaste, míralos y escribe qué está mal antes de que nadie más lo haga. → references/08-qa-and-direction.md
10 · Sin estilo de casa. El aspecto se deriva de la afirmación, marca, audiencia y categoría de este producto — nunca heredado de la última película o de los ejemplos en este repositorio. Escribe tres direcciones diferentes, elige una, y dale a la película un movimiento característico que ninguna otra película tenga. Una película que podría ser la de un competidor cambiando el logotipo no tiene dirección. → references/11-creative-direction.md
Señales de alerta
Estos son los pensamientos que preceden cada paso omitido. Cada uno es una señal para detenerse y hacer lo que estás a punto de evitar.
| El pensamiento | Lo que realmente significa |
|---|---|
| "Estimaré los tiempos y los arreglaré después" | No lo harás. Cada pista de sincronización estará mal, y volver a derivarlas todas cuesta más que hacerlo una vez ahora |
| "Tres direcciones es excesivo para esto" | Tienes una idea y ninguna base para creer que sea buena. Dos de las tres están destinadas a morir |
| "La marca es morada, así que esta paleta está bien" | Verifica si la derivaste o la heredaste de los ejemplos aquí |
| "Suena bien para mí" | Estás escuchando en la máquina que lo renderizó, a un volumen que elegiste, sabiendo qué escuchar. Mídelo |
| "El cambio está en el código fuente, así que está en la película" | Dos errores documentados en la historia de este repositorio fueron exactamente eso. Muestrea el archivo entregado |
| "Los pases pasaron" | Los pases detectan roto, no malo. Nunca han detectado una película aburrida |
| "Es un ajuste pequeño, no hace falta reverificar" | Los ajustes pequeños son cómo un master de −14 LUFS se volvió uno recortado |
| "Sobrescribiré el último renderizado" | Entonces no puedes probar que la corrección funcionó, y la versión que el director prefirió se ha ido |
| "Dijeron que lo haga 3D, así que añadiré rotación" | Toma la nota como un síntoma, no una especificación. "Hazlo 3D" significaba un soporte de cámara, una reconstrucción del cursor y un refactor de coordenadas |
| "Añadiré el movimiento de cámara al final" | Una cámara cambia lo que significa cada coordenada. Adaptar un soporte significa rehacer cada posición en el plano |
| "Está lo suficientemente cerca de la palabra" | 200ms de desviación se lee como retraso para un espectador que no puede nombrar por qué |
Violar la letra de una ley es violar la ley. "Mayormente determinista" es no determinista; "aproximadamente en la palabra" está fuera de la palabra.
El pipeline
Catorce pasos. No te saltes el 1, 2, 5 o 13 — son los que la gente se salta, y son los que deciden si la película es buena.
Los pasos 1–3 son un bucle, no una secuencia: la dirección depende de qué activos reales existen, y el pase de verdad a menudo mata una dirección por completo (no puedes filmar una película de producto con luz rasante para un producto que no se ha fabricado). Cíclalos hasta que coincidan, luego avanza.
| # | Paso | Resultado | Referencia |
|---|---|---|---|
| 1 | Recepción — el producto, la audiencia, la ÚNICA afirmación, el ángulo (generalmente el titular del producto) | BRIEF.md | assets/BRIEF.md |
| 2 | Dirección — tres direcciones visuales genuinamente diferentes, juzgadas y reducidas a una, más un movimiento característico | bloque de dirección | references/11-creative-direction.md |
| 3 | Pase de verdad — recopila activos reales, pantallas reales, clientes reales, y corrige la lista de cifras aprobadas | assets/, lista de cifras | references/02-story-and-truth.md |
| 4 | Guión — 40–60s escrito para el oído; una cláusula por tiempo; la afirmación aterriza en los primeros 10s | SCRIPT.md | references/02-story-and-truth.md |
| 5 | Voz en off — renderiza o graba la VO antes de construir cualquier cosa; las duraciones de los cuadros provienen de la longitud real de la VO | assets/voice/*.wav | references/03-word-locked-sync.md |
| 6 | Tiempos de palabras — transcribe con marcas de tiempo a nivel de palabra en una tabla de pistas | audio_meta.json | scripts/word-timings.mjs |
| 7 | Storyboard — cuadros, duraciones, el mapa de registro de tu dirección, y un plano por tiempo | STORYBOARD.md | references/09-shot-catalog.md |
| 8 | Construir cuadros — un archivo HTML por cuadro; soporte de cámara y cursor del esqueleto; cada interpolación sincronizada a una palabra | compositions/frames/*.html | references/04-motion-grammar.md |
| 9 | Ensamblar — índice, transiciones, audio, gradación — en ese orden, siempre | index.html | references/01-renderer-contract.md |
| 10 | Pases de verificación — lint/ejecución/diseño/movimiento con la gradación activada; contraste con la gradación desactivada | 0 errores | references/08-qa-and-direction.md |
| 11 | Renderizar + masterizar — loudnorm de dos pasos, limitador, recodificación | renders/*.mp4 | scripts/master.sh |
| 12 | Verificar en el archivo entregado — cuadros en los tiempos cambiados, niveles de pista medidos | evidencia | scripts/verify-cue.sh |
| 13 | Dirigir — mírala, lista los defectos tú mismo, corrige, re-renderiza como un NUEVO archivo | v2, v3, … | references/08-qa-and-direction.md |
| 14 | Entregar el conjunto — corte vertical, subtítulos, póster, bucle, fotogramas, licencias | deliverables/ | references/12-deliverables.md |
El orden de construcción (paso 9) no es negociable
El índice se genera, por lo que cualquier cosa añadida manualmente se destruye al reensamblar y debe ser reinyectada. Cada script de cableado aquí es idempotente (reemplaza su propio bloque marcado), por lo que el movimiento seguro es siempre volver a ejecutar toda la cadena:
node scripts/assemble.mjs # film.json + VO medida → index.html
node scripts/transitions.mjs # los cruces entre cuadros
node scripts/wire-audio.mjs # fondo musical + pistas SFX sincronizadas con palabras
node scripts/wire-grade.mjs # grano + viñeta + barridos especulares
assemble.mjs lee film.json (assets/film.example.json es uno completo) y mide cada cuadro de su voz en off con ffprobe, por lo que nunca escribes una duración. Aplica la aritmética de la que depende cada pista de sincronización descendente: hold = VO + pad — el aliento después de la última palabra, porque un plano que corta en la última sílaba se lee como apresurado — y duration = hold + la transición saliente. El siguiente cuadro comienza en hold, no en duration; la diferencia es la superposición en la que vive la transición.
Mapa de referencias
Carga solo lo que necesita el paso actual.
| Archivo | Qué contiene |
|---|---|
references/11-creative-direction.md | Lee esto primero. Qué es fijo y qué es libre, los diales de dirección, derivar un aspecto del producto, divergir a tres direcciones, el movimiento característico, cinco direcciones trabajadas, y las comprobaciones anti-semejanza |
references/01-renderer-contract.md | Cómo el HTML se convierte en video: pistas temporizadas, la línea de tiempo buscable, reglas de determinismo, orden de construcción, y qué hacer en Remotion en su lugar |
references/02-story-and-truth.md | Ángulo, arco, el mapa de registro, la disciplina de cifras aprobadas, reglas de honestidad, y cómo obtener activos reales para cualquier producto |
references/03-word-locked-sync.md | Obtener tiempos de palabras, escribir la tabla de pistas, ritmo, pausas, y por qué la VO viene primero |
references/04-motion-grammar.md | Suavizado, entradas, escalonamientos, anticipación, rampas de velocidad, tipo cinético, y los dos modos de fallo (presentación / salvapantallas) |
references/05-camera-3d-cursor.md | El soporte de cámara de dos nodos, plato giratorio, dolly, zoom a detalle, rack focus, z-parallax, y la especificación completa de cursor falso |
references/06-look-and-grade.md | Racionamiento de paleta, bordes de vidrio sin backdrop-filter, grano de película, viñeta, barridos especulares, y la trampa de modo de mezcla |
references/07-sound-and-master.md | Diseño de SFX, sub-graves, silencio antes del tiempo hero, la ley de aritmética de volumen, nivelación de activos, y la cadena de masterización |
references/08-qa-and-direction.md | Los pases de verificación, revisión de instantáneas, verificación del archivo entregado, y el bucle de director que convierte una v1 en una v7 |
references/09-shot-catalog.md | 14 construcciones de planos para adaptar — compositor/prompt, lista de resultados, espacio de trabajo, rastreador de pipeline, cuenta regresiva de estadísticas, testimonio, comparación, hero de hardware, terminal, mapa, gráfico, tarjeta final. Nunca un orden de ejecución para copiar |
references/10-traps.md | Cada trampa que encontramos, cada una con la medición que la prueba. Lee esto antes de depurar cualquier cosa |
references/12-deliverables.md | El conjunto que realmente se entrega: re-diseños verticales, áreas seguras de plataforma, subtítulos de tus tiempos de palabras existentes, fotograma de póster, bucles, nomenclatura y entrega |
Scripts
Todos son Node/bash con pocas dependencias, todos idempotentes, todos seguros de re-ejecutar.
| Script | Hace |
|---|---|
scripts/assemble.mjs | Escribe index.html desde film.json, midiendo la longitud de cada cuadro de su voz en off en lugar de dejarte adivinarla |
scripts/transitions.mjs | Inyecta los cruces entre cuadros — disolución, zoom, empuje, corte — en el instante en que termina la narración de cada cuadro |
scripts/wire-audio.mjs | Monta un fondo musical + una tabla de pistas de SFX en el índice ensamblado, resolviendo los tiempos de pista relativos al cuadro contra los inicios reales del cuadro |
scripts/wire-grade.mjs | Inyecta la gradación de la película: grano sembrado por cabezal de reproducción, viñeta, y barridos especulares en los tiempos que pases (--sweeps 7.9:0.9,…; sin barridos a menos que los pidas) |