Videolu siteler
Objetivo: Que o vídeo faça parte do mundo visual do site; colocar um vídeo de apresentação na página não atende a esta tarefa. Primeiro, a composição da página e o movimento são projetados juntos; depois, o vídeo é produzido para aquela composição.
O usuário fornece apenas as decisões de design. A produção, download, compressão, integração e controle são executados por você; não delegue etapas técnicas rotineiras ao usuário.
1. Entrevista de design
Faça as perguntas em uma única mensagem, numeradas e com opções; escreva ao lado de cada pergunta o padrão sugerido para que o usuário possa responder resumidamente como "tudo padrão" ou "2: impactante, 5: direto". Pule perguntas já respondidas no pedido do usuário; não pergunte novamente sobre uma preferência já expressa (ex.: "não quero teste") em vídeos futuros. Use a ferramenta de pergunta, se disponível (caixa de pergunta com opções).
- Tema e objetivo — Para que serve o site, quem vai visitá-lo? (uma frase é suficiente)
- Caráter do vídeo (nível de criatividade)
- Sutil: imperceptível, atmosfera calma (vapor, deslocamento de luz, leve movimento de folhas); o texto está sempre em primeiro plano. Padrão.
- Equilibrado: movimento perceptível, mas suave; câmera lenta, jogo de textura e luz.
- Impactante: cinematográfico; luz forte, movimento de câmera nítido, transformação dramática. Mais escurecimento/máscara necessários para legibilidade do texto.
- Localização do vídeo (pode selecionar mais de um)
- Apenas plano de fundo da seção principal (hero). Padrão.
- Planos de fundo de seções: ex.: cenas separadas para as seções sobre, produto, contato.
- Transições entre seções: pequenos vídeos de transição de uma cena para outra ao rolar.
- Pequenos loops em cartões/galeria: movimentos pequenos e silenciosos em cartões de produto ou serviço.
- Atmosfera e paleta — ex.: luz quente da manhã, néon escuro, tons terrosos naturais, cores da marca. Se não souber, sugira com base no tema.
- Método de produção
- Teste primeiro: cada cena é produzida primeiro como um teste curto e barato em 360p; após aprovação, qualidade final. Seguro, um pouco mais de crédito no total. Padrão.
- Qualidade final direta: pula o teste, produz diretamente em 720p. Rápido; se não for aprovado, a reprodução custa o valor total.
- Qualidade e orientação — 720p (padrão) ou download com upscale de 720p para 1080p (pode exigir assinatura); horizontal 16:9 (padrão), também é necessário vertical 9:16 para dispositivos móveis?
- Itens obrigatórios — logotipo, textos, lista de seções, idioma, destino de publicação (se não houver, site estático).
Após as respostas, mostre um único plano curto; se o usuário aprovar ou disser "continuar", vá para a produção:
- Ideia de design (um parágrafo).
- Lista de cenas: para cada cena, local, breve descrição, duração, resolução, créditos estimados.
- Total estimado de créditos e comparação com a cota gratuita diária (50 créditos/dia). Se exceder a cota total, ofereça opções: reduzir o número de cenas, fazer algumas em 360p/curtas, distribuir a produção ao longo dos dias ou usar créditos de assinatura.
Direção de design: pareça projetado, não produzido
Regras detalhadas e mensuráveis estão no arquivo references/tasarim-kurallari.md: leia as seções 1–6 antes de escrever o plano de tokens, e as seções 7–9 ao escrever o código; antes de entregar, aplique a lista de verificação final com capturas de tela. As "regras básicas" não são negociáveis, a menos que o usuário explicitamente peça o contrário.
Determine a direção da página antes do vídeo; o vídeo serve a essa direção. Apresente ao usuário 2–3 direções com paleta (4–6 hexadecimais nomeados), família tipográfica, estrutura da página e plano de vídeo (número de cenas + créditos); recomende uma e deixe-o escolher. Se o usuário já escolheu uma direção, não pergunte novamente.
- Comece pelo próprio mundo do tema. Materiais, processo, local, as próprias palavras do assunto. Para uma oficina de cerâmica, algo como "rosa do tufo, cinza da argila molhada, brasa do forno"; adjetivos vagos como "quente e natural" que servem para qualquer assunto não são uma direção.
- Faça do vídeo o portador da história, não um adereço. As montagens mais fortes:
- Filme de rolagem: a página é a narrativa de um processo (matéria-prima → produção → resultado); cada seção é uma cena, o vídeo avança com a rolagem. Primeira opção para qualquer assunto com processo (artesanato, culinária, produção, viagem).
- Parede de amostras vivas: variedades de produtos/materiais são mostradas em pequenos loops (esmalte, tecido, grão de café).
- Montagem de tempo/lugar: as seções seguem as horas do dia ou os lugares do espaço; a luz do vídeo muda de acordo.
- Atmosfera única: apenas para um pedido realmente simples.
- Um único elemento ousado. Gaste sua ousadia em um lugar (filme de rolagem, um título enorme, um momento de cor); o resto deve permanecer calmo e disciplinado. Use a cor de destaque apenas onde fizer sentido (ex.: laranja brasa apenas na cena do forno).
- Padrões prontos a evitar (a menos que o usuário explicitamente os peça): fundo creme + serifa grossa + destaque tijolo/terracota; fundo preto + único destaque verde ácido/vermelho; sequências idênticas de cartões redondos com a mesma sombra cinza; etiqueta pequena em maiúsculas com espaçamento acima do título ("eyebrow"); linhas de metadados unidas por ponto como "A · B · C"; seta "→" colada no texto do link; tornar uma única palavra em itálico/colorida no título; faixa de estatística inventada ("100% · 1000 °C · 6 rodas"), comentário inventado, parede de logotipos; gradiente roxo-azul, cartão dentro de cartão, emoji no lugar de ícone; animações que deslizam para cada seção. Numeração (01/02/03) apenas se o conteúdo for realmente sequencial.
- Texto: Uma família de títulos escolhida especificamente para o assunto (não alcançar as mesmas fontes em todo projeto), no máximo duas famílias; comprimento de linha de 45–75 caracteres (ideal ~65); corpo ≥16px, entrelinha 1.5–1.65. Texto em formato de frase, simples, no idioma do usuário final; o botão deve dizer o que faz ("Inscreva-se no curso", não "Enviar").
- Não coloque informações falsas. Preço, telefone, comentário, número de clientes não fornecidos: invente; use domínio de exemplo (
.example) ou "fale conosco", avise no rodapé que é um site de exemplo. - Primeiro o plano, depois o teste. Antes de escrever o código, faça um breve plano de tokens (cor, fonte, layout, princípios) e pergunte: "Este plano seria o mesmo para outro site semelhante?" Se sim, mude essa parte. Durante a construção, tire capturas de tela e critique-se; antes de terminar, remova um enfeite.
Determine o número de cenas com base no layout: apenas hero → 1; planos de fundo de seção → 1 por seção (no máximo 4–5); transições → clipes curtos de 3–5 seg; loops de cartão → 3–4 seg, 360p geralmente é suficiente (exibido pequeno).
2. Produção de vídeo (flow-video MCP)
- Chame
flow_status. SeloggedIn=false, repita amessageretornada exatamente para o usuário (é o primeiro login, verificação de senha solicitada ocasionalmente pelo Google, confirmação por telefone?), depois chameflow_login: traz a janela do Flow para frente e aguarda o usuário terminar. Nunca insira a senha, código ou confirmação você mesmo; não tente abrir a aba do Flow com sua própria ferramenta de navegador (a sessão existe apenas no perfil Chrome da ferramenta). - Escreva o prompt em inglês; descreva separadamente: cena/sujeito, câmera, luz, paleta, área a ser deixada vazia para texto (como
empty left third for headline), movimento,no text, no logos. De acordo com o caráter selecionado:- Sutil:
static camera,subtle, slow, continuous, loop-friendly motion, baixo contraste, luz calma. - Equilibrado:
slow dolly/pan, movimento perceptível mas suave, mudança de luz e textura. - Impactante:
cinematic,dramatic lighting, movimento de câmera nítido ou transformação (ex.:camera pushes through,light sweeps across); ainda assim, peça área de texto e início/fim adequados para loop. - Transição de seção: o quadro inicial deve combinar com a paleta da seção anterior, o quadro final com a da próxima.
- Cenas do mesmo site: repita a paleta comum, direção da luz e frase de estilo em cada prompt para que a série pareça consistente.
- Sutil:
- De acordo com o método de produção escolhido pelo usuário:
- Teste primeiro:
resolution: "360p",seconds: 4. Analise o resultado você mesmo (verifique abaixo); corrija no prompt o que não gostou. Se estiver bom, produza com o mesmo prompt em720pe a duração necessária (geralmente 8 seg). Não precisa mostrar o teste ao usuário; pergunte apenas se for necessária uma mudança de direção evidente. - Qualidade final direta: produza diretamente em
720pe com a duração planejada. Se o resultado tiver defeitos claros na verificação (área de texto preenchida, texto/logotipo indesejado, assunto errado), reproduza uma vez com o prompt corrigido e informe o usuário; se o crédito da segunda produção exceder o plano, pergunte primeiro. - Se houver várias cenas, produza e verifique primeiro a cena hero; se o estilo funcionar, produza as outras com a mesma frase de estilo.
- Para filme de rolagem, comece os prompts com "Scene N of a short film about …" e repita exatamente o local, direção da luz, paleta e frase da câmera em cada cena; as cenas parecerão ocorrer no mesmo lugar. Cenas de 3–5 seg são suficientes.
- Teste primeiro:
- Se ocorrer
TIMEOUTou erro de download, não reproduza o mesmo prompt: na maioria das vezes, o vídeo já foi produzido no Flow; reproduzir gastaria o crédito duas vezes. Chameflow_downloadcom a URL do projeto da mensagem de erro (não gasta crédito); se retornarNOT_READY, aguarde um pouco e tente novamente. Apenas se não houver vídeo no projeto, reproduza. - Após a entrega, meça cada arquivo com
ffprobee monte a edição com base na duração real. A ferramenta define e verifica a duração no Flow; se uma duração inválida for solicitada, retornaOPTION_UNAVAILABLE(a faixa geralmente é de 3 a 15 seg). - Sempre forneça
outDir(pastamedia/srcdo site; o arquivo bruto permanece lá como mestre); se não fornecido, os arquivos caem na pasta onde o agente está trabalhando no momento. - Consciência de crédito: a conta gratuita recebe 50 créditos por dia; 720p ≈ 3 créditos/seg, 360p ≈ 1 crédito/seg. Se você exceder o limite
maxCredits, informe o custo ao usuário e obtenha aprovação. Se o crédito diário acabar, diga isso claramente; não mude silenciosamente para outro serviço pago. - Códigos de erro:
LOGIN_REQUIRED→ solicite login do usuário;OVER_BUDGET→ aprovação;GENERATION_FAILED→ suavize o prompt (geralmente conteúdo de pessoa/marca real ou violência) e tente novamente uma vez;TIMEOUT→ item 4 acima.
3. Verifique e prepare o vídeo para a web
- Meça a duração/tamanho real com
ffprobe; não confunda a duração desejada com a duração produzida. - Extraia alguns quadros e examine (
ffmpeg -ss 1 -i in.mp4 -frames:v 1 f1.jpg): a área de texto está vazia? Há texto/logotipo indesejado? A paleta está adequada? - Cópia de entrega: MP4 silencioso, compactado para web (H.264,
-an -crf 26 -preset slow -movflags +faststart), WebM se necessário; pôster como o quadro de início da reprodução (se o primeiro quadro começar escuro, pegue alguns quadros depois); vídeo hero para ~10 seg deve ter ≤2 MB. - Loop: se o início e o fim não se assemelham, apenas adicionar
loopnão é perfeito; faça um crossfade curto ou um loop de avanço/recuo (ping-pong:[0]reversecomconcat) ou informe o usuário sobre isso. - Faixa preta embutida: algumas produções têm bordas pretas. Meça com
ffmpeg -i in.mp4 -vf cropdetect=24:2:0 -f null -e limpe comcrop=…,scale=1280:720. - Vídeo para ser enrolado com rolagem requer quadros-chave frequentes, senão trava ao retroceder:
-c:v libx264 -crf 26 -g 6 -keyint_min 6 -sc_threshold 0 -an -movflags +faststart. Uma cena de 5 seg em 720p com essa configuração fica em cerca de 0,5–1,2 MB. - Se o ffmpeg não estiver disponível, sugira ao usuário o comando de instalação (Windows:
winget install Gyan.FFmpeg, macOS:brew install ffmpeg).
4. Integre ao site
- Textos, botões e interação permanecem na camada web; o quadro do vídeo deixa espaço para eles. Considere o quadro móvel separadamente (
object-position, se necessário, vídeo 9:16 separado). <video autoplay muted loop playsinline preload="metadata" poster="..." width height>. Em caso de erro de mídia, o pôster deve permanecer visível. Pré-carregue o pôster hero com<link rel="preload" as="image" fetchpriority="high">; o hero geralmente é o maior elemento da página (LCP).- Para qualquer vídeo em reprodução automática com mais de 5 segundos ou em loop, coloque um botão de pausar/reproduzir visível para todos e acessível por teclado (WCAG 2.2.2); isso não é apenas para usuários com redução de movimento.
- Interrompa quando estiver fora da tela e em aba oculta (IntersectionObserver +
visibilitychange). - Se
prefers-reduced-motionestiver ativo, mostre o pôster estático e ofereça um controle visível "Ativar movimento"; esse controle deve gerenciar tanto o vídeo quanto as animações CSS. - Não coloque o vídeo em uma moldura de player visível; posicione-o na superfície com máscara, corte e harmonia de cores. Movimentos CSS/SVG de suporte devem servir ao propósito.
- Orçamento de movimento: que haja um único momento de foco na página; apenas um vídeo toca por vez, não há animação de entrada ou parallax adicional na seção do vídeo. Se o usuário escolheu vários locais de vídeo, eles devem ser visíveis sequencialmente, não simultaneamente.
- Se houver vários vídeos: apenas o vídeo da seção visível deve tocar por vez; os outros não devem ser carregados com
preload="none", e carregados quando se tornarem visíveis. Os vídeos de transição de seção podem ser vinculados à rolagem (reproduzir uma vez quando visível ou vincularcurrentTimeà porcentagem de rolagem); se for pesado no celular, reduza para pôster + transição CSS curta. Os loops de cartão devem ser pequenos e em 360p, tocando apenas quando visíveis. - Configuração do filme de rolagem: dentro de
<section class="film">, uma cena composition: sticky; top: 0; height: 100svh; margin-bottom: -100svh(todos os vídeos empilhados, apenas o ativo visível) e, em seguida, uma seção de ~150–160vh de altura para cada cena. Dê ao filmeoverflow: clip; caso contrário, a margem negativa fará com que a cena permaneça sobre a próxima seção após o término do filme. Calcule qual seção está no centro da tela durante a rolagem e o progresso dentro da seção, façavideo.currentTime = progresso × duração; não executeplay()nos vídeos. Faça a atualização comrequestAnimationFramee, como ele para em segundo plano, adicione um breve backupsetTimeout. Com movimento desativado (prefers-reduced-motionou botão), as cenas devem permanecer estáticas no primeiro quadro/pôster, mas a mudança de seção ainda deve funcionar. Os textos não são incorporados ao vídeo; o texto de cada seção fica na camada web como um título fixo + uma frase, apenas o canto onde o texto está é escurecido. - Entrega padrão: site estático sem dependências (index.html + css + js + media). Se o usuário informou um framework ou destino de publicação, use-o.
5. Verificação final
- Legibilidade do texto, enquadramento, transbordamento e carregamento de mídia nas larguras desktop e móvel.
- Verifique se o vídeo realmente está sendo reproduzido (
currentTimeestá avançando?); captura de tela não é prova de reprodução. - Teste o caminho de redução de movimento e o controle "Ativar movimento".
- Para o usuário: caminho/link do site, créditos usados, arquivos de vídeo e limitações conhecidas (ex.: composição de loop). Não substitua o sucesso técnico pela aprovação estética; pergunte o que ele não gostou.
Limitações
- flow-video automatiza a interface do Flow no perfil do navegador do usuário; se a interface do Google mudar, a ferramenta pode apresentar erro. Nesse caso, relate o erro claramente.
- O Google do usuário
…
[truncado para tradução]