Fazendo um vídeo sobre um jogo
É assim que fazemos vídeos sobre jogos para a Playgama. O vídeo se parece com o jogo, não com a Playgama: suas cores, fontes, painéis e som. A Playgama adiciona seu logotipo (uma animação de 3 segundos no início e um pequeno bug no canto) e o link. O resto do trabalho está em três lugares: a história é verdadeira e específica, o gameplay é filmado de forma limpa, e o primeiro segundo conquista o próximo.
Os arquivos incluídos:
| Arquivo | O que é |
|---|---|
assets/playgama-ai-logo.svg, .png | O logotipo oficial da Playgama AI (591×133): uma pílula roxa com a marca Playgama, e uma caixa cinza colada a ela com "AI" recortado. O PNG é 4x, transparente |
assets/template/ | Um vídeo HyperFrames inicial, 1920x1080: a animação, três espaços para gameplay, um título, um card final, faixas de música e voz. Um bloco de tema no topo contém a aparência do jogo |
assets/sting-preview.mp4 | A animação de introdução como deve ficar, entregando a um placeholder onde o vídeo do jogo começa |
assets/sting.html | A animação de introdução sozinha, em CSS puro (7 KB, sem bibliotecas): coloque em qualquer página ou ferramenta de vídeo |
assets/playgama-ai-sting.html | A mesma animação como uma página de revisão com controles de reprodução, velocidade e scrub, e a linha do tempo e cores explicadas. Abra em um navegador e arraste uma captura de tela do jogo para ver o logotipo sobre o jogo, ou entregue a um designer |
scripts/film.mjs, scripts/vclock.js | Filme qualquer jogo web quadro a quadro em um MP4 suave em qualquer tamanho |
scripts/doctor.mjs, scripts/new-video.mjs | Verifique a máquina e diga o que instalar; crie a pasta do vídeo (template, gsap, puppeteer) |
scripts/palette.mjs | As cores que um jogo usa, amostradas de suas capturas de tela, para quando seu código não tem tema |
scripts/voice.mjs | A narração: obtém de ElevenLabs, OpenAI, Gemini ou Cartesia (ou uma voz de rascunho gratuita), uma página para escolhê-las de ouvido, e a faixa de voz com a música abaixada sob ela |
references/story-and-script.md | Formatos, folhas de batida com exemplos de linhas reais, regras para material na tela |
references/game-look.md | Como capturar a aparência do jogo: onde encontrar, cores, tipografia, painéis, movimento, som, o tema do template |
references/filming.md | Como filmar takes: preparação, configuração e scripts por quadro, escolha de momentos, o primeiro quadro |
references/voice-and-music.md | Narração (texto para fala ou sua própria), pronúncia de "Playgama", verificação de takes, níveis de música |
references/edit-and-render.md | Montagem no HyperFrames: o template, cards, cortes verticais, verificações, renderização, revisão |
O que você precisa
Funciona da mesma forma no macOS, Linux e Windows.
node scripts/doctor.mjsverifica a máquina e diz o que instalar.node scripts/new-video.mjs <pasta>cria a pasta do vídeo: o template,gsap.min.jse puppeteer para filmar. Execute todos os comandos posteriores a partir dessa pasta.
- Para filmar: Node 22+ (HyperFrames precisa), ffmpeg e ffprobe no PATH, e puppeteer.
film.mjsencontra-o na pasta de onde é executado ou ao lado do script. O jogo deve ser executado a partir de uma URL: um servidor de desenvolvimento, ou um servidor estático sobre o build. - Para montar e renderizar: HyperFrames (
npx [email protected]; sua primeira execução baixa cerca de 370 MB de pacotes e um navegador headless). - Para a voz, se não for a sua: uma chave para ElevenLabs, ou para outro serviço com o qual
scripts/voice.mjsfuncione, definida uma vez (references/voice-and-music.md), e Whisper ou outro speech-to-text para verificar os takes. - Para música: uma faixa instrumental que você tem permissão para usar.
O fluxo de trabalho
Trabalhe nesta ordem. Cada etapa alimenta a próxima, e os dois pontos de aprovação economizam horas.
- Combine sobre o vídeo. Defina o formato, duração e objetivo antes de qualquer outra coisa (tabela abaixo). Pergunte para que é o vídeo: jogadores, uma página de loja, outros desenvolvedores, ou o desafio ou catálogo da Playgama.
- Colete a história verdadeira. Reúna os prompts reais, timestamps, commits, bugs, números e capturas de tela
(
references/story-and-script.md). Se o jogo foi construído com um agente de IA, seu histórico de chat é a fonte mais rica: leia-o e anote horários e citações exatas. - Capture a aparência do jogo (
references/game-look.md): suas cores, fontes, painéis, logotipo, música e sons de UI, a partir de seus próprios arquivos primeiro. Escreva-os no bloco de tema do template. - Escreva o roteiro e pare para aprovação. Escreva as falas da narração e o que está na tela, uma linha cada. O desenvolvedor aprova o texto e a aparência antes de qualquer voz ser criada: reformular uma voz gravada significa gravá-la novamente.
- Filme o gameplay e tire as capturas de tela com
scripts/film.mjsno tamanho de entrega (veja "Imagens do jogo" abaixo ereferences/filming.md). Planeje um take por batida do roteiro, alguns segundos cada, encenado com os próprios controles do jogo ou hooks de depuração. - Crie os stills com a aparência do jogo. Use código real com números de linha reais, o prompt real e os passos do agente, páginas web e as capas.
- Grave a voz e escolha a música (
references/voice-and-music.md,scripts/voice.mjs). Um humano ouve os takes de voz, porque a conversão de texto para fala falha de maneiras que nenhuma transcrição capta. - Monte e renderize com o template (
references/edit-and-render.md). Execute as verificações, renderize, extraia um quadro a cada poucos segundos e olhe para cada um antes de considerar pronto. - Empacote: uma miniatura (1280x720, o melhor quadro do jogo, no máximo 4 palavras enormes em sua própria fonte), um título e uma descrição com o link do jogo.
Escolha o formato primeiro
| Vídeo | Forma | Duração | Abre com |
|---|---|---|---|
| Short / Reels / TikTok | 9:16, 1080x1920 | 15–35 s | gameplay no primeiro quadro; o logotipo apenas como um pequeno bug no canto |
| Trailer / promo | 16:9, 1920x1080 | 30–90 s | a animação (3 s), depois o melhor gameplay |
| História "Como eu fiz" | 16:9 | 3–6 min | gameplay com a linha de gancho, depois a animação ou um título |
| Tutorial ("publique com Playgama MCP") | 16:9 | 1–3 min por parte | a animação, depois o resultado primeiro e os passos depois |
Um Short é decidido em seu primeiro segundo, quando o espectador fica ou desliza para longe. Shorts que abrem com gameplay em tela cheia que se lê rapidamente retêm muito mais espectadores do que aqueles que abrem com algo para ler (um longo card de comentário, menus de jogo, uma caixa de chat). Portanto, um Short nunca abre com a animação ou com texto.
A aparência do jogo
O vídeo se parece com o jogo: qualquer um que já jogou deve reconhecê-lo em qualquer quadro. Capture a aparência do jogo em si,
não da Playgama (references/game-look.md):
- Cores de sua UI e código: um fundo, um painel, texto, um botão e um destaque. Quando o código não tem tema,
amostre seus menus e HUD com
scripts/palette.mjs. - Tipografia: toda fonte combina com o jogo, incluindo a fonte do código.
- Títulos vão em sua fonte de título ou logotipo, rótulos e prompts em sua fonte de UI ou texto.
- Código e chamadas de ferramentas vão em uma monoespaçada no espírito do jogo: uma pixel para pixel art, uma de máquina de escrever para um jogo sombrio ou retrô.
- A DM Mono do template apenas mantém seus lugares.
- Painéis e botões: cards com a forma de seus painéis, o botão do card final como seu botão principal, seus próprios ícones e logotipo.
- Movimento e som: mova-se como sua UI se move (elástico, calmo ou em passos de pixel). Use sua própria música e sons de UI primeiro.
- Cards sobre imagens, não slides pretos. Coloque um prompt ou um passo sobre um quadro escurecido do jogo, e um título baixo sobre o gameplay com a parte inferior escurecida na cor de fundo do jogo. Prefira imagens reais lado a lado a cards apenas com nomes neles.
As cores, fontes e forma do painel vão em um bloco de tema no topo do estilo do template.
Imagens do jogo
O kit não vem com nenhuma filmagem de jogo. Cada imagem do jogo é filmada a partir do próprio jogo do desenvolvedor, por você, com
scripts/film.mjs (references/filming.md). Isso cobre o vídeo, a miniatura, o quadro atrás de um card e as páginas
de revisão.
- Clipes: um take por batida, por exemplo
node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6. - Capturas de tela: o mesmo comando com
--still <segundos>escreve um PNG daquele momento. Tire uma sempre que um passo precisar de uma imagem do jogo:- seus menus e HUD, para ler sua aparência (
scripts/palette.mjs); - o quadro atrás de um card de prompt ou um título;
- a miniatura e o card final;
- a animação sobre o jogo, para verificar se o bug do canto não sobrepõe o HUD. Arraste a captura de tela em
assets/playgama-ai-sting.html, ou coloque o primeiro clipe no template e executenpx [email protected] snapshot . --at 3.5 --describe false.
- seus menus e HUD, para ler sua aparência (
- Cortes verticais são filmados em 1080x1920, com a câmera do jogo reenquadrada para isso.
- Se o jogo não puder ser executado aqui (um build nativo, uma tela de login, um jogo online), peça ao desenvolvedor gravações de tela e capturas de tela no tamanho de entrega, sem cursor ou notificações na tela. Nunca preencha uma lacuna com imagens de outro jogo, uma página de loja ou exemplos deste kit.
O que a Playgama adiciona
Seu logotipo e o link, nada mais. O roxo e a placa escura da Playgama pertencem ao logotipo e à animação, não ao vídeo.
- O logotipo é
assets/playgama-ai-logo.svg, o arquivo oficial: uma pílula roxa#9747ffcom a marca branca, e uma caixa cinza#d2d2d2com "AI" recortado.- Use-o como está: não recolorir, esticar, adicionar efeitos, alterar seus espaços ou redesenhá-lo.
- O "AI" é um buraco, então mostra o que está atrás do logotipo.
- Dê a ele espaço livre de pelo menos metade da altura da pílula.
- Como um bug de canto, tem cerca de 200 px de largura em um quadro de 1920. Se o HUD do próprio jogo estiver nesse canto, mova o bug
para outro canto em vez de cobrir o HUD (
references/edit-and-render.md).
- O link para a Playgama vai para a própria página do jogo lá: no card final e na descrição.
A animação de introdução
Identidade da Playgama, como o logotipo de uma editora antes de um trailer: cerca de 3 segundos, pré-pronto em
assets/template/index.html. Mantém suas próprias cores e timing em cada vídeo; tudo depois disso é do jogo.
assets/sting-preview.mp4 mostra a transição para um placeholder. Para vê-la sobre o jogo do desenvolvedor, tire uma captura de tela
ou um clipe do jogo (veja "Imagens do jogo").
- Construção: sobre ônix com um brilho roxo suave, a pílula roxa cresce a partir de seu centro (0,05 s, ao longo de 0,55 s). A marca branca "playgama" aparece da esquerda para a direita (0,42 s). A caixa cinza surge rente à pílula (0,92 s), e "A" e "I" são recortados dela (1,12 s, 1,27 s). Uma faixa de luz cruza a pílula (1,55 s).
- Transição: todo o logotipo voa para o canto superior direito em 19% do tamanho, a 39 px do topo e da direita de um quadro 1920×1080 (2,75 s, ao longo de 0,62 s). Permanece lá como o bug enquanto o gameplay aparece por baixo (3,0 s).
- As partes são desenhadas a partir das formas do próprio arquivo oficial com 240 px de altura, para que a animação termine exatamente no logotipo.
- Alteração: mantenha seu timing. Para colocar uma abertura fria primeiro (uma história), inicie a animação mais tarde: defina
Sno template (references/edit-and-render.md). Para um corte 9:16, descarte a construção e inicie o bug no canto desde o primeiro quadro.
Regras que vieram de erros
- Apenas material real na tela.
- Mostre prompts reais, números reais, timestamps reais e código real.
- Se um número tiver que ser ilustrativo, diga na tela ("DADOS DE EXEMPLO") durante todo o tempo em que aparecer.
- Nunca invente uma citação, um comentário, uma contagem de jogadores ou uma avaliação. Espectadores que verificam um número inventado param de confiar no resto.
- Prompts na tela são as palavras do desenvolvedor.
- Traduza-os para o idioma do vídeo, mas não os reformule.
- Corte um longo com "[...]" em vez de parafraseá-lo.
- Passos do agente são as chamadas de ferramentas reais em sua ordem real, por exemplo
create_application→start_archive_upload→get_archive_status(APROVADO) →publish_sandbox(um link público).
- Apenas sua própria arte. Não mostre personagens, logotipo ou arte de outro jogo, mesmo que seu jogo seja "como" ele: nomeie o gênero em vez disso ("um jogo de terror de fuga"), não outro jogo.
- Playgama é dito "play-GAH-ma". Vozes em inglês dizem "play-GAY-ma" a menos que você as oriente
(
references/voice-and-music.md). - Verifique cada take de voz em relação ao seu texto (uma transcrição), e peça a uma pessoa para ouvir. A conversão de texto para fala já repetiu uma frase, adicionou uma que ninguém escreveu, leu suas próprias instruções em voz alta e engoliu uma última sílaba, cada uma em um take que soava bem por si só.
- O primeiro quadro do gameplay é lido em menos de um segundo, não um menu ou tela de carregamento.
- Um Short abre com ele. Um trailer ou uma história chega a ele logo após a animação ou a abertura fria.
- Filme o melhor momento, não o início de uma fase.
- Texto nos primeiros dois segundos do gameplay: no máximo quatro palavras enormes.
- A filmagem permanece na máquina. O
snapshotdo HyperFrames envia quadros para o Gemini para uma descrição sempre que uma chave Gemini ou Google está definida, e ele lê um.envna pasta do vídeo. Passe--describe falsepara cadasnapshot, e mantenha as chaves de voz no arquivo de chave compartilhado devoice.mjs, não na pasta do vídeo.
Quando terminar
O desenvolvedor recebe:
- o MP4 mestre, e uma prévia menor se for grande;
- a miniatura;
- um arquivo de texto com o título, a descrição (o link do jogo, capítulos para vídeos longos, #playgama) e um comentário para fixar.
Diga a eles onde cada arquivo está e o que ainda é decisão deles: horário de postagem, um take de voz que eles ainda não ouviram, e qualquer coisa que você não pôde verificar.