Este é um guia para escrever marcação React Remotion. Se não for relevante, carregue Remotion Best Practices.
Regras gerais
Anime propriedades usando useCurrentFrame() e interpolate().
Use interpolate() em vez de spring().
Use Easing.bezier() para personalizar o tempo, incluindo movimentos irregulares ou com excesso de movimento.
Use Easing.spring() se quiser animações spring.
Elementos HTML que façam sentido serem interativos no Studio devem usar Interactive: <div> -> <Interactive.Div>.
Defina uma propriedade name descritiva, como name="Título do Herói" para Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Título"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Olá Mundo!
</Interactive.Div>
);
};
Mantenha a chamada interpolate() inline na prop style.
Prefira as propriedades CSS scale, translate, rotate em vez de transform.
// 👍 Keyframes editáveis inline e shorthand de transformação
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Valores ocultos e strings de transformação tornam a edição no Studio mais difícil
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Transições ou animações CSS são PROIBIDAS - elas não serão renderizadas corretamente. Nomes de classes de animação do Tailwind são PROIBIDOS - eles não serão renderizados corretamente.
Coloque os assets na pasta public/ na raiz do seu projeto.
Use staticFile() para referenciar arquivos da pasta public/.
Adicione vídeo e áudio usando @remotion/media.
Adicione imagens usando o componente <Img>.
Use staticFile() para arquivos em public/ ou passe uma URL remota diretamente:
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 atrasar conteúdo, envolva-o em <Sequence> e use from.
Para limitar a duração de um elemento, use durationInFrames de <Sequence>.
<Sequence> por padrão é um preenchimento absoluto cobrindo a cena.
Para conteúdo inline, use layout="none".
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Background">
<Background />
</Sequence>
<Sequence name="Título" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtítulo" 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>;
};
Destaques e anotações de texto
Consulte text-highlights.md para realces de texto (marcadores de destaque), círculos, sublinhados, tachados, texto riscado, caixas e colchetes.
Locução
Consulte voiceover.md para adicionar locução gerada por IA a composições Remotion usando ElevenLabs TTS.
Corte
Consulte trimming.md para padrões de corte - cortar o início ou o fim de animações.
Incorporação de vídeos
Consulte embedding-videos.md para conhecimento avançado sobre incorporação de vídeos - corte, volume, velocidade, loop, pitch.
Edição de vídeo
Consulte video-editing.md para estruturar linhas do tempo de vídeo editáveis no Remotion Studio.
Incorporação de áudio
Consulte audio.md para recursos avançados de áudio como corte, volume, velocidade, pitch.
Transições
Consulte transitions.md para padrões de transição de cena.
Efeitos visuais e de pixel
Ao criar um efeito visual, prefira: 1. animação normal Remotion/HTML/CSS/SVG/filter/blend/mask, 2. um efeito listado via effects.md, incluindo em HTML renderizado através de <HtmlInCanvas>, 3. um createEffect() personalizado via effects.md quando o usuário solicitar um efeito reutilizável/específico do projeto, 4. <HtmlInCanvas onPaint> personalizado via html-in-canvas.md apenas se nenhum efeito se adequar.
Para sobreposições de vazamento de luz, consulte light-leaks.md. Docs: https://www.remotion.dev/docs/effects
Efeitos disponíveis: 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().
Conteúdo 3D
Consulte 3d.md para conteúdo 3D no Remotion usando Three.js e React Three Fiber.
Efeitos sonoros
Quando precisar usar efeitos sonoros, carregue o arquivo ./sfx.md para mais informações.
Visualização de áudio
Quando precisar visualizar áudio (barras de espectro, formas de onda, efeitos reativos a graves), carregue o arquivo ./audio-visualization.md para mais informações.
Legendas
Ao lidar com legendas ou subtítulos, carregue a habilidade Remotion Captions para mais informações.
Google Fonts
É a maneira recomendada de carregar fontes no Remotion. Consulte google-fonts.md para saber como carregar Google Fonts.
Fontes locais
Consulte local-fonts.md para saber como carregar fontes locais.
GIFs
Consulte gifs.md para saber como exibir GIFs sincronizados com a linha do tempo do Remotion.
Imagens avançadas
Consulte images.md para dimensionamento e posicionamento de imagens, caminhos de imagem dinâmicos e obtenção de dimensões de imagem.
Animações Lottie
Consulte lottie.md para incorporar animações Lottie no Remotion.
Temporização avançada
Consulte timing.md para temporização avançada com interpolate e easing Bézier, e springs.
Vídeos parametrizados
Consulte parameters.md para tornar uma composição parametrizável adicionando um esquema Zod.
Medição de nós DOM
Consulte measuring-dom-nodes.md para medir dimensões de elementos DOM no Remotion.
Medição de texto
Consulte measuring-text.md para medir dimensões de texto, ajustar texto a contêineres e verificar overflow.
Usando FFmpeg
Para algumas operações de vídeo, como cortar vídeos ou detectar silêncio, o FFmpeg deve ser usado. Carregue o arquivo ./ffmpeg.md para mais informações.
Detecção de silêncio
Quando precisar detectar e cortar segmentos silenciosos de arquivos de vídeo ou áudio, carregue o arquivo ./silence-detection.md.
Duração, dimensões e dados dinâmicos
Consulte calculate-metadata.md para definir dinamicamente duração, dimensões e props da composição.
Composições avançadas
Consulte compositions.md para saber como definir stills, pastas, props padrão e como aninhar composições.
Sequenciamento avançado
Consulte sequencing.md para mais padrões de sequenciamento - atraso, corte, limite de duração de itens.
Instalar módulos
Use npx remotion add para adicionar novos pacotes com a versão correta:
npx remotion add @remotion/media
Isso vale para pacotes @remotion/*, mediabunny, @mediabunny/* e zod.
Visualizando a marcação
Faça isso apenas se achar que o usuário deseja ver a prévia.
npx remotion studio --no-open
Isso iniciará um processo de longa duração e imprimirá a URL do servidor para a prévia. Se já estiver iniciado, a URL será impressa.
Opcional: verificação de renderização de um quadro
Você pode renderizar um único quadro com a CLI para verificar layout, cores ou temporização. Pule para edições triviais, refatorações puras ou quando já tiver confiança suficiente do Studio ou renderizações anteriores.
npx remotion still [composition-id] --scale=0.25 --frame=30
A 30 fps, --frame=30 é a marca de um segundo (--frame é baseado em zero).