Vídeos de Walkthrough do Stitch para Remotion
Você é um especialista em produção de vídeo focado em criar vídeos de walkthrough envolventes a partir de designs de aplicativos. Você combina as capacidades de recuperação de telas do Stitch com a geração programática de vídeos do Remotion para produzir apresentações profissionais e suaves.
Visão Geral
Esta skill permite que você crie vídeos de walkthrough que mostram telas de aplicativos com transições profissionais, efeitos de zoom e sobreposições de texto contextuais. O fluxo de trabalho recupera telas de projetos Stitch e as orquestra em uma composição de vídeo Remotion.
Pré-requisitos
Obrigatório:
- Acesso ao Servidor MCP Stitch
- Acesso ao Servidor MCP Remotion (ou CLI Remotion)
- Node.js e npm instalados
- Um projeto Stitch com telas projetadas
Recomendado:
- Familiaridade com as capacidades de vídeo do Remotion
- Compreensão de componentes React (Remotion usa React)
Recuperação e Rede
Passo 1: Descobrir Servidores MCP Disponíveis
Execute list_tools para identificar os servidores MCP disponíveis e seus prefixos:
- MCP Stitch: Procure por prefixo
stitch:oumcp_stitch: - MCP Remotion: Procure por prefixo
remotion:oumcp_remotion:
Passo 2: Recuperar Informações do Projeto Stitch
-
Busca de projeto (se o ID do Projeto não for fornecido):
- Chame
[stitch_prefix]:list_projectscomfilter: "view=owned" - Identifique o projeto alvo pelo título (ex.: "Calculator App")
- Extraia o ID do Projeto do campo
name(ex.:projects/13534454087919359824)
- Chame
-
Recuperação de telas:
- Chame
[stitch_prefix]:list_screenscom o ID do projeto (apenas numérico) - Revise os títulos das telas para identificar todas as telas do walkthrough
- Extraia os IDs das Telas do campo
namede cada tela
- Chame
-
Busca de metadados da tela: Para cada tela:
- Chame
[stitch_prefix]:get_screencomprojectIdescreenId - Recupere:
screenshot.downloadUrl— Ativo visual para o vídeohtmlCode.downloadUrl— Opcional: para extrair texto/conteúdowidth,height— Dimensões da tela para redimensionamento adequado- Título e descrição da tela para sobreposições de texto
- Chame
-
Download de ativos:
- Use
web_fetchouBashcomcurlpara baixar screenshots - Salve em um diretório de preparação:
assets/screens/{screen-name}.png - Organize os ativos na ordem do fluxo de walkthrough pretendido
- Use
Passo 3: Configurar Projeto Remotion
-
Verificar se existe projeto Remotion:
- Procure por
remotion.config.tsoupackage.jsoncom dependências Remotion - Se existir, use a estrutura de projeto existente
- Procure por
-
Criar novo projeto Remotion (se necessário):
npm create video@latest -- --blank- Escolha o template TypeScript
- Configure em um diretório dedicado
video/
-
Instalar dependências:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estratégia de Composição de Vídeo
Arquitetura
Crie uma composição Remotion modular com estes componentes:
-
ScreenSlide.tsx— Componente de exibição de tela individual- Props:
imageSrc,title,description,width,height - Funcionalidades: Animação de zoom, transições de fade
- Duração: Configurável (padrão de 3 a 5 segundos por tela)
- Props:
-
WalkthroughComposition.tsx— Composição principal do vídeo- Sequência múltiplos componentes
ScreenSlide - Gerencia transições entre telas
- Adiciona sobreposições de texto e anotações
- Sequência múltiplos componentes
-
config.ts— Configuração do vídeo- Taxa de quadros (padrão: 30 fps)
- Dimensões do vídeo (corresponder às dimensões da tela Stitch ou redimensionar adequadamente)
- Cálculo da duração total
Efeitos de Transição
Use @remotion/transitions para efeitos profissionais:
-
Fade: Transição suave de cross-fade entre telas
import { fade } from '@remotion/transitions/fade'; -
Slide: Transições de deslizamento direcional
import { slide } from '@remotion/transitions/slide'; -
Zoom: Efeitos de zoom para ênfase
- Use animação
spring()para zoom suave - Aplique a elementos importantes da interface
- Use animação
Sobreposições de Texto
Adicione informações contextuais usando a renderização de texto do Remotion:
- Títulos das telas: Exiba na parte superior ou inferior de cada quadro
- Destaques de funcionalidades: Destaque elementos específicos da interface com indicadores animados
- Descrições: Faça o fade-in de texto descritivo para cada tela
- Indicador de progresso: Mostre a posição atual da tela no walkthrough
Passos de Execução
Passo 1: Coletar Ativos das Telas
- Identifique o projeto Stitch alvo
- Liste todas as telas do projeto
- Baixe screenshots para cada tela
- Organize na ordem do fluxo de walkthrough
- Crie um arquivo de manifesto (
screens.json):
{
"projectName": "Calculator App",
"screens": [
{
"id": "1",
"title": "Tela Inicial",
"description": "Interface principal da calculadora com teclado numérico",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Visualização do Histórico",
"description": "Visualização de cálculos anteriores",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Passo 2: Gerar Componentes Remotion
Crie os componentes de vídeo seguindo as melhores práticas do Remotion:
-
Crie
ScreenSlide.tsx:- Use
useCurrentFrame()espring()para animações - Implemente efeitos de zoom e fade
- Adicione sobreposições de texto com temporização adequada
- Use
-
Crie
WalkthroughComposition.tsx:- Importe o manifesto de telas
- Sequencie as telas com componentes
<Sequence> - Aplique transições entre telas
- Calcule temporização e deslocamentos adequados
-
Atualize
remotion.config.ts:- Defina o ID da composição
- Configure as dimensões do vídeo
- Defina a taxa de quadros e duração
Recursos de Referência:
- Use
resources/screen-slide-template.tsxcomo ponto de partida - Siga
resources/composition-checklist.mdpara completude - Revise exemplos no diretório
examples/walkthrough/
Passo 3: Visualizar e Refinar
-
Inicie o Remotion Studio:
npm run dev- Abre uma pré-visualização baseada em navegador
- Permite edição e refinamento em tempo real
-
Ajuste a temporização:
- Garanta que cada tela tenha duração de exibição adequada
- Verifique se as transições são suaves
- Verifique a temporização das sobreposições de texto
-
Ajuste fino das animações:
- Ajuste as configurações de
springpara efeitos de zoom - Modifique as funções de easing para transições
- Garanta que o texto seja legível o tempo todo
- Ajuste as configurações de
Passo 4: Renderizar Vídeo
-
Renderizar usando CLI do Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usar MCP do Remotion (se disponível):
- Chame
[remotion_prefix]:rendercom detalhes da composição - Especifique o formato de saída (MP4, WebM, etc.)
- Chame
-
Opções de otimização:
- Defina o nível de qualidade (
--quality) - Configure o codec (
--codec h264ouh265) - Ative a renderização paralela (
--concurrency)
- Defina o nível de qualidade (
Funcionalidades Avançadas
Hotspots Interativos
Destaque elementos clicáveis ou funcionalidades importantes:
import { interpolate, useCurrentFrame } from 'remotion';
const Hotspot = ({ x, y, label }) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: { damping: 10, stiffness: 100 },
});
return (
<div
style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`,
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
Integração de Narração
Adicione narração ao walkthrough:
- Gere um roteiro de narração a partir das descrições das telas
- Use texto-para-fala ou grave áudio
- Importe áudio no Remotion com o componente
<Audio> - Sincronize a temporização da tela com o ritmo da narração
Extração Dinâmica de Texto
Extraia texto do código HTML do Stitch para anotações automáticas:
- Baixe
htmlCode.downloadUrlpara cada tela - Analise o HTML para extrair elementos de texto chave (cabeçalhos, botões, rótulos)
- Gere destaques automáticos para elementos importantes da interface
- Adicione à composição como sobreposições de texto temporizadas
Estrutura de Arquivos
project/
├── video/ # Diretório do projeto Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Screenshots baixados do Stitch
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifesto de telas
└── output.mp4 # Vídeo renderizado
Integração com Skills do Remotion
O Remotion mantém suas próprias Skills de Agente que definem as melhores práticas. Consulte estas para técnicas avançadas:
- Repositório: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalação:
npx skills add remotion-dev/skills
Skills chave do Remotion a serem aproveitadas:
- Temporização e easing de animação
- Padrões de arquitetura de composição
- Otimização de desempenho
- Sincronização de áudio
Padrões Comuns
Padrão 1: Apresentação de Slides Simples
Walkthrough básico com transições de fade:
- 3 a 5 segundos por tela
- Transições de cross-fade
- Sobreposição de texto na parte inferior com título da tela
- Barra de progresso no topo
Padrão 2: Destaque de Funcionalidades
Foco em elementos específicos da interface:
- Zoom em regiões específicas
- Círculos/setas animados apontando para funcionalidades
- Ênfase em câmera lenta em interações chave
- Comparações lado a lado antes/depois
Padrão 3: Fluxo do Usuário
Mostre a jornada do usuário passo a passo:
- Fluxo sequencial de telas com slides direcionais
- Sobreposição de etapas numeradas
- Destaque de ações do usuário (cliques, toques)
- Conecte telas com caminhos animados
Solução de Problemas
| Problema | Solução |
|---|---|
| Screenshots borrados | Garanta que as imagens baixadas estejam em resolução total; verifique as configurações de qualidade de screenshot.downloadUrl |
| Texto desalinhado | Verifique se as dimensões da tela correspondem ao tamanho da composição; ajuste o posicionamento do texto com base no tamanho real da tela |
| Animações irregulares | Aumente a taxa de quadros para 60 fps; use configurações adequadas de spring com damping apropriado |
| Falha na compilação Remotion | Verifique a compatibilidade da versão do Node; garanta que todas as dependências estejam instaladas; revise a documentação do Remotion |
| Temporização estranha | Ajuste a duração por tela no manifesto; visualize no Remotion Studio; teste com usuários reais |
Melhores Práticas
- Mantenha a proporção: Use as dimensões reais da tela Stitch ou redimensione proporcionalmente
- Temporização consistente: Mantenha a duração de exibição das telas consistente, a menos que esteja enfatizando telas específicas
- Texto legível: Garanta contraste suficiente; use tamanhos de fonte adequados; evite sobreposições poluídas
- Transições suaves: Use animações
springpara movimento natural; evite cortes bruscos - Visualize completamente: Sempre visualize no Remotion Studio antes da renderização final
- Otimize ativos: Comprima imagens adequadamente; use formatos eficientes (PNG para UI, JPG para fotos)
Exemplo de Uso
Prompt do usuário:
Procure as telas do meu projeto Stitch "Calculator App" e crie um vídeo remotion
que mostre um walkthrough das telas.
Fluxo de trabalho do agente:
- Liste projetos Stitch → Encontre "Calculator App" → Extraia o ID do projeto
- Liste telas no projeto → Identifique todas as telas (Home, History, Settings)
- Baixe screenshots para cada tela → Salve em
assets/screens/ - Crie o manifesto
screens.jsoncom metadados das telas - Gere componentes Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Visualize no Remotion Studio → Refine temporização e transições
- Renderize o vídeo final →
calculator-walkthrough.mp4 - Relate a conclusão com link de pré-visualização do vídeo
Dicas para o Sucesso
- Comece simples: Inicie com transições de fade básicas antes de adicionar animações complexas
- Siga os padrões Remotion: Aproveite as skills e documentação oficiais do Remotion
- Use arquivos de manifesto: Mantenha os dados das telas organizados em JSON para atualizações fáceis
- Visualize com frequência: Use o Remotion Studio para detectar problemas cedo
- Considere acessibilidade: Adicione legendas; garanta que o texto seja legível; use visuais claros
- Otimize para a plataforma: Corresponda as dimensões do vídeo à plataforma alvo (YouTube, redes sociais, etc.)
Referências
- Documentação do Stitch: https://stitch.withgoogle.com/docs/
- Documentação do Remotion: https://www.remotion.dev/docs/
- Skills do Remotion: https://www.remotion.dev/docs/ai/skills
- MCP do Remotion: https://www.remotion.dev/docs/ai/mcp
- Transições do Remotion: https://www.remotion.dev/docs/transitions