Esta es una guía para escribir marcado React en Remotion. Si esto no es relevante, carga Remotion Best Practices en su lugar.
Reglas generales
Anima propiedades usando useCurrentFrame() y interpolate().
Usa interpolate() en lugar de spring().
Usa Easing.bezier() para personalizar la temporización, incluyendo movimientos bruscos o con sobreimpulso.
Usa Easing.spring() si deseas animaciones con resorte.
Los elementos HTML que tengan sentido ser interactivos en el Estudio deben usar Interactive: <div> -> <Interactive.Div>.
Asigna una propiedad name descriptiva como name="Título principal" para Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Title"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
¡Hola Mundo!
</Interactive.Div>
);
};
Mantén la llamada a interpolate() en línea dentro de la propiedad style.
Prefiere las propiedades CSS scale, translate, rotate sobre transform.
// 👍 Fotogramas clave editables en línea y abreviaturas de transformación
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Los valores ocultos y las cadenas de transformación se vuelven más difíciles de editar en el Estudio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Las transiciones o animaciones CSS están PROHIBIDAS: no se renderizarán correctamente.
Los nombres de clase de animación de Tailwind están PROHIBIDOS: no se renderizarán correctamente.
Coloca los recursos en la carpeta public/ en la raíz de tu proyecto.
Usa staticFile() para hacer referencia a archivos desde la carpeta public/.
Añade video y audio usando @remotion/media.
Añade imágenes usando el componente <Img>.
Usa staticFile() para archivos en public/ o pasa una URL remota directamente:
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
Para retrasar contenido, envuélvelo en <Sequence> y usa from.
Para limitar la duración de un elemento, usa durationInFrames de <Sequence>.
<Sequence> por defecto es un relleno absoluto que cubre la escena.
Para contenido en línea, usa layout="none".
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Background">
<Background />
</Sequence>
<Sequence name="Title" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtitle" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Título
</div>
);
};
export const Subtitle = () => {
return <div>Subtítulo</div>;
};
Resaltados y anotaciones de texto
Consulta text-highlights.md para resaltados de texto (marcadores de resaltado), círculos, subrayados, tachados, texto cancelado, cuadros y corchetes.
Voz en off
Consulta voiceover.md para agregar voz en off generada por IA a composiciones de Remotion usando ElevenLabs TTS.
Recorte
Consulta trimming.md para patrones de recorte: cortar el inicio o el final de las animaciones.
Incrustación de videos
Consulta embedding-videos.md para conocimientos avanzados sobre la incrustación de videos: recorte, volumen, velocidad, bucle, tono.
Edición de video
Consulta video-editing.md para estructurar líneas de tiempo de video editables en Remotion Studio.
Incrustación de audio
Consulta audio.md para funciones de audio avanzadas como recorte, volumen, velocidad, tono.
Transiciones
Consulta transitions.md para patrones de transición de escenas.
Efectos visuales y de píxeles
Al crear un efecto visual, prefiere: 1. Animación normal de Remotion/HTML/CSS/SVG/filtro/mezcla/máscara, 2. un efecto listado a través de effects.md, incluso en HTML renderizado a través de <HtmlInCanvas>, 3. un createEffect() personalizado a través de effects.md cuando el usuario solicite un efecto reutilizable/específico del proyecto, 4. <HtmlInCanvas onPaint> personalizado a través de html-in-canvas.md solo si ningún efecto se ajusta.
Para superposiciones de fugas de luz, consulta light-leaks.md. Documentos: https://www.remotion.dev/docs/effects
Efectos disponibles: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), roughenEdges(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
Contenido 3D
Consulta 3d.md para contenido 3D en Remotion usando Three.js y React Three Fiber.
Efectos de sonido
Cuando necesites usar efectos de sonido, carga el archivo ./sfx.md para más información.
Visualización de audio
Cuando necesites visualizar audio (barras de espectro, formas de onda, efectos reactivos a graves), carga el archivo ./audio-visualization.md para más información.
Subtítulos
Cuando se trate de subtítulos o leyendas, carga la habilidad Remotion Captions para más información.
Google Fonts
Es la forma recomendada de cargar fuentes en Remotion. Consulta google-fonts.md para saber cómo cargar Google Fonts.
Fuentes locales
Consulta local-fonts.md para saber cómo cargar fuentes locales.
GIFs
Consulta gifs.md para saber cómo mostrar GIFs sincronizados con la línea de tiempo de Remotion.
Imágenes avanzadas
Consulta images.md para dimensionar y posicionar imágenes, rutas de imágenes dinámicas y obtener dimensiones de imágenes.
Animaciones Lottie
Consulta lottie.md para incrustar animaciones Lottie en Remotion.
Temporización avanzada
Consulta timing.md para la temporización avanzada con interpolate y easing Bézier, y resortes.
Videos parametrizados
Consulta parameters.md para hacer una composición parametrizable agregando un esquema Zod.
Medición de nodos DOM
Consulta measuring-dom-nodes.md para medir las dimensiones de elementos DOM en Remotion.
Medición de texto
Consulta measuring-text.md para medir dimensiones de texto, ajustar texto a contenedores y verificar desbordamiento.
Uso de FFmpeg
Para algunas operaciones de video, como recortar videos o detectar silencio, se debe usar FFmpeg. Carga el archivo ./ffmpeg.md para más información.
Detección de silencio
Cuando necesites detectar y recortar segmentos silenciosos de archivos de video o audio, carga el archivo ./silence-detection.md.
Duración, dimensiones y datos dinámicos
Consulta calculate-metadata.md para configurar dinámicamente la duración, dimensiones y propiedades de la composición.
Composiciones avanzadas
Consulta compositions.md para saber cómo definir imágenes fijas, carpetas, propiedades predeterminadas y cómo anidar composiciones.
Secuenciación avanzada
Consulta sequencing.md para más patrones de secuenciación: retraso, recorte, limitación de duración de elementos.
Instalar módulos
Usa npx remotion add para agregar nuevos paquetes con la versión correcta:
npx remotion add @remotion/media
Esto aplica para paquetes @remotion/*, mediabunny, @mediabunny/* y zod.
Vista previa del marcado
Haz esto solo si crees que el usuario quiere ver la vista previa.
npx remotion studio --no-open
Esto iniciará un proceso de larga duración e imprimirá la URL del servidor para la vista previa.
Si ya está iniciado, se imprimirá la URL.
Opcional: verificación de renderizado de un fotograma
Puedes renderizar un solo fotograma con la CLI para verificar el diseño, los colores o la temporización.
Omítelo para ediciones triviales, refactorizaciones puras, o cuando ya tengas suficiente confianza del Estudio o renderizados anteriores.
npx remotion still [composition-id] --scale=0.25 --frame=30
A 30 fps, --frame=30 es la marca de un segundo (--frame comienza en 0).