Esta es una guía para escribir el marcado React de Remotion. Si esto no es relevante, cargue las Prácticas Recomendadas de Remotion en su lugar.
Preservar cambios del usuario
Los usuarios pueden hacer ediciones en el código fuera de la conversación.
Si detecta un cambio sorprendente realizado mientras tanto, no lo sobrescriba, asuma que fue intencional o pida confirmación.
Reglas generales
Impulse las animaciones usando useCurrentFrame() e interpolate().
transition o animation de CSS no se renderizarán correctamente, deben ser refactorizados.
Las clases de animación de Tailwind no se renderizarán correctamente, deben ser refactorizadas.
Use Easing.bezier() y Easing.spring() para personalizar la sincronización.
Estructura tu marcado de acuerdo con las Prácticas Recomendadas de Interactividad de Remotion.
Prefiere Interactive.withSchema({wrapInSequence: true}) para componentes visuales personalizados
con props editables, y registra escenas reutilizables como composiciones conectadas.
Coloca la sincronización directamente en los componentes que la soportan; evita envoltorios redundantes de <Sequence>.
Dale a cada componente temporizado que soporte premountFor un segundo de precarga:
premountFor={fps}, donde fps proviene de useVideoConfig(). Aplica esto a
medios, componentes interactivos, <Sequence>, <Series.Sequence>,
<TransitionSeries.Sequence>, y <TransitionSeries.Overlay>, incluyendo
componentes temporizados anidados dentro de escenas. Precarga también el elemento de la línea de tiempo padre
cuando un elemento anidado necesite montarse antes de que el padre comience. Un componente sin
premountFor, como <TransitionSeries.Transition>, no necesita sustituto.
El Studio edita el nodo fuente JSX que creó un elemento. Autoriza cada registro de composición, clip, escena, capa y secuencia que deba ser editable de forma independiente como su propio nodo JSX, con sus props editables en línea. Los bucles programáticos son adecuados cuando las instancias generadas están intencionalmente controladas como una plantilla fuente única, no cuando los usuarios necesitan editar las instancias por separado.
import { useCurrentFrame, useVideoConfig, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
return (
<Interactive.Div
name="Título"
premountFor={fps}
style={{
opacity: interpolate(frame, [0, 2 * fps], [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 prop style.
Usa las propiedades CSS scale, translate, rotate en lugar de transform.
// 👍 Fotogramas clave editables en línea y abreviaturas de transformación
style={{
scale: interpolate(frame, [0, 100], [0, 1], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
output: 'perceptual-scale' // Para animaciones de `scale`, usa "output: 'perceptual-scale'"
}),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
}}
// 👎 Los valores no en línea y las cadenas de transformación se vuelven más difíciles de editar en Studio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Activos
Coloca los activos en la carpeta public/ en la raíz de tu proyecto.
Usa staticFile() para referenciar archivos desde la carpeta public/.
Componentes multimedia
Agrega video y audio usando <Video> y <Audio> de @remotion/media.
Agrega imágenes usando el componente <CanvasImage>.
Agrega imágenes animadas GIF, APNG, WebP o AVIF usando <AnimatedImage>, usa @remotion/gif si no usas Chrome.
Usa staticFile() para archivos en public/ o pasa una URL remota directamente:
import { Audio, Video } from "@remotion/media";
import { staticFile, CanvasImage, AnimatedImage, useVideoConfig } from "remotion";
export const MyComposition = () => {
const {fps} = useVideoConfig();
return (
<>
<Video src={staticFile("video.mp4")} premountFor={fps} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} premountFor={fps} />
<CanvasImage
src={staticFile("logo.png")}
premountFor={fps}
style={{ width: 100, height: 100 }}
/>
<Video src="https://remotion.media/video.mp4" premountFor={fps} />
<AnimatedImage src={staticFile('nyancat.gif')} premountFor={fps} />
</>
);
};
Si la composición es principalmente una línea de tiempo de clips de video o audio, lee video-editing.md antes de elegir su estructura fuente.
Escena de ejemplo
Un video de fondo con un tercio inferior.
El tercio inferior es un componente interactivo con su propia línea de tiempo, registrado como una composición conectada.
Su texto se pasa como children y accentColor es una prop editable.
La aparición gradual se fotograma clave en línea en el sitio de llamada.
// MyScene.tsx
import { Video } from "@remotion/media";
import { Easing, interpolate, useCurrentFrame, useVideoConfig } from "remotion";
import { LowerThird } from "./LowerThird";
export const MyScene = () => {
const { fps } = useVideoConfig();
const frame = useCurrentFrame();
return (
<>
<Video
name="Fondo"
src="https://remotion.media/video.mp4"
premountFor={fps}
objectFit="cover"
style={{
position: "absolute",
width: "100%",
height: "100%",
}}
/>
<LowerThird
name="Tercio inferior"
from={1 * fps}
premountFor={fps}
accentColor="#0b84f3"
style={{
opacity: interpolate(frame, [1 * fps, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Jane Doe, Diseñadora de Producto
</LowerThird>
</>
);
};
// LowerThird.tsx
import type React from "react";
import { Interactive, type InteractivitySchema } from "remotion";
type LowerThirdProps = {
readonly children: string;
readonly accentColor: string;
readonly style?: React.CSSProperties;
};
const LowerThirdInner: React.FC<LowerThirdProps> = ({
children,
accentColor,
style,
}) => {
return (
<Interactive.Div
style={{
position: "absolute",
left: 80,
bottom: 80,
display: "flex",
alignItems: "center",
gap: 20,
backgroundColor: "white",
borderRadius: 16,
padding: "20px 32px",
color: "black",
fontFamily: "Helvetica, Arial, sans-serif",
fontSize: 48,
fontWeight: 600,
...style,
}}
>
<div
style={{
width: 8,
alignSelf: "stretch",
borderRadius: 4,
backgroundColor: accentColor,
}}
/>
{children}
</Interactive.Div>
);
};
const lowerThirdSchema = {
children: { type: "text-content", default: "", description: "Texto" },
accentColor: {
type: "color",
default: "#0b84f3",
description: "Color de acento",
},
} as const satisfies InteractivitySchema;
export const LowerThird = Interactive.withSchema({
Component: LowerThirdInner,
componentName: "<LowerThird>",
schema: lowerThirdSchema,
wrapInSequence: true,
});
// Root.tsx
import { Composition } from "remotion";
import { LowerThird } from "./LowerThird";
import { MyScene } from "./MyScene";
export const RemotionRoot: React.FC = () => {
return (
<>
<Composition
id="MyScene"
component={MyScene}
durationInFrames={60}
fps={30}
width={1280}
height={720}
/>
<Composition
id="LowerThird"
component={LowerThird}
durationInFrames={30}
fps={30}
width={1280}
height={720}
defaultProps={{
children: "Jane Doe, Diseñadora de Producto",
accentColor: "#0b84f3",
}}
/>
</>
);
};
Retrasar, recortar
Coloca la sincronización directamente en los componentes que la soportan. Consulta Props de sincronización para las props compatibles, ejemplos y orden de operaciones.
Mapas
Consulta Mapas de Remotion si deseas incluir mapas en el video.
Resaltados y anotaciones de texto
Consulta text-highlights.md para resaltados de texto (marcadores de resaltado), círculos, subrayados, tachados, texto tachado, recuadros.
Videos de múltiples escenas
Consulta multi-scene-video.md si planeas hacer un video con varias escenas consecutivas.
Composiciones conectadas
Cuando una escena o grupo de capas merezca su propia línea de tiempo editable, sigue connected-compositions.md. Prefiere esta estructura para escenas sustanciales en un video de múltiples escenas.
Acción de precomposición
Para una solicitud de Studio como Pre-compose Resplandor ambiental (src/BarChart.tsx:134), encuentra el marcado de secuencia seleccionado en la ubicación dada. Crea una composición conectada, siguiendo connected-compositions.md: extrae el marcado en un componente con nombre, preferiblemente hazlo interactivo con Interactive.withSchema({wrapInSequence: true}), y registra la misma referencia de componente exportada con un <Composition> único en la raíz. Renderiza el componente interactivo directamente con sus props de sincronización, o como el único hijo de una secuencia cuando ese envoltorio tenga un propósito. Si el nodo seleccionado ya es una secuencia, conserva sus props y extrae sus hijos. El registro necesita dimensiones, fps, duración y defaultProps equivalentes a su uso padre. Una extracción de componente sin una composición registrada no completa una solicitud de precomposición.
Voz en off
Consulta voiceover.md para agregar una voz en off generada por IA a las composiciones de Remotion usando ElevenLabs TTS.
Incrustar videos
Consulta embedding-videos.md para conocimientos avanzados sobre incrustar videos: recorte, volumen, velocidad, bucle, tono.
Incrustar audio
Consulta audio.md para funciones avanzadas de audio como recorte, volumen, velocidad, tono.
Recorte
Consulta cropping.md si necesitas recortar el rectángulo visible de un componente.
Transiciones
Consulta transitions.md para patrones de transición de escenas.
Desenfoque de movimiento
Al agregar desenfoque de movimiento o una estela de movimiento, lee motion-blur.md para conocer el enfoque preferido de HTML en canvas, requisitos de vista previa y alternativas.
Efectos visuales y de píxeles
Al crear un efecto visual, considera si es factible usando CSS y HTML, o si se necesita un sombreador. Orden de preferencia:
- HTML + CSS regular u otras técnicas web
- Un efecto aplicado al elemento directamente (
<Video>,<Img>), o envolviendo el contenido en<HtmlInCanvas>, que también aceptaeffects:
- Un efecto listado a través de effects.md
- Un
createEffect()personalizado a través de effects.md cuando no haya un preajuste disponible.
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 obtener 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 obtener más información.
Mapas
Para mapas estáticos, rutas animadas y marcadores, explicadores geográficos, Mapbox, MapLibre, MapTiler, GeoJSON o sobrevuelos geográficos 3D, carga Mapas de Remotion.
Subtítulos
Al tratar con subtítulos, carga el skill de Subtítulos de Remotion para obtener 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.
Sincronización
Consulta timing.md para más técnicas de sincronización para interpolate().
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 obtener 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 props de la composición.
Composiciones e imágenes fijas
Antes de registrar elementos <Composition> o <Still>, lee compositions.md para registros editables en fuente, carpetas, props predeterminados y anidamiento. Para la navegación del Studio a la línea de tiempo propia de una escena, usa composiciones conectadas.
Secuenciación avanzada
Consulta sequencing.md para más patrones de secuenciación: retraso, recorte, limitar duración de elementos.
Instalar módulos
Usa npx remotion add para agregar nuevos paquetes con la versión correcta:
npx remotion add @remotion/…