Kit de Herramientas de Video Remotion
Resumen
Crea videos de forma programática usando React y Remotion. Construye plantillas de video reutilizables como componentes de React, renderízalas a MP4/WebM mediante CLI o infraestructura en la nube, y genera videos personalizados a escala. Ideal para contenido automatizado de redes sociales, visualizaciones de datos animadas y tuberías de producción de video dinámicas.
Instrucciones
Cuando un usuario pida crear un video programático, determina la tarea:
Tarea A: Configurar un proyecto Remotion
# Crea un nuevo proyecto Remotion
npx create-video@latest mi-video
cd mi-video
npm start # Abre Remotion Studio en http://localhost:3000
Estructura del proyecto:
mi-video/
src/
Root.tsx # Registra todas las composiciones
MiComposicion.tsx # Tu componente de video
remotion.config.ts # Configuración de renderizado
Tarea B: Crear una composición de video
Cada video de Remotion es un componente de React que usa useCurrentFrame() y useVideoConfig():
import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, spring } from "remotion";
interface MiVideoProps {
titulo: string;
subtitulo: string;
colorFondo: string;
}
export const MiVideo: React.FC<MiVideoProps> = ({ titulo, subtitulo, colorFondo }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
// Animar el título deslizándose hacia adentro
const tituloY = spring({ frame, fps, from: -100, to: 0, durationInFrames: 30 });
// Fundido de entrada del subtítulo después de 20 fotogramas
const opacidadSubtitulo = interpolate(frame, [20, 40], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: colorFondo, justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontSize: 80, color: "white", transform: `translateY(${tituloY}px)` }}>
{titulo}
</h1>
<p style={{ fontSize: 36, color: "rgba(255,255,255,0.8)", opacity: opacidadSubtitulo }}>
{subtitulo}
</p>
</AbsoluteFill>
);
};
Registra la composición en Root.tsx:
import { Composition } from "remotion";
import { MiVideo } from "./MiVideo";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MiVideo"
component={MiVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
defaultProps={{ titulo: "Hola Mundo", subtitulo: "Hecho con Remotion", colorFondo: "#1a1a2e" }}
/>
);
};
Tarea C: Añadir subtítulos animados estilo TikTok
import { AbsoluteFill, useCurrentFrame, Sequence } from "remotion";
interface PalabraSubtitulo {
texto: string;
frameInicio: number;
duracionFotogramas: number;
}
const subtitulos: PalabraSubtitulo[] = [
{ texto: "Esto", frameInicio: 0, duracionFotogramas: 15 },
{ texto: "es", frameInicio: 15, duracionFotogramas: 10 },
{ texto: "increíble!", frameInicio: 25, duracionFotogramas: 20 },
];
export const SuperposicionSubtitulos: React.FC = () => {
const frame = useCurrentFrame();
const palabraActiva = subtitulos.find(
(c) => frame >= c.frameInicio && frame < c.frameInicio + c.duracionFotogramas
);
return (
<AbsoluteFill style={{ justifyContent: "flex-end", alignItems: "center", paddingBottom: 120 }}>
{palabraActiva && (
<div style={{
fontSize: 64,
fontWeight: "bold",
color: "white",
textShadow: "2px 2px 8px rgba(0,0,0,0.8)",
backgroundColor: "rgba(0,0,0,0.5)",
padding: "8px 24px",
borderRadius: 12,
}}>
{palabraActiva.texto}
</div>
)}
</AbsoluteFill>
);
};
Tarea D: Renderizar videos
# Renderizar localmente mediante CLI
npx remotion render MiVideo salida/video.mp4
# Renderizar con props personalizados
npx remotion render MiVideo salida/video.mp4 --props='{"titulo":"Título Personalizado"}'
# Renderizar un fotograma fijo (para miniaturas)
npx remotion still MiVideo salida/miniatura.png --frame=45
# Renderizar con códec y calidad específicos
npx remotion render MiVideo salida/video.mp4 --codec=h264 --crf=18
Para renderizado por lotes a escala:
# Renderizar en AWS Lambda
npx remotion lambda render MiVideo --props='{"titulo":"Video 1"}'
# Renderizar en Google Cloud Run
npx remotion cloudrun render MiVideo --props='{"titulo":"Video 1"}'
Tarea E: Visualizaciones de datos animadas
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
interface PuntoDato { etiqueta: string; valor: number; color: string; }
export const GraficoBarras: React.FC<{ datos: PuntoDato[] }> = ({ datos }) => {
const frame = useCurrentFrame();
const maxVal = Math.max(...datos.map((d) => d.valor));
return (
<AbsoluteFill style={{ padding: 80, justifyContent: "flex-end", backgroundColor: "#0f0f23" }}>
<div style={{ display: "flex", alignItems: "flex-end", gap: 20, height: "70%" }}>
{datos.map((punto, i) => {
const altura = interpolate(frame, [i * 10, i * 10 + 30], [0, (punto.valor / maxVal) * 100], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
return (
<div key={i} style={{ flex: 1, textAlign: "center" }}>
<div style={{
height: `${altura}%`,
backgroundColor: punto.color,
borderRadius: "8px 8px 0 0",
transition: "height 0.3s",
}} />
<p style={{ color: "white", marginTop: 12, fontSize: 24 }}>{punto.etiqueta}</p>
</div>
);
})}
</div>
</AbsoluteFill>
);
};
Ejemplos
Ejemplo 1: Video de bienvenida personalizado
Solicitud del usuario: "Genera un video de bienvenida para cada nuevo usuario con su nombre"
# Genera videos a partir de una lista JSON de usuarios
for usuario in $(jq -r '.[] | @base64' usuarios.json); do
nombre=$(echo "$usuario" | base64 -d | jq -r '.nombre')
npx remotion render VideoBienvenida "salida/bienvenida_${nombre}.mp4" \
--props="{\"nombreUsuario\":\"${nombre}\"}"
done
Ejemplo 2: Panel de ventas animado
Solicitud del usuario: "Crea un video que muestre nuestras métricas trimestrales animándose"
Construye una composición usando el componente GraficoBarras con datos trimestrales, renderiza con:
npx remotion render PanelVentas salida/informe_q4.mp4 \
--props='{"trimestre":"Q4","ingresos":1250000,"crecimiento":12.5}'
Ejemplo 3: Contenido de redes sociales con subtítulos
Solicitud del usuario: "Añade subtítulos animados a un video para TikTok"
Combina SuperposicionSubtitulos con una fuente OffthreadVideo:
import { OffthreadVideo } from "remotion";
<AbsoluteFill>
<OffthreadVideo src="https://ejemplo.com/clip.mp4" />
<SuperposicionSubtitulos />
</AbsoluteFill>
Directrices
- Usa
useCurrentFrame()einterpolate()para todas las animaciones; evita las transiciones CSS. - Mantén las composiciones puras: pasa todos los datos dinámicos como props para facilitar el renderizado por lotes.
- Usa
<Sequence>para organizar las secciones de tu línea de tiempo de video. - Prefiere
<OffthreadVideo>sobre<Video>para un mejor rendimiento con fuentes de video. - Establece
crf(Factor de Tasa Constante) entre 16 y 20 para una buena relación calidad-tamaño. - Para renderizado en Lambda, mantén las composiciones por debajo de 120 segundos para evitar problemas de tiempo de espera.
- Prueba en Remotion Studio antes de renderizar para detectar problemas de diseño a tiempo.
- Usa
staticFile()para hacer referencia a los activos en la carpetapublic/.