Vídeo de lançamento para Android
Um método e um kit de ferramentas para criar o vídeo promocional da Google Play (16:9), o corte vertical para redes sociais (9:16), cada um com e sem narração, e as imagens da loja, a partir do aplicativo real rodando em um emulador. O padrão é um filme de agência finalizado, não uma gravação de tela.
Esta skill adapta product-launch-motion (de AbubakrChan, MIT) para Android. Essa skill é um
requisito e não está incluída: instale-a de https://github.com/AbubakrChan/product-launch-motion
(testada no commit edbfb105) e leia, antes de escrever qualquer código de filme:
SKILL.mdreferences/technique.mdreferences/prompts.mdlegacy/references/03-word-locked-sync.mdlegacy/references/07-sound-and-master.md
O que muda para o Android: indicadores de toque no lugar do cursor, captura real em 60 fps em vez de movimento reconstruído, superfícies opacas para tudo que é levantado da tela, música verificada quanto a artefatos de chop vocal, narração verificada por reconhecimento de fala e as regras da Play Store.
As ferramentas estão em tools/ (índice em references/tools.md). Detalhes longos estão em references/;
este arquivo é o método e as regras.
1. Entregas
| Peça | Especificação |
|---|---|
| Vídeo para Play / YouTube | 1920x1080, 60 fps, H.264, AAC 48 kHz, -14 LUFS integrados, pico verdadeiro <= -1 dBTP |
| Vídeo vertical para redes sociais | 1080x1920, mesmas especificações, composto independentemente (nunca um corte do 16:9) |
| Cada um com e sem narração | Quatro mestres. O corte narrado é feito separadamente e nunca substitui o corte apenas com música |
| Capturas de tela da Play | Até 8, 1080x1920, PNG 24 bits sem alfa (ou JPEG) |
| Graphic feature | 1024x500 sem alfa; mantenha o centro (aproximadamente x 362 a 662) livre: a Play coloca o botão de reprodução ali |
| Imagens para redes sociais | 1080x1920 |
| Pré-visualizações | 14 MB no máximo cada, para exibi-las em um Artifact |
Duração: cerca de 40 s, nunca mais de 50 s.
No formato 9:16, nada importante (texto, logotipo, botão) nas faixas que Reels, Shorts e TikTok cobrem com sua interface: os 14 % superiores, os 20 % inferiores e cerca de 120 px da borda direita.
2. Regras de produção (aprove-as, depois cumpra-as)
- Produto finalizado. Julgue cada quadro como um filme de agência pago.
- Movimento real. Tudo que se move dentro do telefone é o aplicativo gravado a 60 fps. Nenhum movimento é reconstruído a partir de capturas de tela animadas. Um clipe que gagueja é gravado novamente.
- Sem cursor. O Android não tem mouse. Cada toque é marcado com um disco suave e a ondulação do Material, no local e no momento do toque real (a partir do registro de toques da captura).
- Nenhum outro aplicativo na tela (aplicativos de mensagens, mapas, navegador, seletor de conta). Se o aplicativo nomeia outro aplicativo em um botão, a palavra pode ser lida; o outro aplicativo nunca aparece.
- Nada flutua sem uma superfície. Qualquer coisa levantada da tela do telefone fica em sua própria superfície opaca: o próprio cartão ou o contêiner do aplicativo para aquela seção, com seu raio, cor e uma sombra suave. Nenhum texto repousa sobre o telefone, e nenhum texto se sobrepõe a outro.
- Idêntico ao aplicativo. Um elemento levantado começa como um recorte exato do quadro visível e, no ar, cruza com um pequeno desfoque para uma réplica vetorial calibrada em relação a esse recorte. Nenhum emblema, ícone, botão ou dado inventado.
- Nada que não esteja na marca ou no aplicativo. Nenhum glifo de reprodução no botão final, nenhum wipe de tela cheia, nenhuma caixa atrás de um texto para torná-lo legível: ajuste os tamanhos.
- A marca abre e fecha, centralizada em seu eixo em ambos os formatos.
- Movimento vivo. Traços longos que esticam, afinam e cruzam no ritmo são melhores do que blocos rígidos.
- Dados verossímeis: valores de mercado reais para o domínio do aplicativo, nunca dados pessoais reais.
- Cópia no idioma da listagem com diacríticos corretos, sem travessões.
- O revisor aprova o roteiro, a música, a voz e a pronúncia da marca antes da produção, e não vê nada que não tenha sido verificado primeiro (seção 11).
3. Funções e aprovações
- Diretor (a sessão principal): conversa com o revisor, lança subagentes, revisa e publica. Perguntas ao revisor passam por AskUserQuestion.
- Subagente de análise: produto, marca, fluxos, ambiente local, dados de amostra, plano de gravação e roteiro. Ele não compila o aplicativo nem inicia o emulador.
- Aprovações: storyboard em um Artifact (quadros-chave desenhados com Playwright e visualizados antes de mostrá-los), roteiro por compassos, música, escolha de voz, pronúncia da marca e permissão para girar o monitor durante a gravação.
- Subagente de produção: compilação, emuladores, captura, filme, áudio, narração, renderização, imagens,
verificações e entregas. Ele registra o progresso em
PROGRESS.mdno diretório de trabalho. - Fechamento: o diretor revisa e publica; as anotações do revisor voltam para a produção (SendMessage) até serem aprovadas.
4. Ambiente local e dados
- Apenas emuladores locais. Antes de semear, verifique se todas as variáveis de host do emulador estão definidas: semear por meio de um SDK de administrador com uma variável ausente escreve na produção.
- Dados verossímeis para o mercado-alvo: nomes, lugares, preços e fotos. Fotos com licença que permita uso comercial, fonte anotada, sem marcas de terceiros.
- Localização:
adb -s <serial> emu geo fix <longitude> <latitude>. - Compilação de release ou profile, sem sobreposições de depuração e apontada para os emuladores. Um patch que existe apenas para gravação (ocultar um banner de ambiente, pular uma espera) permanece não commitado e é revertido no final.
- Telemetria (relatórios de falha, análise) desligada nessa compilação, ou comprovado que não atinge a produção.
- Barra de status limpa com o modo de demonstração do SystemUI (
tools/capture/demo.sh): 9:41, bateria cheia e wifi, sem notificações. - Escalas de animação do sistema em 1 durante a gravação; em 0, o aplicativo não se move como um telefone.
- Backends compartilhados: se algo compartilhado (um banco de dados de staging) receber gravações, conte as linhas antes e depois. Uma API local com provedores simulados pode deixar dados inventados em um banco de dados compartilhado.
5. Captura real em 60 fps
screenrecord dentro do emulador não é suficiente: cerca de 41 fps em 1080x2400 (53 em 720x1600), e
rolagens parecem entrecortadas. Use-o apenas para testes (tools/capture/clip.py). Opções:
- Host Windows + GPU (testado). Emulador no Windows com
-gpu host, o monitor girado para retrato para que o telefone caiba em 1:1,ddagrabdo ffmpeg (Desktop Duplication) a 60 fps cortado para a tela do telefone e girado, codificado quase sem perdas comhevc_amf(AMD; testado) ouh264_nvenc/hevc_nvenc(NVIDIA; não testado).tools/capture/capture.py(ClipGPU) grava, registra cada toque e deslize com o relógio do emulador e move o clipe para o WSL. - Telefone físico com scrcpy (NÃO TESTADO).
scrcpy --recordna taxa de atualização do telefone; o registro de toques e a sincronização precisariam ser adaptados. - Hosts macOS / Linux: não cobertos.
Em seguida, sync60.py alinha cada toque com a mudança visual que ele causa, measure2.py, stutter.py e
jumps.py medem o resultado (a configuração testada deu 53 a 59 quadros únicos por segundo), e
app_fps.sh informa se o próprio aplicativo renderiza a 60 dentro do emulador. Passo a passo, com as
verificações do Windows (sessão desbloqueada, tempo limite da tela, memória livre): references/capture-60fps.md.
6. O filme
Escreva DIRECTION.md (cores e fontes da marca do tema do aplicativo, logotipo, conceito, roteiro por compassos,
regras), depois PLAN.md, e só então code. Uma página HTML (film/index.html?f=16x9 ou ?f=9x16)
onde tudo é uma função pura de seek(t): molas em forma fechada, sem transições CSS, sem
temporizadores. tools/video/film/core.js é o mecanismo (molas, faixas, dígitos giratórios). Dentro de uma moldura
de telefone vetorial genérica (sem marca do fabricante), apenas a gravação real é reproduzida, quadro a quadro a partir de
seek(t), com os indicadores de toque desenhados a partir do registro de toques.
Renderize com Playwright: 4 subquadros por quadro, com média usando tmix do ffmpeg a 60 fps, em segmentos
paralelos dimensionados para liberar memória. Rascunhos a 30 fps e meia escala. Folhas de contato por compasso e quadros
individuais para revisão. Dígitos giratórios são verificados quadro a quadro: eles nunca devem mostrar lixo entre
eles. Detalhe: references/film.md.
7. Música
- Faixas do Mixkit sob a licença Mixkit (https://mixkit.co/license/); título e autor vão nos
créditos. O diretor escolhe, o revisor ouve antes da edição.
tools/music/tem um catálogo (título, autor, gênero, duração, link) e uma análise de andamento/energia; nenhum áudio está incluído. - Grade de batidas própria (
video/scripts/grid.py): andamento medido e fase da primeira batida. Os cortes caem na batida com crossfades de igual potência de cerca de 14 ms na depressão antes do ataque. - Verificação de chop vocal. Algumas faixas carregam batidas vocais picotadas que soam como palavras (às vezes
rudes) para o ouvido.
fingerprint.pyemusic_check.pycomparam a impressão digital espectral da batida (40 bandas log de 250 Hz a 6 kHz, similaridade de cosseno) com cada batida da edição: nenhuma pode atingir 0,88. Esses compassos são mantidos fora e seus ecos são reduzidos. - Efeitos sonoros sintetizados, afinados na escala da faixa e colocados no pico medido
(
audio.py). - Mixagem ponto de partida: faixa x 0,5 + efeitos x 0,62, -14 LUFS, pico verdadeiro <= -1 dBTP.
Detalhe:
references/audio.md.
8. Narração
- Gemini TTS, modelo
gemini-3.8-flash-tts. A chave vem apenas da variável de ambienteGEMINI_API_KEY: nunca impressa, nunca na linha de comando, nunca em um repositório ou em um chat.tts.pya envia apenas em um cabeçalho e a remove dos erros. - Poucas gerações gratuitas por dia. Cada solicitação é registrada; um 429 é relatado e não repetido. Orce-as: uma pequena linha de teste por voz, depois o roteiro inteiro em uma solicitação por take.
- Escolha: uma voz natural, calorosa, não robótica. Bons candidatos: Sulafat (calorosa), Laomedeia (viva), Leda (jovem).
- Pronúncia da marca: pergunte ao revisor antes de gerar; ela vai nas notas do diretor do
prompt ("pronuncia-se ..., como ..."), nunca na tela. faster-whisper large-v3
(
transcribe.py) verifica com e sem uma dica. O modelo não está incluído: https://huggingface.co/Systran/faster-whisper-large-v3 - Voz primeiro. Cada linha tem sua janela no filme e sua palavra-chave cai na mudança visual
que ela nomeia (
segment.py,place.py,timing_table.py,pace.py). - Mixagem narrada (
narrated_mix.py): a música diminui sob cada linha para 9 a 12 dB abaixo da voz, com rampas.check_margin.pyencontra onde a voz perde,audio_artifacts.pyencontra cliques e cortes. Detalhe:references/narration.md.
9. Imagens da loja e metadados da Play
- Capturas de tela: quadros limpos do filme 9:16 (
store_shots.mjs, um únicoseek(t)por quadro, sem desfoque de movimento) ou telas reais com um título. 1080x1920, PNG de 24 bits sem alfa (png_srgb.py). A primeira declara a proposta de valor. - Graphic feature 1024x500: marca, uma linha e o telefone, centro mantido livre.
- Imagens para redes sociais 1080x1920, respeitando as faixas seguras da seção 1.
- Regras de metadados da Play, que também se aplicam ao vídeo: sem "#1", "melhor", prêmios, depoimentos,
chamadas para baixar, ofertas datadas ou palavras-chave repetidas, e nada que o aplicativo não faça.
Detalhe:
references/store-assets.md.
10. Entrega
- Artifact principal: as quatro pré-visualizações, as imagens, os textos da listagem e os créditos musicais.
- Uma página de download por formato (capacidade
downloadsdo Artifact). Os mestres são divididos em partes de 14 MB (tools/delivery/split.sh), remontados no navegador e verificados com SHA-256 antes de oferecer para salvá-los (tools/delivery/downloads/index.html, testado comtools/editor/test-downloads.mjs). Uma publicação envia até 64 MB: carregue as partes em vários lotes para a mesma URL. - Opcionalmente, copie os mestres para uma pasta do Windows (
masters_dir_wslna configuração). - Faça upload para a Play ou redes sociais apenas quando o revisor solicitar.
11. Antes de mostrar qualquer coisa
Observe você mesmo cada folha de contato, no tamanho real e no contexto, e execute as verificações de
references/checks.md: filme (overlaps.mjs, purity.mjs, errors.mjs), renderização (jumps.py,
stutter.py), áudio (-14 LUFS, pico verdadeiro, sem batida com formato vocal, voz completa de acordo com o Whisper) e a lista
visual (sem cursor, sem outro aplicativo, sem banners de depuração, barra de status limpa, sem dados pessoais, sem
texto cortado, sem erros ortográficos).
12. Cuidado com a máquina
Antes de cada lote pesado, verifique uptime, free -g e a memória livre do Windows. As renderizações são executadas dentro de um
escopo com limite de memória, uma compilação Gradle por vez, temperaturas monitoradas em lotes longos (pausa
acima de 85 C na CPU ou 80 C na GPU), Windows nunca abaixo de 2 GB livres. Nunca mate processos ou emuladores de
outras sessões. Detalhe: references/checks.md, seção "Cuidado com a máquina".
13. Limpeza
Desligue o emulador do Android e quaisquer outros emuladores iniciados, restaure o monitor e o tempo limite de tela, reverta patches apenas para gravação e configuração temporária, esvazie a pasta de captura do Windows e diga claramente o que ainda está pendente.
Referências
references/capture-60fps.md: captura no host Windows, passo a passo.references/film.md: contrato da página do filme, mecanismo, renderização, folhas de revisão.references/audio.md: escolha de música, grade de batidas, verificação de chop vocal, efeitos, mixagem.references/narration.md: Gemini TTS, escolha de voz, verificações do Whisper, posicionamento, mixagem narrada.references/store-assets.md: capturas de tela, graphic feature, regras da Play.references/checks.md: lista de verificação pré-revisão e cuidado com a máquina.references/lessons.md: lições aprendidas, como regras.references/tools.md: cada ferramenta, o que faz e como chamá-la.