O que Habilidades de Geração de Vídeo Remotion faz?
O App Factory inclui um pipeline integrado de vídeo Remotion para gerar vídeos de demonstração das aplicações criadas.
Quando Esta Habilidade se Aplica
- Trabalhar com arquivos no diretório
demo-video/ - Executar o comando
/factory video - Criar ou modificar composições Remotion
- Depurar problemas de renderização de vídeo
- Entender animações baseadas em quadros (frames)
Estrutura do Projeto
demo-video/
├── src/
│ ├── index.ts # Ponto de entrada Remotion
│ ├── Root.tsx # Registro de composições
│ ├── compositions/
│ │ └── AppFactoryDemo.tsx # Vídeo de demonstração principal (10s, 1920x1080)
│ └── components/
│ ├── Title.tsx # Título animado
│ ├── BulletPoints.tsx # Destaques escalonados
│ ├── VerificationBadge.tsx # Selo PASS
│ └── Footer.tsx # Timestamp UTC
├── remotion.config.ts # Configuração Remotion
└── package.json # Dependências (Remotion v4.x)
Regras Críticas (DEVEM SEGUIR)
1. Apenas Animações Baseadas em Quadros
// CORRETO: Use useCurrentFrame() para todas as animações
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
// PROIBIDO: Animações/transições CSS
// Nunca use: animation:, transition:, @keyframes
2. Interpolar com Clamping
// SEMPRE use clamping de extrapolação
const value = interpolate(frame, [0, 60], [0, 100], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
3. Animações Spring
// Use spring() para animações baseadas em física
const springValue = spring({
fps,
frame,
config: { damping: 200, stiffness: 100 },
durationInFrames: 40,
});
4. Requisitos de Determinismo
- Timestamps DEVEM ser props de entrada, nunca
new Date() - Use
timeZone: 'UTC'para toda formatação de data - Sem
Math.random()ou valores não determinísticos - Mesmas props devem produzir saída de vídeo idêntica
5. Estrutura de Componentes
// Todas as composições devem seguir este padrão
export const MyComposition: React.FC<Props> = (props) => {
const frame = useCurrentFrame();
const { fps, width, height, durationInFrames } = useVideoConfig();
return (
<AbsoluteFill style={{ backgroundColor: '#000' }}>
{/* Conteúdo sequenciado */}
<Sequence from={0} durationInFrames={60}>
<Scene1 />
</Sequence>
<Sequence from={60} durationInFrames={60}>
<Scene2 />
</Sequence>
</AbsoluteFill>
);
};
Integração com Pipeline
Fluxo de Auto-Geração
- A verificação Local Run Proof é executada
RUN_CERTIFICATE.jsoné criado comstatus: "PASS"- O hook aciona
post-run-certificate-video.mjs - O vídeo de demonstração é renderizado em
demo/out/<slug>.mp4
Renderização Manual
# Uso básico
node scripts/render-demo-video.mjs --cwd ./my-app --slug my-app
# Com destaques personalizados
node scripts/render-demo-video.mjs \
--cwd ./my-app \
--slug my-app \
--title "Minha App Incrível" \
--highlights '["Funcionalidade 1", "Funcionalidade 2", "Funcionalidade 3"]'
Esquema de Props
interface AppFactoryDemoProps {
title: string; // Nome da app
slug: string; // Identificador seguro para URL
verifiedUrl: string; // URL localhost que passou na verificação de saúde
timestamp: string; // Timestamp ISO 8601 (UTC)
highlights: string[]; // 4-6 pontos de destaque
certificateHash: string; // SHA256 do RUN_CERTIFICATE.json
}
Depuração
# Pré-visualizar no Remotion Studio
cd demo-video && npm run studio
# Renderizar composição específica
npx remotion render src/index.ts AppFactoryDemo output.mp4
# Verificar erros de TypeScript
npx tsc --noEmit
Padrões Comuns
Fade In/Out
const fadeIn = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
const fadeOut = interpolate(frame, [duration - 30, duration], [1, 0], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
const opacity = fadeIn * fadeOut;
Animação Escalonada
items.map((item, index) => {
const delay = index * 10; // 10 quadros entre cada
const itemOpacity = interpolate(
frame,
[delay, delay + 20],
[0, 1],
{ extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }
);
return <Item key={index} style={{ opacity: itemOpacity }} />;
});
Escala com Spring
const scaleSpring = spring({
fps,
frame: frame - startFrame,
config: { damping: 80, stiffness: 200 },
});
const scale = interpolate(scaleSpring, [0, 1], [0.8, 1]);
Códigos de Erro
| Código | Significado | Resolução |
|---|---|---|
| FAC-006 | Falha na renderização do vídeo | Verificar logs do Remotion, confirmar ffmpeg instalado |
| FAC-007 | Certificado ausente | Executar Local Run Proof primeiro |
| FAC-008 | Falha na validação de props | Verificar se os tipos das props correspondem ao esquema |