O que Kit de Vídeo Remotion faz?
Visão Geral
Crie vídeos programaticamente usando React e Remotion. Construa modelos de vídeo reutilizáveis como componentes React, renderize-os em MP4/WebM via CLI ou infraestrutura em nuvem e gere vídeos personalizados em escala. Ideal para conteúdo automatizado de redes sociais, visualizações de dados animadas e pipelines dinâmicos de produção de vídeo.
Instruções
Quando um usuário pedir para criar um vídeo programático, determine a tarefa:
Tarefa A: Configurar um projeto Remotion
# Cria um novo projeto Remotion
npx create-video@latest my-video
cd my-video
npm start # Abre o Remotion Studio em http://localhost:3000
Estrutura do projeto:
my-video/
src/
Root.tsx # Registra todas as composições
MyComposition.tsx # Seu componente de vídeo
remotion.config.ts # Configurações de renderização
Tarefa B: Criar uma composição de vídeo
Cada vídeo Remotion é um componente React que usa useCurrentFrame() e useVideoConfig():
import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, spring } from "remotion";
interface MyVideoProps {
title: string;
subtitle: string;
bgColor: string;
}
export const MyVideo: React.FC<MyVideoProps> = ({ title, subtitle, bgColor }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
// Anima o título deslizando para dentro
const titleY = spring({ frame, fps, from: -100, to: 0, durationInFrames: 30 });
// Suaviza o subtítulo após 20 quadros
const subtitleOpacity = interpolate(frame, [20, 40], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: bgColor, justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontSize: 80, color: "white", transform: `translateY(${titleY}px)` }}>
{title}
</h1>
<p style={{ fontSize: 36, color: "rgba(255,255,255,0.8)", opacity: subtitleOpacity }}>
{subtitle}
</p>
</AbsoluteFill>
);
};
Registre a composição em Root.tsx:
import { Composition } from "remotion";
import { MyVideo } from "./MyVideo";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
defaultProps={{ title: "Olá Mundo", subtitle: "Feito com Remotion", bgColor: "#1a1a2e" }}
/>
);
};
Tarefa C: Adicionar legendas animadas no estilo TikTok
import { AbsoluteFill, useCurrentFrame, Sequence } from "remotion";
interface CaptionWord {
text: string;
startFrame: number;
durationInFrames: number;
}
const captions: CaptionWord[] = [
{ text: "Isto", startFrame: 0, durationInFrames: 15 },
{ text: "é", startFrame: 15, durationInFrames: 10 },
{ text: "incrível!", startFrame: 25, durationInFrames: 20 },
];
export const CaptionOverlay: React.FC = () => {
const frame = useCurrentFrame();
const activeWord = captions.find(
(c) => frame >= c.startFrame && frame < c.startFrame + c.durationInFrames
);
return (
<AbsoluteFill style={{ justifyContent: "flex-end", alignItems: "center", paddingBottom: 120 }}>
{activeWord && (
<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,
}}>
{activeWord.text}
</div>
)}
</AbsoluteFill>
);
};
Tarefa D: Renderizar vídeos
# Renderização local via CLI
npx remotion render MyVideo out/video.mp4
# Renderização com propriedades personalizadas
npx remotion render MyVideo out/video.mp4 --props='{"title":"Título Personalizado"}'
# Renderizar um quadro estático (para miniaturas)
npx remotion still MyVideo out/thumbnail.png --frame=45
# Renderizar com codec e qualidade específicos
npx remotion render MyVideo out/video.mp4 --codec=h264 --crf=18
Para renderização em lote em escala:
# Renderizar no AWS Lambda
npx remotion lambda render MyVideo --props='{"title":"Vídeo 1"}'
# Renderizar no Google Cloud Run
npx remotion cloudrun render MyVideo --props='{"title":"Vídeo 1"}'
Tarefa E: Visualizações de dados animadas
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
interface DataPoint { label: string; value: number; color: string; }
export const BarChart: React.FC<{ data: DataPoint[] }> = ({ data }) => {
const frame = useCurrentFrame();
const maxVal = Math.max(...data.map((d) => d.value));
return (
<AbsoluteFill style={{ padding: 80, justifyContent: "flex-end", backgroundColor: "#0f0f23" }}>
<div style={{ display: "flex", alignItems: "flex-end", gap: 20, height: "70%" }}>
{data.map((point, i) => {
const height = interpolate(frame, [i * 10, i * 10 + 30], [0, (point.value / maxVal) * 100], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
return (
<div key={i} style={{ flex: 1, textAlign: "center" }}>
<div style={{
height: `${height}%`,
backgroundColor: point.color,
borderRadius: "8px 8px 0 0",
transition: "height 0.3s",
}} />
<p style={{ color: "white", marginTop: 12, fontSize: 24 }}>{point.label}</p>
</div>
);
})}
</div>
</AbsoluteFill>
);
};
Exemplos
Exemplo 1: Vídeo de boas-vindas personalizado
Solicitação do usuário: "Gere um vídeo de boas-vindas para cada novo usuário com seu nome"
# Gera vídeos a partir de uma lista JSON de usuários
for user in $(jq -r '.[] | @base64' users.json); do
name=$(echo "$user" | base64 -d | jq -r '.name')
npx remotion render WelcomeVideo "out/welcome_${name}.mp4" \
--props="{\"userName\":\"${name}\"}"
done
Exemplo 2: Dashboard de vendas animado
Solicitação do usuário: "Crie um vídeo mostrando nossas métricas trimestrais animando-se"
Construa uma composição usando o componente BarChart com dados trimestrais, renderize com:
npx remotion render SalesDashboard out/q4_report.mp4 \
--props='{"quarter":"Q4","revenue":1250000,"growth":12.5}'
Exemplo 3: Conteúdo de redes sociais com legendas
Solicitação do usuário: "Adicione legendas animadas a um vídeo para o TikTok"
Combine o CaptionOverlay com uma fonte OffthreadVideo:
import { OffthreadVideo } from "remotion";
<AbsoluteFill>
<OffthreadVideo src="https://example.com/clip.mp4" />
<CaptionOverlay />
</AbsoluteFill>
Diretrizes
- Use
useCurrentFrame()einterpolate()para todas as animações; evite transições CSS. - Mantenha as composições puras: passe todos os dados dinâmicos como props para facilitar a renderização em lote.
- Use
<Sequence>para organizar seções da sua linha do tempo de vídeo. - Prefira
<OffthreadVideo>em vez de<Video>para melhor desempenho com fontes de vídeo. - Defina
crf(Constant Rate Factor) entre 16-20 para uma boa relação qualidade-tamanho. - Para renderização no Lambda, mantenha as composições abaixo de 120 segundos para evitar problemas de timeout.
- Teste no Remotion Studio antes de renderizar para detectar problemas de layout cedo.
- Use
staticFile()para referenciar assets na pastapublic/.