O que Remotion Controls Skill faz?
Habilidade profissional para criar animações vetoriais com código. Remotion é um framework de criação de vídeo baseado em React que permite controle preciso sobre cada frame, com suporte nativo a renderização com fundo transparente.
Capacidades Principais
| Capacidade | Descrição |
|---|---|
| Renderização com fundo transparente | Suporte nativo ao canal Alpha, saída para WebM (VP9) / MOV (ProRes 4444) com transparência |
| Controle preciso por código | Controle exato de posição, escala, rotação, opacidade e curvas de easing com React/TypeScript |
| Serviço via API | API HTTP que recebe instruções de animação e produz arquivos de vídeo |
| Biblioteca de templates | Modelos de animação pré-definidos (animação de personagens, UI, texto, transições) |
| Controle de qualidade | Detecção automática de taxa de quadros, resolução, bitrate e integridade do canal Alpha |
| Auto-aprendizagem | Registro de parâmetros de renderização e pontuação de efeito, otimização de parâmetros pré-definidos |
Diferenciação em relação ao ComfyUI / Blender
| Skill | Principal vantagem | Cenários de uso |
|---|---|---|
| ComfyUI-controls | Geração por IA (imagem/vídeo/áudio), criatividade imprevisível | Geração de imagens de personagens/cenas, efeitos especiais de vídeo |
| Blender-controls | Animação 3D, simulação física, renderização de alta qualidade | Animação 3D de personagens, exibição de produtos, efeitos físicos |
| Remotion-controls | Animação 2D por código, precisão, fundo transparente | Ativos de animação para templates, animações de UI, tipografia, animação 2D de personagens |
Início Rápido
1. Instalar dependências
cd remotion-project
npm install
2. Renderizar vídeo com fundo transparente
# Via CLI
npx remotion render src/index.ts MyComp out/video.webm --transparent
# Via API
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent
3. Iniciar servidor da API
python remotion_controls.py serve --port 8765
Renderização com fundo transparente (fluxo verificado)
Remotion tem suporte nativo a fundo transparente, mas a flag --transparent da CLI perde o canal Alpha (verificado para WebM VP8/VP9 e MOV ProRes).
Fluxo correto verificado (PIT-024):
- Renderizar sequência PNG:
npx remotion render src/index.ts Composition out/frames --sequence(gera PNGs com canal Alpha) - Sintetizar com ffmpeg para ProRes 4444:
ffmpeg -y -framerate 30 -i out/frames/%04d.png \ -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \ out/animation.mov - Verificar canal Alpha:
python verify_animation.py out/animation.mov
Observações para integração com CapCut (PIT-024):
add_media_safeao importar ProRes 4444 mov transcodifica para H.264 mp4, perdendo o canal Alpha (66MB → 0.07MB)- Deve-se importar manualmente: copiar o mov diretamente para o diretório materials do rascunho → criar VideoMaterial → registrar em materials.videos → VideoSegment(material=anim_material) → add_segment
Padrão de qualidade para ativos de animação
Padrão completo em QUALITY_STANDARD.md.
Critérios obrigatórios para ativos de animação aprovados:
- Canal Alpha preservado (yuva444p12le)
- Codificação ProRes 4444 (profile=4)
- Resolução/taxa de quadros/duração consistentes com a configuração
- Cobertura de conteúdo ≥ 50% (amostragem de 10 pontos)
- Tamanho de arquivo razoável (≤15MB/segundo)
Verificação automatizada:
python verify_animation.py <arquivo de animação> --duration 20 --width 1080 --height 1920
Biblioteca de componentes de animação base
Localizada em remotion-project/src/components/, todos os componentes suportam fundo transparente.
Componentes de personagens e movimento
| Componente | Descrição |
|---|---|
| CharacterSprite | Sprite de personagem: múltiplas posturas, animação com keyframes de posição/escala/rotação/opacidade |
| MotionPath | Caminho de movimento: movimento linear/bezier/elástico/quique |
| FlashEffect | Efeito de flash branco: fade in rápido e fade out lento |
| ShakeEffect | Efeito de vibração: vibração aleatória com amplitude decrescente |
| FadeEffect | Fade in/out: duração controlável de fade in/fade out |
| PopEffect | Efeito de pop: escala elástica com pop |
| SlideEffect | Efeito de deslizamento: deslizamento suave em quatro direções |
Componentes de animação de texto (TextAnimations.tsx)
| Componente | Descrição | Cenários de uso |
|---|---|---|
| TextReveal | Revelação caractere por caractere: máquina de escrever/fade in/deslizar para cima/esquerda | Narração, falas, entrada de títulos |
| TextPop | Texto com pop: escala/rotação/quique | Destaque de palavras-chave, marcação de ritmo |
| TextWave | Texto ondulado: flutuação senoidal caractere por caractere | Estilo divertido, ritmo de música de fundo |
| TextGlitch | Estilo glitch: separação RGB + tremor | Estilo tecnológico, arte glitch, transições |
| TextGradient | Gradiente fluido: fluxo de cores + luz varrida | Títulos, nomes de marca, elegância |
| KineticText | Tipografia cinética: animação combinada de múltiplas linhas | Títulos de abertura, créditos finais |
Componentes de transição (TransitionEffects.tsx)
| Componente | Descrição | Cenários de uso |
|---|---|---|
| FadeTransition | Transição fade in/out (in/out/inOut) | Transição geral, mudança de emoção |
| SlideTransition | Transição com deslizamento (cima/baixo/esquerda/direita) | Troca de cena, substituição de conteúdo |
| ZoomTransition | Transição com zoom (aproximar/afastar) | Ênfase em detalhes, aproximação de câmera |
| WipeTransition | Transição com wipe (cima/baixo/esquerda/direita/diagonal) | Transição criativa, estilizada |
| BlurTransition | Transição com desfoque (primeiro desfocado, depois nítido) | Transição onírica, flashback |
| GlitchTransition | Transição glitch (separação RGB + linhas de varredura) | Estilo tecnológico, arte glitch |
Componentes de efeitos de impacto (ImpactEffects.tsx)
| Componente | Descrição | Cenários de uso |
|---|---|---|
| PunchImpact | Impacto de soco (onda de choque + estrelas + flash branco) | Luta, golpe, colisão |
| ImpactFlash | Flash de impacto (flash branco rápido) | Golpe forte, explosão, marcação de ritmo |
| ParticleBurst | Explosão de partículas (estrelas/faíscas/fragmentos) | Comemoração, explosão, impacto |
| Shockwave | Onda de choque (anéis múltiplos em expansão) | Liberação de energia, explosão, vibração |
| SpeedLines | Linhas de velocidade (radiais) | Impacto de alta velocidade, corrida, combo |
Exemplo de uso:
import { PunchImpact, ParticleBurst, FadeTransition } from "./components";
// Cena de luta
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />
Exemplo de uso:
import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";
<CharacterSprite
poses={[
{ name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
{ name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
]}
width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="Fui atingido!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="Dor!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />
Estrutura do projeto
remotion-controls-skill/
├── SKILL.md # Este arquivo
├── QUALITY_STANDARD.md # Padrão de qualidade para ativos de animação
├── verify_animation.py # Ferramenta de verificação automatizada
├── remotion_controls.py # Script de controle principal (CLI/API)
├── .env.example # Exemplo de variáveis de ambiente
├── .gitignore
├── capabilities/
│ ├── cap_api_wrapper/ # Encapsulamento da API Remotion
│ ├── cap_animation_renderer/ # Renderizador de animações
│ ├── cap_template_library/ # Biblioteca de templates de animação
│ ├── cap_quality_control/ # Controle de qualidade
│ └── cap_self_evolution/ # Auto-aprendizagem
├── remotion-project/ # Projeto Remotion
│ ├── src/
│ │ ├── components/ # Biblioteca de componentes de animação base
│ │ │ ├── CharacterSprite.tsx
│ │ │ ├── MotionPath.tsx
│ │ │ ├── Effects.tsx
│ │ │ └── index.ts
│ │ ├── AnimationTemplate.tsx # Template de animação orientado por JSON
│ │ ├── Root.tsx
│ │ └── index.ts
│ ├── public/ # Ativos estáticos (imagens de personagens/props)
│ └── package.json
└── out/ # Saída de renderização
Módulos de Capacidade
cap_api_wrapper — Encapsulamento da API Remotion
render_media(): Renderizar vídeo (com suporte a fundo transparente)render_still(): Renderizar imagem de um frameselect_composition(): Obter lista de Compositions disponíveisget_props_schema(): Obter definição de Props de uma Composition
cap_animation_renderer — Renderizador de animações
- Entrada: JSON de instruções de animação → Saída: Vídeo com fundo transparente
- Suporte a animação com keyframes (posição/escala/rotação/opacidade)
- Suporte a curvas de easing (ease-in/ease-out/ease-in-out/linear/spring)
- Suporte a composição de múltiplas camadas
cap_template_library — Biblioteca de templates de animação
- Template de animação de personagens (Doubao sendo atingido, troca de expressão, etc.)
- Template de animação de UI (clique de botão, troca de página, etc.)
- Template de animação de texto (máquina de escrever, fade in/out, quique, etc.)
- Template de transição (fade in/out, deslizamento, zoom, etc.)
cap_quality_control — Controle de qualidade
- Detecção de taxa de quadros (24/30/60fps)
- Detecção de resolução (1080p/4K)
- Detecção de integridade do canal Alpha
- Comparação da duração do vídeo com o esperado
- Verificação de tamanho de arquivo razoável
cap_self_evolution — Auto-aprendizagem
- Registro de parâmetros de renderização e pontuação de efeito
- Otimização de parâmetros pré-definidos
- Geração de documentos de melhores práticas
- Ranking de efeitos de templates
Variáveis de Ambiente
REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765
Integração com ai-video-editor
Remotion-controls-skill atua como ferramenta de criação de ativos de animação para o ai-video-editor:
- O mecanismo de direção do ai-video-editor gera instruções de animação
- Remotion-controls-skill recebe as instruções e renderiza vídeos com fundo transparente
- O vídeo com fundo transparente é usado como camada de ativo de animação de template no CapCut
- Após o usuário substituir o fundo, a animação é perfeitamente sobreposta
Observações
- Remotion requer Node.js 18+
- Para vídeos com fundo transparente, recomenda-se o formato WebM (boa compatibilidade com CapCut)
- Renderização de vídeos longos é demorada; recomenda-se renderizar em segmentos e depois compor
- Evitar o uso de filtros CSS em animações (alguns filtros não suportam fundo transparente)