Pipeline de publicação de launch video

Vídeo de Lançamento / Walkthrough

Um pipeline repetível para transformar um produto, funcionalidade ou página em um vídeo curto com narração, publicá-lo no YouTube, incorporá-lo na página e anunciá-lo. Ele existe porque fazer isso manualmente significa redescobrir uma dúzia de detalhes não óbvios toda vez (peculiaridades do OAuth, sincronização de voz sobreposta, o embed de clique para reproduzir, metas de loudness).

Saída padrão: um vídeo 1080p / 30fps, ~45–60s, com narração emotiva, enviado como não listado primeiro para o usuário aprovar, depois tornado público. Nunca publique um vídeo publicamente sem que o usuário ouça/veja — vozes e ritmos são subjetivos.

Configure isso para o seu projeto

Antes do primeiro uso, preencha config.md (alguns IDs e caminhos). A skill lê esses valores em vez de valores fixos, então funciona para qualquer produto. Os valores que você precisa:

• Seu canal do YouTube (a conta OAuth deve tê-lo selecionado)
• O caminho do seu segredo do cliente OAuth e o número do projeto GCP (YouTube Data API v3 ativada)
• Para onde vão os anúncios de vídeo finalizado (canal do Slack, Discord, etc.)
• Suas cores da marca e o padrão de URL do produto

Quando usar

Construindo qualquer vídeo para uma página/funcionalidade/ferramenta, adicionando uma narração, ou enviando um vídeo para o YouTube. Para uma solicitação ampla de "adicione vídeos às nossas melhores páginas", puxe as principais páginas primeiro (das suas análises), depois execute este pipeline uma vez por página — pilote uma, obtenha aprovação no formato, depois em lote o restante.

O pipeline (7 etapas)

Trabalhe de cima para baixo. Cada etapa tem detalhes no arquivo ou script referenciado.

1. Entenda o assunto. Leia a implementação / documentação para que as etapas mostradas correspondam ao comportamento real. Para um walkthrough de ferramenta, use a ferramenta ao vivo (Playwright) para ver o fluxo real de entrada→saída — ESSE é o walkthrough.

2. Capture capturas de tela reais. Playwright contra produção, 1920×1080. Oculte banners promocionais / barras de cookies primeiro. Veja references/video-production.md → "Capturando capturas de tela".

3. Construa o vídeo Remotion. Copie a estrutura remotion-scaffold/. As cenas são contadas em quadros a 30fps em src/theme.ts. Dimensione cada cena para sua duração de narração (etapa 4). Padrões completos de cena/animacão em references/video-production.md.

4. Gere a narração. scripts/tts_voiceover.py — OpenAI gpt-4o-mini-tts, voz ash, com um prompt de instructions para emoção (sem ele, a leitura fica plana e robótica — este é o detalhe mais importante da narração). Ele gera clipes por cena, sincroniza-os com o quadro inicial de cada cena e normaliza a loudness da faixa mixada. Reajuste o tempo das cenas em theme.ts se um clipe ultrapassar sua cena, depois re-renderize.

5. Renderize + multiplex + codifique. npx remotion render, multiplex a faixa de narração com ffmpeg (-c:v copy), depois codifique um corte de upload < 10 MB (libx264 -crf 25 -movflags +faststart). Comandos em references/video-production.md → "Renderizar, multiplexar, codificar".

6. Publique no YouTube. scripts/youtube.py (envolve youtubeuploader para o upload, usa a Data API para o resto). Faça upload como não listado, obtenha o OK do usuário, depois defina como público. Leia references/youtube-publishing.md primeiro — tem a configuração de autenticação, a pegadinha do redirecionamento OAuth, a falha de API não ativada, limites de cota, e o modelo de metadados.

7. Incorpore + anuncie. Adicione uma seção de fachada de clique para reproduzir na página (pôster + botão de play; o iframe do YouTube só monta no clique — mantém fora do carregamento inicial). Depois, poste o link no canal da sua equipe. Ambos os padrões em references/embed-and-announce.md.

Salvaguardas

• Não listado → aprovar → público, toda vez. Fazer upload no próprio canal do usuário precisa da aprovação dele.
• O consentimento OAuth do Google é do usuário — você não pode clicar em "Permitir" por ele. Se a autenticação não estiver configurada, guie-o pelo processo (veja references/youtube-publishing.md), não tente contorná-lo.
• Mantenha a renderização mestre; apenas o corte de upload é limitado em tamanho.
• Cota da API do YouTube ≈ 6 uploads / 24h. Um lote maior que isso deve ser distribuído ao longo de dias — diga isso em vez de falhar silenciosamente no meio.
• A CLI não pode definir uma miniatura — avise que o usuário deve adicionar uma no Studio (ou definir via API separadamente).